home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / html_gen.zip / readme.os2 < prev   
Text File  |  1997-12-27  |  2KB  |  56 lines

  1. HTML_GEN v1.0
  2.  
  3. Generates HTML files out of source files and macros
  4.  
  5. This is a little program I programmed to help me in maintaining my web sites. I had a lot of
  6. pages that contained the same or nearly the same code on them and if I had to change one
  7. thing I had to go through nearly all the pages.
  8.  
  9. The trick with this program is that I don't write HTML files directly. The pages contain HTML
  10. code but also MACRO calls. They end in .SOURCE and are read by the program. By that
  11. the source code is scanned for M!A!C!R!O followed by the macro name. Each macro can
  12. take parameters too. They have to be given in brackets after the macro name and must be
  13. seperated by a comma, e.g:
  14.  
  15.     M!A!C!R!Obody(#FFFFFF,#550000,#00FFCC)
  16.  
  17. The program substitutes the macro call with the content of the macro file which should be
  18. named <macro name>.MACRO, e.g:
  19.  
  20.     body.macro
  21.  
  22. The parameters of the macro are filled into the places marked with !A!A!. The rest of the source
  23. and macro file are stored in the resulting HTML file as given in the source.
  24.  
  25. To generate the example file:    html_gen index
  26.  
  27. This will generate the file index.html out of the index.source.
  28.  
  29. Requirements: The executable program requires at least a 386 cpu with OS/2.
  30.  
  31. Files Included
  32.  
  33.     HTML_GEN.C    C source code
  34.     HTML_GEN.EXE    OS/2 executable
  35.     BODY.MACRO    example of a macro
  36.     DOCTYPE.MACRO    another macro example
  37.     INDEX.SOURCE    example source file
  38.     README.OS2    this file
  39.  
  40. Compiling source
  41.  
  42. The source code has been compiled and tested with
  43.  
  44.    Borland C++ v2.1 for OS/2
  45.  
  46. Disclaimer:
  47.  
  48. The author assumes no responsibility for the use of the program, source
  49. code, documentation, sample data, and etc. 
  50.  
  51. Have fun.
  52.  
  53. U. A. Mueller
  54. email: sicota.country@usa.net
  55.  
  56. comments welcome