home *** CD-ROM | disk | FTP | other *** search
/ Internet Publisher's Toolbox 2.0 / Internet Publisher's Toolbox.iso / html / rtf2html / readme < prev    next >
Encoding:
Text File  |  1994-11-10  |  2.7 KB  |  70 lines
  1. To build on a UNIX system:
  2.  
  3.     1)  Edit the makefile to set the location of the binary (BINDIR) and
  4.         required translation files (LIBDIR).
  5.  
  6.     2)  type make install
  7.         On systems where ranlib is not required for building libraries
  8.         you will see an error message like:
  9.         sh: ranlib: not found
  10.         *** Error code 1 (ignored)
  11.  
  12.         This is OK.
  13.  
  14. To run on a UNIX system
  15.  
  16.     1)  set the environment variable RTFLIBDIR to the directory (full path)
  17.         to the directory containing the translation files (html-trans...)
  18.         If you built from source, this is the same value you set LIBDIR to
  19.         in the makefile.
  20.  
  21.     2)  Translate documents
  22.  
  23.         rtftohtml yourfile.rtf
  24.  
  25. To run on a Mac system
  26.  
  27.     1)  Keep all of the files in the same folder.
  28.  
  29.     2)  Double click on rtftohtml - or drag rtf files onto it.
  30.  
  31. The results:
  32.  
  33.         running rtftohtml on yourfile.rtf - will produce
  34.             yourfile.html (the main HTML document)
  35.             and yourfile_ToC.html (a Table of contents document)
  36.             and yourfile_fn.html (For any footnotes)
  37.             and yourfile.err    (With any errors and warnings)
  38.             and yourfile1.pict, or yourfile1.wmf (for graphics files)
  39.                         ^ changes for each graphic file.
  40.  
  41.         You will need to run filters on the graphics files to turn them
  42.         into gif images. The pbmplus package (see archie
  43.         for locations) can convert PICT files that contain a bitmap.
  44.         It cannot cope with PICT files containing lines, arcs etc.
  45.         I don't know of any filters on UNIX systems that can cope with wmf
  46.         files. There are many PICT filters on Mac's and wmf filters on
  47.         windows platforms.
  48.  
  49.  
  50.         The most common error in the error file is when rtftohtml detects
  51.         a style name that is not listed in html-trans. This is easy!
  52.         Simply edit html-trans, go to the bottom of the file and add
  53.         your style names to the end of the file.
  54.         The format of these entries is:
  55.         "stylename",digit,"htmlMarkupName"
  56.          |          |      ^ The name of the html markup entry (see the top
  57.          |          |        of the file for entry names) to use for this
  58.          |          |        style.
  59.          |          ^ The nesting level (usually zero) If non-zero, this
  60.          |            indicates that you want this style to map to a nested
  61.          |            html list. (i.e.
  62.          |            <ol>
  63.          |                <li>Regular entry (level zero)
  64.          |                <li><ol>
  65.          |                          <li>nested entry
  66.          |                    </ol>
  67.          |            </ol>
  68.          |
  69.          ^ The name of your style
  70.