Short:        V1.1 Create HTML page for archived files +src
Author:       mark@kontumnam.freeserve.co.uk (Mark Weller)
Uploader:     mark kontumnam freeserve co uk (Mark Weller)
Type:         comm/www
Replaces:     comm/www/CarcHTML.lha
Architecture: m68k-amigaos
Url:          www.kontumnam.freeserve.co.uk

CarcHTML
--------
This program searches a given directory containing archived files
 zip,lha,dms and so on .... and produces an HTML page (index.html)
 in the given directory used for downloading.
The HTML page will display a table of all the files and sizes and the
 readme files and if option chosen different colours for each column
 and background colour for the page.
 also if option chosen you can display Short: description (instead of
 myfile.readme) taken from the files readme file.

Changes since ver 1.00:
-----------------------
. now ignores .info files ( I got the Hint ! I spend to much time in the cli.).
. new option to add own Title.

Usage:
------

CarcHTML [-vatb] <dirname> [[pagecol] [clmn1col] [clmn2col] [clmn3col]] [title]

 [-vatb] Options   -
                   v  : Verbose - List files being processed.
                   a  : Aminet  - Use Short: description.
                   t  : Title   - Title of page/top of archive list.
                          Default is Download.
                   b  : use chosen background colours (default is WHITE).
                        [pagecolour]  - html page background colour.
                        [clmn1col]    - filename column colour.
                        [clmn2col]    - filesize column colour.
                        [clmn3col]    - readmefile/Short: column colour.
                        -*-note-*- you must set all colours if this option chosen.

 <directoryname> - directory containing archived files.

 -*-Note-*- colours range from  black     white    [R]ed [G]reen [B]lue
                                000000 -> FFFFFF   00    00      00
  for this version its assumed there is  a readme file for each archive.
        ( CarcHTML.lha  CarcHTML.readme)
        (  myprogs.lha   myprogs.readme)
  also if aminet option chosen - there is a Short: description at top of
   the readme file (like this readme you are reading).

Examples:
---------
  CarcHTML  Work:archive
     This will create HTML page with default colours and no Short: option
      and default title.

           mypics.lha  2.5MB   mypics.readme
          myprogs.lha  686KB   myprogs.readme
         mysounds.lha  1.2MB   mysounds.readme

  CarcHTML -at  Work:archive  "Downloads this site"
     This will create HTML page with default colours and Short: option if
      found and the given title (put " " around title if more than one word).

           mypics.lha  2.5MB   Spice Girls Pictures [Horror]
          myprogs.dms  686KB   myprogs.readme
         mysounds.zip  1.2MB   Selected Loony Tunes [Classical]

  CarcHTML -ab Work:archive  FFFFFF 888888 FFFF00 0000FF
     This will create HTML page with chosen colours and  Short: option.

           mypics.lha  2.5MB   Spice Girls Pictures [Horror]
          myprogs.dms  686KB   myprogs.readme
         mysounds.zip  1.2MB   Selected Loony Tunes [Classical]

  CarcHTML -vab Work:archive  FFFFFF 888888 FFFF00 0000FF
     Same as last example except will list files being processed
      in shell (cli).

  This version is fully working and contains some error checking
   but some not finished yet.
   example: the program will index all files in the directory assuming
            they are all archive files - but will ignore files with
            these extensions .readme .html .htm .shtml .info .
   so a file called myprogs.doc will be classed as a archive - it is
    nearly impossible to check each archive file as there are so many
    different types.

   I have included the source code with this program - I used Dice to
     compile it, but should compile using any compiler.

   If you find this program or source code useful please e-mail me
    if not - sorry for wasting your time!

  Thank you to everyone who have responded and find this program useful.

  keeping the Amiga alive!
    -*- Mark Weller -*-