home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / fp30b4.zip / readme.1st < prev   
Text File  |  1998-09-29  |  13KB  |  381 lines
  1. DEVELOPER: Payne-Mennie Computing Services
  2.   PROGRAM: FilePage v3 Beta 4.
  3.      DATE: July 16, 1998
  4.  
  5.  
  6.  
  7.  
  8.  
  9. DISCLAIMER:
  10. -----------
  11.  
  12. This release of FilePage v3.0(beta 4) is yet another beta release
  13. of the FilePage software package.
  14.  
  15. This beta "does not" expire, and is being made available to the 
  16. public as FREEWARE.
  17.  
  18. Please note that even though this beta is being made available to
  19. the public, we offer no warranties, expressed or implied, to the
  20. operation of this program. The internal code is such that NO HARM
  21. can be caused to your system, although if you run this software
  22. against your existing web site, please be aware that the default
  23. output filename created/overwritten is INDEX.HTM.  If you wish
  24. to change this, edit the FILEPAGE.CNF and change the output
  25. filename.
  26.  
  27. All attempts have been made to limit the ability of FilePage to
  28. ONLY be able to write/create the requested html output files.
  29.  
  30.  
  31. Please report any bugs to PLANETWIDE@BMTMICRO.COM
  32.  
  33.  
  34.  
  35.  
  36. What is FilePage?:
  37. ------------------
  38.  
  39. FilePage is a standalone program that creates html file-lists. To take this
  40. a bit further than the basic idea; FilePage will index your file distribution
  41. directories on your web server, and created customizable html output for your
  42. web visitors to use as a navigating tool.
  43.  
  44. The HTML output is linked such that your web visitors may traverse your
  45. web directories without using their browsers BACK BUTTON. For a sample
  46. demonstration of the capabilities of FilePage, visit our OS/2 shareware
  47. download site and experience it first hand at:
  48.  
  49.                  http://www.pr.uoguelph.ca/_01_/index.htm
  50.  
  51. FilePage is totally configurable, meaning that you can make alterations to
  52. the foreground and background colours, table cell properties, file exclusions,
  53. even choose your graphical icons, and much much more.
  54.  
  55. Once you have FilePage configured to your liking, let it loose on your file
  56. directories and let it do the hard work of maintaining your web site. What
  57. would take the webmaster several hours is completed in seconds. No kidding!
  58.  
  59. If this sounds interesting to you, read the rest of the documentation to
  60. discover more about one of the best web tools for OS/2.
  61.  
  62.  
  63.  
  64. Best Regards,
  65.  
  66.  
  67. Chris Payne
  68. planetwide@bmtmicro.com
  69. http://www.pr.uoguelph.ca/cpayne/planet.htm
  70. Payne-Mennie Computing Services
  71.  
  72.  
  73.  
  74.  
  75. CONTACT US:
  76. -----------
  77.  
  78. We encourage feedback from the public. Please email us if you
  79. find any problems with the software running on your hardware,
  80. or if you just wish to say "Hello".
  81.  
  82.  
  83.  
  84. Watch our web site for periodic updates.
  85.  
  86.   URL:  http://www.pr.uoguelph.ca/cpayne/planet.htm
  87.  
  88.   EMAIL: planetwide@bmtmicro.com
  89.  
  90.  
  91.  
  92. [ What's NEW in Beta-4 ]
  93.  
  94.   - Cleaned up some code to speed up sub-directory indexing.
  95.  
  96.   - Removed expirey code.
  97.  
  98.   - Released the software as FREEWARE.
  99.  
  100.  
  101.  
  102. [ What's NEW in Beta-3e ]
  103.  
  104.  
  105.   - Descriptions file entry length limit extended to 1,256 characters.
  106.     255(long filename)+1000(description)
  107.  
  108.  
  109.   - All byte values written to the html output are now comma delimited for
  110.     easy reading.
  111.  
  112.     (eg:        1000 bytes  ==        1,000 bytes
  113.               123456 bytes  ==      123,456 bytes
  114.              1234567 bytes  ==    1,234,567 bytes
  115.            123456789 bytes  ==  123,456,789 bytes, etc...)
  116.  
  117.  
  118.   - Updated routines to allow for deep subdirectory indexing.
  119.  
  120.  
  121.   - Updated the html output routines to support (3)three levels of html
  122.     formatting detail; configured in the filepage.cnf file:
  123.  
  124.     (eg:  FORMAT FULL  = full formatting
  125.           FORMAT BASIC = 1/2 detail of FULL
  126.           FORMAT PRE   = 1/8th detail of FULL(utilizes html <PRE> tags)
  127.  
  128.  
  129.   - Beta release expiration is extended to APRIL 30, 1998.
  130.  
  131.  
  132.  
  133.  
  134. [ What's in Beta-3d ]
  135.  
  136.   - New KEYWORD in FilePage.cnf:
  137.  
  138.  
  139.     FORMAT  full  - instructs filepage to use full formatted table
  140.                     information in the html output file. Could get
  141.                     very large if hundreds of files are processed
  142.                     in the directory.
  143.  
  144.     FORMAT  bare  - instructs filepage to use basic formatting
  145.                     table information in the html output file. Icons
  146.                     and descriptions are excluded from the output.
  147.                     Table size is 1/2 the size of full formatted
  148.                     output when all features are counted.
  149.  
  150.  
  151.  
  152.   - New connamd line parameters added:
  153.  
  154.  
  155.  
  156.         FILE:filename.ext - supply a new output htm/html filename on the fly.
  157.                             The specified filename will be created throughout
  158.                             the entire directory tree if the SUB option is
  159.                             enabled.
  160.  
  161.                             Filename must be at least (1)one character in
  162.                             length, AND it MUST have the file extension, .HTM,
  163.                             or .HTML.  If the filename is invalid, the setting
  164.                             associated with FILENAME in the FILEPAGE.CNF will
  165.                             become the default output filename.
  166.  
  167.                             Failing this, INDEX.HTM becomes the output default.
  168.  
  169.  
  170.         SCHEME:filename.scm - supply a (.scm)SCHEME filename, and each of the
  171.                             attributes stored within the (.scm)SCHEME file will
  172.                             be used to configure the html output.
  173.  
  174.                             All (.scm)SCHEME files must reside in the directory
  175.                             specified by the  SET FILEPAGE=  environment
  176.                             variable.
  177.  
  178.                             A (.scm)SCHEME filename must be at least (1)one
  179.                             character in length, AND it MUST have the .SCM
  180.                             file extension.
  181.  
  182.                             If the SCHEME file does not meet this criteria,
  183.                             settings are read from the FILEPAG.CNF file.
  184.  
  185.                             Failing this, internal defaults are used.
  186.  
  187.  
  188.                             Note: Keywords and option settings are NOT case-
  189.                                   sensitive.
  190.  
  191.                                   Any attributes missing in the .scm file will
  192.                                   be set to default internally by FilePage
  193.                                   during initialization.
  194.  
  195.  
  196.  
  197.         DIR       - instructs FilePage to place the full output path above the
  198.                     description header cell field.
  199.  
  200.  
  201.         NODIR     - instructs FilePage not to place the full output path above
  202.                     the description header cell field.
  203.  
  204.  
  205.         BANNER    - specifying this command line option will force FilePage
  206.                     to search the current working directory for a file with
  207.                     the name BANNER and place its contents at the top of the
  208.                     html output during processing.
  209.  
  210.                     This is just a simple way to have special notes from the
  211.                     webmaster, or advertisement banners published at the top
  212.                     of the file download page.
  213.  
  214.                     The user creates a file using plain text, or html tags
  215.                     to format the information as required.
  216.  
  217.  
  218.                     Simply place the banner file in each sub-directory which
  219.                     you want to have the banner appear in the html output, and
  220.                     it will be used during processing.
  221.  
  222.  
  223.                     Note: DO NOT use the <HTML>, <BODY>, <HEAD>, or <TITLE>
  224.                           tags.  If you do include these tags in your banner
  225.                           file, the html output created by filepage is not
  226.                           guaranteed.
  227.  
  228.                           Be sure to add  BANNER   to your exclude.cnf if you
  229.                           do wish to prevent banner file from being included as
  230.                           a downloadable file.
  231.  
  232.  
  233.  
  234.         EXCLUDE   - instructs FilePage to use the EXCLUDE.CNF file exclusion
  235.                     file, if one is located in the current working directory.
  236.  
  237.  
  238.         NOEXCLUDE - instruct FilePage not to use the EXCLUDE.CNF file exclusion
  239.                     file; it will not search the current working directory.
  240.  
  241.  
  242.         LINK      - specifying this command parameter will link the new indexes
  243.                     being created to an upper level directory;  a web link
  244.                     of the same name(ie: index.htm ).
  245.  
  246.                     FilePage does not check to see if an upper level link
  247.                     is available, so one must already exist.
  248.  
  249.                     Note: This option is great if you wish to update lower
  250.                           level sub-directories without processing entire
  251.                           directory structures. LINK will attach you page
  252.                           being updated to an page of the same name on the
  253.                           directory-level above the current working directory.
  254.  
  255.  
  256.        NOLINK     - specifying this command parameter will disable the link
  257.                     parameter in the FILEPAGE.CNF file.
  258.  
  259.  
  260.  
  261. [ What's in Beta-2 ]
  262.  
  263.   - Corrected a bug which prevented sub directory links from linking to the
  264.     proper *.HTM or *.HTML when multiple sets of output are created in the
  265.     same directory tree. Fixed!
  266.  
  267.  
  268.   - Some Command Line options have been added which override settings found
  269.     in the FILEPAGE.CNF file. All command line parameters "ARE NOT" case-
  270.     sensitive.
  271.  
  272.  
  273.         MASK    - enable file reference masking using the OnMouseOver= statement.
  274.  
  275.         NOMASK  - disable file reference masking.
  276.  
  277.         SUB     - enable subdirectory indexing.
  278.  
  279.         NOSUB   - disable subdirectory indexing. Quit once current directory
  280.                   is processed.
  281.  
  282.         FILE:filename.ext - supply a new output htm/html filename on the fly.
  283.                             Output filename is created throughout the entire
  284.                             directory tree if the SUB option is enabled.
  285.  
  286.                             Filename must be at least (1)one character in
  287.                             lenght, AND it MUST have the .HTM or .HTML
  288.                             extension otherwise INDEX.HTM becomes the
  289.                             output default.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296. [ What's in Beta-1 ]
  297.  
  298.   - Filepage requires an ENVIRONMENT VARIABLE added to your config.sys to
  299.     help locate its own files.
  300.  
  301.  
  302.  
  303.   - Filepage uses the FILEPAGE.CNF configuration file and command line
  304.     parameters to work better for you.
  305.  
  306.     There should only be (1)one copy of this file, and it should be in
  307.     the directory specified in the SET FILEPAGE=  specified in config.sys.
  308.  
  309.  
  310.  
  311.   - The EXTENSION.CNF file is used to control which ICONs are used with
  312.     each file processed. A new extension file is supplied with beta-1
  313.     which handles most file formats. Add more if you wish...go nuts!
  314.  
  315.     There should only be (1)one copy of this file, and it should be in
  316.     the directory specified in the SET FILEPAGE= specified in config.sys.
  317.  
  318.  
  319.  
  320.   - Filepage handles SUB direcotries.  The enable/disable this feature,
  321.     change the setting in the FILEPAGE.CNF to  yes or no.
  322.  
  323.  
  324.  
  325.   - Filepage uses the EXCLUDE.CNF file to exclude processing of certain
  326.     files you wish to protect.  A separate copy of this file should be
  327.     placed in each SUB directory as required.
  328.  
  329.  
  330.  
  331.   - Filepage uses the DESCRIPTIONS file to obtain file descriptions for
  332.     each file processed.  A separate copy of this file should be
  333.     placed in each SUB directory as required.
  334.  
  335.  
  336.  
  337.   - Filepage gets individual TITLES for each level of web page from
  338.     within the DESCRIPTIONS file.  Simply have the keyword TITLE=
  339.     somewhere in the descriptions file with the DESIRED TITLE text
  340.     beside it(separated by a blank space).
  341.  
  342.  
  343.  
  344.   - Icons included in BETA-1 are duplicates and additions to the original
  345.     set provided with earlier versions of Filepage. Remove/replace
  346.     your original set of icons with the new collection. The new icons are
  347.     GIF89 transparent images which look better on backgrounds tiled with
  348.     images.
  349.  
  350.  
  351.  
  352.   - Background images are now supported by filepage. Supply the relative
  353.     path to your X:\webserv\ directory and the Image filename in the
  354.     FILEPAGE.CNF file beside keyword: WEB_IMAGE.
  355.  
  356.     It will then be included automatically in the html output during
  357.     processing.
  358.  
  359.  
  360.     (eg:  WEB_IMAGE /images/blue.gif )
  361.  
  362.  
  363.  
  364.  
  365.  
  366. [ Installing FilePage v3.0 ]
  367.  
  368.   See FILEPAGE.DOC for complete installation and upgrade information.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375. -- end
  376.  
  377.  
  378.  
  379.  
  380.  
  381.