home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / htmipf.zip / README.TXT < prev   
Text File  |  1998-05-09  |  3KB  |  73 lines
  1. HTMIPF.
  2.  
  3. HTMIPF is a freeware html to ipf compiler for OS/2.
  4. The program is written by: J. de Keijzer.
  5. For suggestions or questions email: 101322.3665@compuserve.com.
  6.  
  7. The program may be distributed, but only when this readme is included!
  8.  
  9. Command line.
  10.  
  11. htmipf  {<infile> | /MAP:<mapfile> } { /OUT:<outfile> }
  12.  
  13. infile : the file to be compiled.
  14. example:
  15. HTMIPF hello.html. The compiler will parse the hello.htm file and all the files
  16. which are referenced in this file and create hello.ipf.
  17. All GIF,TIF,PCX,Win BMP images are automatically
  18. converted to OS/2 bitmap files and put in the current working directory, with
  19. the same name as the image found in the HTML file. UNI0X1.GIF will be translated
  20. to UNI0X1.BMP. The initial file <infile> gets an ipf panel with the name "doc" all
  21. referenced files get a panel name with the reference name. The compiler can create
  22. named panels, see the /MAP: option. The compiler will not generate an index. The final
  23. ipf file must be compiled with the IPFC compiler to get the final document. The IPF
  24. source can be used for .HLP and .INF files.
  25.  
  26. /MAP:<mapfile>
  27. When this option is used the /OUT:<outfile> becomes mandatory.
  28. This option is used to compile unrelated html file into one ipf file.
  29.  
  30. example of a map file:
  31. #MyPanelName   hello.htm
  32. #ThisPanel     manual.htm
  33.  
  34. The compiler starts with reading the hello.htm and gives it the panel
  35. name "MyPanelName". When the file manual.htm is not already compiled and
  36. thus not referenced in hello.htm, the compiler will compile manual.htm and
  37. give it the panel name "ThisPanel". The panel names can be used in 3GL and
  38. 4GL programs to access the online help.
  39.  
  40. /OUT:<outfile>
  41. With this option the filename of the compiled source can be defined. When
  42. not defined, the compiler will create an IPF file with the same name as
  43. the HTML file. This option is mandatory when the /MAP: option is used.
  44.  
  45.  
  46. Syntax checking:
  47. Most HTML files are not strict. Open tags are sometimes not closed or
  48. implicitly closed with non related tags. The compiler will give a
  49. warning on this and fix it for ipf. Although the compiler can fix a
  50. lot, it is recommended to create strict HTML files to avoid unpredicted
  51. compiler output.
  52.  
  53.  
  54. Some restrictions and limitations:
  55.  
  56. <TABLES> - IPF tables cannot contain images. When the HTML table
  57. contains two columns the compiler transtales the table into a
  58. definition list which is less strict as the IPF table. Hence,
  59. HTML tables with two columns may contain images and other mark up
  60. tags. The maximum column with in the compiled source is 40 characters.
  61.  
  62. <FONT> - Only the courier font can be set. Other fontnames are ignored.
  63.  
  64.  
  65. Known problems:
  66. Compiling large documents can sometime result in duplicate panel id's.
  67. This problem was found when the HTML reference manual was compiled.
  68.  
  69. Jasper de Keijzer.
  70. 101322.3665@compuserve.com.
  71. Also writer of DrawIt for OS/2. (See BMT-MICRO).
  72.  
  73.