home *** CD-ROM | disk | FTP | other *** search
/ Internet Publisher's Toolbox 1.0 / Image.iso / toolbox / htasc / htasc.doc < prev    next >
Encoding:
Text File  |  1995-07-05  |  5.0 KB  |  92 lines
  1.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2.                HTASC -- An .HTM to .ASC Document Converter
  3.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  4.  
  5.    HTASC copyright 1995, Charles Dittell and Suncoast Software Systems
  6.                              Version 2.0
  7.  
  8. INTRODUCTION: HTASC converts WorldWideWeb ("HTML") documents (available
  9.  through WWW on the Internet), and converts them to "raw" ASCII files.
  10.  (HTML stands for HyperText Markup Language). A HTML document's extension
  11.  is usually ".htm". The ASCII file will have an ".asc" extension.
  12.  
  13. SHAREWARE/WARRANTY: HTASC is marketed as shareware, which is a commercial
  14.  form of distributing software. You are free to use HTASC for up to four
  15.  weeks. After that, you must either register HTASC or delete it from your
  16.  computer. The shareware concept helps keep prices very low, and supports
  17.  many individual programmers. Registration eliminates the stupid sounds and
  18.  three second delay in HTASC. In addition, registered users can call HTASC
  19.  with no document name, and HTASC will present a list of HTML documents 
  20.  from which you may choose a document to convert. Re warranty, there is
  21.  NO warranty for HTASC, expressed or implied; you use HTASC entirely at
  22.  your own risk (we gotta say that).
  23.  
  24. HARDWARE REQUIREMENTS: A PC, very little memory, very little drive space.
  25.  
  26. INCLUDED FILES:   HTASC.EXE The executable program
  27.                   HTASC.DOC You're reading it
  28.                REGISTER.FRM Registration form: read it, include check, 
  29.                             send it in, earn eternal thanks. NOTE:
  30.                             undergraduate college students may register
  31.                             FOR FREE, but must include their college name
  32.                             and student ID# on the registration form.
  33.                       H.BAT Sample batch file for optional use with HTASC
  34.                 FILE_ID.DIZ Short description of HTASC
  35.  
  36. HOW TO USE IT: Place the file you wish to convert in the same directory as
  37.  HTASC, or put HTASC.EXE into a pathed directory and call HTASC from the
  38.  directory where your .htm files exist). I put HTASC.EXE in my (pathed)
  39.  "utils" directory. Use the following command line convention:
  40.  
  41.                 HTASC filename[.ext]
  42.  
  43.  In other words, type "htasc" and then the filename (with .htm extension
  44.  optional). If the HTML file is called thispage.htm, to convert it to an
  45.  ascii file, type "htasc thispage" (or "htasc thispage.htm").  HTASC will
  46.  read the file, and output "filename.asc" (the file's name plus an ".asc"
  47.  extension"). The output file will have deleted all HTML codes, and, where
  48.  possible, add a <LF><CR> after 80 or less characters on each line.  "<hr>"
  49.  commands ("hard rule") will produce a line emulating a horizontal line,
  50.  e.g., _________________________ .   Some other HTML extrapolations are
  51.  attempted, such as quotes, "ascii underline" (e.g., it's _important_),
  52.  and the reduction of multiple blank lines.
  53.  
  54.  HTASC works fine in a batch file; errors will not "freeze" the HTASC
  55.  program. This last feature should be helpful to BBS SysOps who may want
  56.  to automatically convert HTML documents to ASCII files for viewing on
  57.  their BBSs. Enclosed is a sample batch file which can be used from the
  58.  command line or another batch file. The command structure is simply:
  59.  H filename (or h filename -- caps not necessary); this line can be
  60.  manually typed or inserted in a batch file. If in a batch file, it may
  61.  be necessary to use the "call" command to ensure that control goes back
  62.  to the calling batch file, as: "call h filename".
  63.  
  64. REGISTRATION BENEFITS: The registered version of HTASC enables you to just
  65.  type "HTASC", and a menu of all .htm files in the current directory will
  66.  appear (up to 60); you can type in the .htm number to convert that file.
  67.  
  68. SUPPORT: Call Suncoast City BBS, 813-953-5505, 1200-28,800 baud, for 
  69.  assistance, before and after registration. Leave message to "Sysop".
  70.  
  71. NOTES: 1 - HTASC has been tested on files up to 316K size (excluding
  72.            links) with no problems whatsoever.
  73.        2 - An easy way to "ANSI-colorize" ASCII files is to use ANSIFILE;
  74.            the newest version is always available on Suncoast City BBS.
  75.            ANSIFILE's command syntax is:
  76.  
  77.            ansifile filename [ansifilename] foregroundcolor [backgroundcolor]
  78.  
  79. HISTORY:
  80.  07/05/95 Ver 2.0 Added new conversions, better looking screens; tested up
  81.                   to 316K .htm files with no problem; added some advanced
  82.                   HTML decoding
  83.  07/01/95 Ver 1.7 More minor code tweaking; tested up to 140K files
  84.  06/28/95 Ver 1.6 Better error control, minor code sharpening
  85.  06/15/95 Ver 1.5 Added menu feature to registered version; sharpened screen
  86.  03/19/95 Ver 1.4 Minor upgrade to sharpen code and screens
  87.  02/20/95 Ver 1.3 Worked all day to add some HTML extrapolations;
  88.                   added .htm extension name option
  89.  02/19/95 Ver 1.1 Squashed couple of bugs; changed color scheme
  90.  02/18/95 Version 1.0 HTASC released
  91.  
  92.