Command line options

rtftohtml is invoked by a command like this:

	rtftohtml [options] file

file is the name of the RTF-file to convert. By default the HTML-output will be written to a file with the same basename, but with the .rtf-extension replaced with .html.

The most common options are (see below for more detailed descriptions of these):

to split the document at headings of level level,
to create a table of contents, and
to create an index (of course, this requires index entries to be in the RTF document)

These should suffice in most cases. When invoking rtftohtml without any arguments, a list of all available options is printed. Following is a complete and detailed list of all available command line options, sorted alphabetically:

Generate a table of contents on a separate page (the title page itself normally only contains the level-1-headings).
Indicates that no graphics files should be written. The hypertext links to the graphics files will still be generated. This is a performance feature for when you are re-translating a document and the graphics have not changed.
This tells rtftohtml to split the generated HTML document at all headings of level level, thus creating a separate HTML file for the contents of every section at that level. If level is 0, only one HTML file will be created with a table of contents at the top of the HTML file. If level is omitted, rtftohtml will create a separate HTML file for every section.
For example, -h1 only splits the HTML-File when a level-1-heading is encountered. All lower level headings will be internally referenced from the top of the respective HTML-File.
This option is also required for the -c and -x options.
Indicates that imbedded graphics should be linked into the main document using an IMG tag. The default is to use an HREF style link.
-N file
If the -h option has been given, this option allows you to tell rtftohtml that it should read the description for the navigation panels it produces from file file. Navigation panels are described in more detail in section Navigation panels.
-o filename
Indicates that the basic output file name should be filename. If any other files are created (such as for graphics), the basename of the other files will be filename without ".rtf" if it is present in the name.
-P extension
Use extension as the extension for any links to graphics files. The default for this is "gif".
Use short filenames when splitting the HTML output. In this case the HTML-files are simply numbered. If this option is not present the file-names contain the first eight characters of the first heading contained in the respective files.
Place external references to headlines near the top of the page. (Default is that they occur at the and of the page.)
-T title
Use title as the document title. This overrides any title supplied within the RTF-file (see also section Supplying a title).
(Note: Stock rtftohtml uses this switch to prevent the generation of a table of contents. Since this conflicts with rtftoweb's ToC-handling anyway, I have redefined this command line switch.)
Generate an index. This works by gathering all the index entries of the RTF-File and inserting an invisible anchor at that place.
-X text
By default, rtftohtml inserts index anchors without any text, thus producing "empty anchors" which most Web browsers have no problems with. Unfortunately there is one prominent exception to this statement: NCSA Mosaic. Mosaic requires anchors to contain at least one non-blank character, otherwise they are not recognized. This option lets you use text as the text of such anchors when using Mosaic as your Web browser, e.g. "-X ·".