home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / bbs2html.zip / readme.txt < prev   
Text File  |  1999-04-26  |  3KB  |  80 lines
  1.                                   BBS2HTML
  2.                             index file converter
  3. v1.4.4
  4.  
  5.   First I create it program for internal use and don't make advanced error
  6. check. But many peoples EMail me about using it utility and I fix some
  7. bugs and start to add some features.
  8.  
  9.   Warning!!! After v1.3 BBS2HTML configuring via BBS2HTML.CFG.
  10.  
  11.   It utility convert index files into HTML format. Algotithm of scanning
  12. directories are next:
  13. 1) Searching descriptions, all descripted files adding to index.
  14. 2) If description file contain "*" line - status LISTALL are ON (work
  15.    for all child subdirectories also).
  16. 3) If no descriptions with status MASTER and no LISTALL - scanning all
  17.    subdirectories (step 1). Directories, contains at least one
  18.    descripted object adding to index.
  19. 4) If no objects added to index - index no creating.
  20.  
  21.   Index may contain external links in format:
  22. <link>:[<URL>[:<path>[:[<root_HTML_dir>:[<up_dir_URL>]]]] [<description>]]
  23.  
  24.   When <up_dir_URL> is "!" - no up link generated.
  25.  
  26.   File names, <link> and <URL> may be in double quotes, for example:
  27. "long file name.txt".
  28.  
  29.   Long names supported in source, but if port (compilation) not support
  30. it (now - DOS target) - long names not used (but external links - may be
  31. long).
  32.  
  33.   Command line: BBS2HTML <root_dir> <root_html_dir> [<config_file>].
  34. Default config file is BBS2HTML.CFG.
  35. Example:
  36. BBS2HTML d:\files /
  37.  
  38.   Header & footer taked from 1) converted directory 2) (if none) in
  39. BBS2HTML.EXE start directory.
  40.  
  41.   About other features - look at .CFG
  42.  
  43.   Compiled with: DOS - BP 7.01, OS/2 - VP/2 1.10, Win32 - Delphi 2.01.
  44.  
  45.   History:
  46.  
  47.   v1.1   - bugs fixed,
  48.            added 2HTML.BBS, "*";
  49.   v1.2   - some more bugs fixed,
  50.            names in double quotes,
  51.            external links;
  52.   v1.3   - many features (look at BBS2HTML.CFG);
  53.   v1.4   - descriptions in OS/2 extended attributes,
  54.            ported to Win32 console;
  55.   v1.4.1 - fixed bugs,
  56.            long names for Win95 in DOS target,
  57.            support both names under Win32 and Win95/DOS,
  58.            5D external link format;
  59.   v1.4.2 - writing HTML first into BBS2HTML.$$$ and rename when complete;
  60.            <up_dir_URL> in external link now may be "!" - no "Up" link;
  61.            fixed sources - OBJECTS unit not needed, but it was in UniOBJ.pas;
  62.   v1.4.3 - fixed bug in HTML syntax: <,>,&,",&#<num> must be
  63.            finished by ";". Into default configuration added "+" into
  64.            "Multiline" for FILES.BBS - for ProBoard & PCBoard;
  65.   v1.4.4 - fixed bug with skipping fields ("SkipFields" options);
  66.  
  67.  
  68.   To do:
  69.  
  70.   I planned to make templates for destination index and mutiple destinations.
  71. But it program writing in free time...
  72.  
  73. ----------
  74.     (c) Denis Kaganovich AKA mahatma
  75.         Homepage: http://mahatma.bspu.unibel.by
  76.               or: http://bspu.unibel.by/pages/mahatma
  77.     E-Mail: mahatma_d@usa.net
  78.             AKA mahatma@bspu.unibel.by
  79.             AKA 2:450/144@fidonet
  80.