Command Line Options

   The command line options described below can be used to change the default behavior of LaTeX2HTML . Alternatively, the corresponding environment variables in the initialization file .latex2html-init may be changed, in order to achieve the same result.

-split num

Stop splitting sections into separate files at this depth. A value of 0 will put the document into a single HTML file. The default is 8.

-link num

Stop revealing child nodes at each node at this depth. (A node is a part/chapter/section/subsection/subsubsection etc.). A value of 0 will show no links to child nodes, a value of 1 will show only the immediate descendents, etc. A value at least as big as that of the -split option will produce a table of contents for the tree structure, rooted at each given node. The default is 4.  

-nolatex

Disable the mechanism for passing unknown environments to LaTeX for processing. This can be thought of as ``draft mode'' which allows faster translation of the basic document structure and text, without fancy figures, equations or tables.

This option has been superceded by the -no_images option (see below).

-external_images

Instead of including any generated images inside the document, leave them outside the document and provide hypertext links to them.  

-ascii_mode

Use only ascii characters and do not include any images in the final output. In ascii mode the output of the translator can be used on character based browsers which do not support inlined images (the <IMG> tag).

-t top-page-title

Name the document using this title.

-dir output-directory

Redirect the output to this directory.

-no_subdir

Place the generated HTML files in the current directory. The default behaviour is to create (or reuse) another file directory.

-ps_images

Use links to external postscript images rather than inlined GIF images.

-address author-address

Sign each page with this address.  

-no_navigation

Disable the mechanism for putting navigation links in each page.

-top_navigation

Put navigation links at the top of each page.

-bottom_navigation

Put navigation links at the bottom of each page AS WELL as the top.

-auto_navigation

Put navigation links at the top of each page. If the page exceeds $WORDS_IN_PAGE number of words (the default is 450) then put one at the bottom of the page as well.

-index_in_navigation

Put a link to the index page in the navigation panel if there is an index.

-contents_in_navigation

Put a link to the table of contents in the navigation panel if there is a table of contents.

-next_page_in__navigation

Put a link to the next logical page in the navigation panel.

-previous_page_in__navigation

Put a link to the previous logical page in the navigation panel.

-info string

Generate a new section About this document ... containing information about the document being translated. The default is to generate such a section with information on the original document, the date, the user and the translator. An empty string (or the value 0) disables the creation of this extra section. If a non-empty string is given, it will be placed in the contents of the About this document ... section instead of the default information.

-dont_include file(s)

Do not include the specified file(s). Such files are usually style files which may contain raw TeX commands that LaTeX or the translator cannot handle.

-reuse

Reuse images generated during previous translations where appropriate. This also disables the initial interactive session during which the user is asked whether to reuse the old directory, delete its contents or quit. Images which depend on context (e.g. numbered tables or equations) cannot be reused and are always re-generated.

-no_reuse

Do not reuse images generated during previous translations. (This will enable the initial interactive session during which the user is asked whether to reuse the old directory, delete its contents or quit)

-init_file file

Load the specified file. This Perl file will be loaded after loading $HOME/.latex2html-init (if one exists). It can be used to change the default options.

-no_images

Do not attempt to produce any inlined images. The missing images can be generated "off-line" by restarting LaTeX2HTML with the option -images_only.

-images_only

Try and convert any inlined images that were left over from previous runs of LaTeX2HTML .

-show_section_numbers

Show section numbers. By default the section numbers are not shown in order to encourage the use of particular sections as standalone documents. In order to be shown, section titles must be unique and must not contain inlined graphics.

-h

Print out the list of options.