latex2html --version (return code: 0)
Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^([^{]*){ <-- HERE / at /usr/bin/latex2html line 1897.
This is LaTeX2HTML Version 2008 (1.71)
by Nikos Drakos, Computer Based Learning Unit, University of Leeds.
latex2html --help (return code: 0)
Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^([^{]*){ <-- HERE / at /usr/bin/latex2html line 1897.
[1mNAME[0m
latex2html - Translate LaTeX files to HTML (HyperText Markup Language)
[1mSYNOPSIS[0m
[1mlatex2html[0m [ [1m-help[0m | [1m-h[0m ] [ [1m-version[0m | [1m-V[0m ]
[1mlatex2html[0m [ [1m-split[0m [4mnum[0m ] [ [1m-link[0m [4mnum[0m ] [ [1m-toc_depth[0m [4mnum[0m ]
[ [1m-[0m([1mno[0m)[1mtoc_stars[0m ] [ [1m-[0m([1mno[0m)[1mshort_extn[0m ] [ [1m-iso_language[0m [4mlang[0m ]
[ [1m-[0m([1mno[0m)[1mvalidate[0m ] [ [1m-[0m([1mno[0m)[1mlatex[0m ] [ [1m-[0m([1mno[0m)[1mdjgpp[0m ] [ [1m-[0m([1mno[0m)[1mfork[0m ]
[ [1m-[0m([1mno[0m)[1mexternal_images[0m ] [ [1m-[0m([1mno[0m)[1mascii_mode[0m ] [ [1m-[0m([1mno[0m)[1mlcase_tags[0m ]
[ [1m-[0m([1mno[0m)[1mps_images[0m ] [ [1m-font_size[0m [4msize[0m ] [ [1m-[0m([1mno[0m)[1mtex_defs[0m ]
[ [1m-[0m([1mno[0m)[1mnavigation[0m ] [ [1m-[0m([1mno[0m)[1mtop_navigation[0m ] [ [1m-[0m([1mno[0m)[1mbuttom_navigation[0m ]
[ [1m-[0m([1mno[0m)[1mauto_navigation[0m ] [ [1m-[0m([1mno[0m)[1mindex_in_navigation[0m ]
[ [1m-[0m([1mno[0m)[1mcontents_in_navigation[0m ] [ [1m-[0m([1mno[0m)[1mnext_page_in_navigation[0m ]
[ [1m-[0m([1mno[0m)[1mprevious_page_in_navigation[0m ] [ [1m-[0m([1mno[0m)[1mfootnode[0m ]
[ [1m-[0m([1mno[0m)[1mnumbered_footnotes[0m ] [ [1m-prefix[0m [4moutput_filename_prefix[0m ]
[ [1m-[0m([1mno[0m)[1mauto_prefix[0m ] [ [1m-long_titles[0m [4mnum[0m ] [ [1m-[0m([1mno[0m)[1mcustom_titles[0m ]
[ [1m-title[0m|[1m-t[0m [4mtop_page_title[0m ] [ [1m-[0m([1mno[0m)[1mrooted[0m ] [ [1m-rootdir[0m [4moutput_directory[0m ]
[ [1m-dir[0m [4moutput_directory[0m ] [ [1m-mkdir[0m ]
[ [1m-address[0m [4mauthor_address[0m | [1m-noaddress[0m ] [ [1m-[0m([1mno[0m)[1msubdir[0m ]
[ [1m-info[0m [4m0[0m | [4m1[0m | [4mstring[0m ] [ [1m-[0m([1mno[0m)[1mauto_link[0m ] [ [1m-reuse[0m [4mnum[0m | [1m-noreuse[0m ]
[ [1m-[0m([1mno[0m)[1mantialias_text[0m ] [ [1m-[0m([1mno[0m)[1mantialias[0m ] [ [1m-[0m([1mno[0m)[1mtransparent[0m ]
[ [1m-[0m([1mno[0m)[1mwhite[0m ] [ [1m-[0m([1mno[0m)[1mdiscard[0m ] [ [1m-image_type[0m [4mtype[0m ] [ [1m-[0m([1mno[0m)[1mimages[0m ]
[ [1m-accent_images[0m [4mtype[0m | [1m-noaccent_images[0m ] [ [1m-style[0m [4mstyle[0m ]
[ [1m-[0m([1mno[0m)[1mparbox_images[0m ] [ [1m-[0m([1mno[0m)[1mmath[0m ] [ [1m-[0m([1mno[0m)[1mmath_parsing[0m ] [ [1m-[0m([1mno[0m)[1mlatin[0m ]
[ [1m-[0m([1mno[0m)[1mentities[0m ] [ [1m-[0m([1mno[0m)[1mlocal_icons[0m ] [ [1m-[0m([1mno[0m)[1mscalable_fonts[0m ]
[ [1m-[0m([1mno[0m)[1mimages_only[0m ] [ [1m-[0m([1mno[0m)[1mshow_section_numbers[0m ] [ [1m-[0m([1mno[0m)[1mshow_init[0m ]
[ [1m-init_file[0m [4mPerl_file[0m ] [ [1m-up_url[0m [4mup_URL[0m ] [ [1m-up_title[0m [4mup_title[0m ]
[ [1m-down_url[0m [4mdown_URL[0m ] [ [1m-down_title[0m [4mdown_title[0m ] [ [1m-prev_url[0m [4mprev_URL[0m ]
[ [1m-prev_title[0m [4mprev_title[0m ] [ [1m-index[0m [4mindex_URL[0m ] [ [1m-biblio[0m [4mbiblio_URL[0m ]
[ [1m-contents[0m [4mtoc_URL[0m ] [ [1m-external_file[0m [4mexternal_aux_file[0m ]
[ [1m-[0m([1mno[0m)[1mshort_index[0m ] [ [1m-[0m([1mno[0m)[1munsegment[0m ] [ [1m-[0m([1mno[0m)[1mdebug[0m ] [ [1m-tmp[0m [4mpath[0m ]
[ [1m-[0m([1mno[0m)[1mldump[0m ] [ [1m-[0m([1mno[0m)[1mtiming[0m ] [ [1m-verbosity[0m [4mnum[0m ] [ [1m-html_version[0m [4mnum[0m ]
[ [1m-[0m([1mno[0m)[1mstrict[0m ] [4mfile.tex[0m [ [4mfile2.tex[0m ... ]
[1mDESCRIPTION[0m
[4mLaTeX2HTML[0m is a Perl program that translates LaTeX source files into HTML.
For each source file given as an argument the translator will create a
directory containing the corresponding HTML files.
[1mOPTIONS[0m
Many options can be specified in a true/false manner. This is indicated by
[4m(no)[0m, e.g. to enable passing unknown environments to LaTeX, say "-latex",
to disable the feature say "-nolatex" or "-no_latex" (portability mode).
[1m-help[0m | [1m-h[0m
Print this online manual and exit.
[1m-version[0m | [1m-V[0m
Print the LaTeX2HTML release and version information and exit.
[1m-split[0m [4mnum[0m
Stop making separate files at this depth (say "-split 0" for one huge
HTML file).
[1m-link[0m [4mnum[0m
Stop showing child nodes at this depth.
[1m-toc_depth[0m [4mnum[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mtoc_stars[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mshort_extn[0m
If this is set all HTML file will have extension ".htm" instead of
".html". This is helpful when shipping the document to PC systems.
[1m-iso_language[0m [4mlang[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mvalidate[0m
When this is set true, the HTML validator specified in l2hconf.pm will
run.
[1m-[0m([1mno[0m)[1mlatex[0m
Pass unknown environments to LaTeX. This is the default.
[1m-[0m([1mno[0m)[1mdjgpp[0m
Specify this switch if you are running DJGPP on DOS and need to avoid
running out of filehandles.
[1m-[0m([1mno[0m)[1mfork[0m
Enable/disable forking. The default is reasonable for this platform.
[1m-[0m([1mno[0m)[1mexternal_images[0m
If set, leave the images outside the document.
[1m-[0m([1mno[0m)[1mascii_mode[0m
This is different from [1m-noimages[0m. If this is set, [1mLaTeX2HTML[0m will show
textual tags rather than images, both in navigation panel and text
(Eg. "[Up]" instead the up icon). You could use this feature to create
simple text from your document, eg. with 'Save as... Text' from
[1mNetscape[0m or with [1mlynx -dump[0m.
[1m-[0m([1mno[0m)[1mlcase_tags[0m
writes out HTML tag names using lowercase letters, rather than
uppercase.
[1m-[0m([1mno[0m)[1mps_images[0m
If set, use links to external postscript images rather than inlined
bitmaps.
[1m-font_size[0m [4msize[0m
To set the point size of LaTeX-generated GIF files, specify the
desired value (i.e., "10pt", "11pt", "12pt", etc.). The default is to
use the point size of the original LaTeX document. This value will be
magnified by [4m$FIGURE_SCALE_FACTOR[0m and [4m$MATH_SCALE_FACTOR[0m defined in
l2hconf.pm.
[1m-[0m([1mno[0m)[1mtex_defs[0m
Enable interpretation of raw TeX commands (default). Note: There are
many variations of "\def" that [1mLaTeX2HTML[0m cannot process correctly!
[1m-[0m([1mno[0m)[1mnavigation[0m
Put a navigation panel at the top of each page (default).
[1m-[0m([1mno[0m)[1mtop_navigation[0m
Enables navigation links at the top of each page (default).
[1m-[0m([1mno[0m)[1mbuttom_navigation[0m
Enables navigation links at the buttom of each page.
[1m-[0m([1mno[0m)[1mauto_navigation[0m
Put navigation links at the top of each page. If the page exceeds
[4m$WORDS_IN_PAGE[0m number of words then put one at the bottom of the page.
[1m-[0m([1mno[0m)[1mindex_in_navigation[0m
Put a link to the index page in the navigation panel.
[1m-[0m([1mno[0m)[1mcontents_in_navigation[0m
Put a link to the table of contents in the navigation panel.
[1m-[0m([1mno[0m)[1mnext_page_in_navigation[0m
Put a link to the next logical page in the navigation panel.
[1m-[0m([1mno[0m)[1mprevious_page_in_navigation[0m
Put a link to the previous logical page in the navigation panel.
[1m-[0m([1mno[0m)[1mfootnode[0m
Puts all footnotes onto a separate HTML page, called footnode.html,
rather than at the bottom of the page where they are referenced.
[1m-[0m([1mno[0m)[1mnumbered_footnotes[0m
If true, you will get every footnote applied with a subsequent number,
else with a generic hyperlink icon.
[1m-prefix[0m [4moutput_filename_prefix[0m
Set the output file prefix, prepended to all ".html", ".gif" and ".pl"
files. See also [1m-auto_prefix[0m.
[1m-[0m([1mno[0m)[1mauto_prefix[0m
Set this to automatically insert the equivalent of [1m-prefix
[0m"basename-"", where "basename" is the base name of the file being
translated.
[1m-long_titles[0m [4mnum[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mcustom_titles[0m
MISSING_DESCRIPTION
[1m-title[0m|[1m-t[0m [4mtop_page_title[0m
The title (displayed in the browser's title bar) the document shall
get.
[1m-[0m([1mno[0m)[1mrooted[0m
MISSING_DESCRIPTION
[1m-rootdir[0m [4moutput_directory[0m
MISSING_DESCRIPTION
[1m-dir[0m [4moutput_directory[0m
Put the result in this directory instead of parallel to the LaTeX
file, provided the directory exists, or [1m-mkdir[0m is specified.
[1m-mkdir[0m
Allow directory specified with [1m-dir[0m to be created if necessary.
[1m-address[0m [4mauthor_address[0m | [1m-noaddress[0m
Supply your own string if you don't like the default "<Name> <Date>".
[1m-noaddress[0m suppresses the generation of an address footer.
[1m-[0m([1mno[0m)[1msubdir[0m
If set (default), [1mLaTeX2HTML[0m creates (or reuses) another file
directory. When false, the generated HTML files will be placed in the
current directory.
[1m-info[0m [4m0[0m | [4m1[0m | [4mstring[0m
[1m-noinfo[0m
If 0 is specified (or [1m-noinfo[0m is used), do not generate an [4m"About this
document..."[0m section. If 1 is specified (default), the standard info
page is generated. If a custom string is given, it is used as the info
page.
[1m-[0m([1mno[0m)[1mauto_link[0m
MISSING_DESCRIPTION
[1m-reuse[0m [4mnum[0m | [1m-noreuse[0m
If false, do not reuse or recycle identical images generated in
previous runs. If the html subdirectory already exists, start the
interactive session. If [4mnum[0m is nonzero, do recycle them and switch off
the interactive session. If 1, only recycle images generated from
previous runs. If 2, recycle images from the current and previous runs
(default).
[1m-[0m([1mno[0m)[1mantialias_text[0m
Use anti-aliasing in the generation of images of typeset material;
e.g. mathematics and text, e.g. in tables and {makeimage}
environments.
[1m-[0m([1mno[0m)[1mantialias[0m
Use anti-aliasing in the generation of images of figures. This usually
results in "sharper" bitmap images.
[1m-[0m([1mno[0m)[1mtransparent[0m
If this is set to false then any inlined images generated from
"figure" environments will NOT be transparent.
[1m-[0m([1mno[0m)[1mwhite[0m
This sets the background of generated images to white for
anti-aliasing.
[1m-[0m([1mno[0m)[1mdiscard[0m
if true, the PostScript file created for each generated image is
discarded immediately after its image has been rendered and saved in
the required graphics format. This can lead to significant savings in
disk-space, when there are a lot of images, since otherwise these
files are not discarded until the end of all processing.
[1m-image_type[0m [4mtype[0m
Specify the type of bitmap images to be generated. Depending on your
setup, [1mLaTeX2HTML[0m can generate [1mgif[0m or [1mpng[0m images. Note: Gif images
have certain legal restrictions, as their generation involves an
algorithm patented by Unisys.
[1m-[0m([1mno[0m)[1mimages[0m
If false, [1mLaTeX2HTML[0m will not attempt to produce any inlined images.
The missing images can be generated "off-line" by restarting
[1mLaTeX2HTML[0m with [1m-images_only[0m.
[1m-accent_images[0m [4mtype[0m | [1m-noaccent_images[0m
MISSING_DESCRIPTION
[1m-style[0m [4mstyle[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mparbox_images[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mmath[0m
By default the special MATH extensions are not used since they do not
conform with the HTML 3.2 standard.
[1m-[0m([1mno[0m)[1mmath_parsing[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mlatin[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mentities[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mlocal_icons[0m
Set this if you want to copy the navigation icons to each document
directory so that the document directory is self-contained and can be
dropped into another server tree without further actions.
[1m-[0m([1mno[0m)[1mscalable_fonts[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mimages_only[0m
When true, [1mLaTeX2HTML[0m will only try to convert the inlined images in
the file images.tex which should have been generated automatically
during previous runs. This is very useful for correcting "bad LaTeX"
in this file.
[1m-[0m([1mno[0m)[1mshow_section_numbers[0m
When this is set true, the section numbers are shown. The section
numbers should then match those that would have been produced by
LaTeX. The correct section numbers are obtained from the $FILE.aux
file generated by LaTeX. Hiding the section numbers encourages use of
particular sections as standalone documents. In this case the cross
reference to a section is shown using the default symbol rather than
the section number.
[1m-[0m([1mno[0m)[1mshow_init[0m
MISSING_DESCRIPTION
[1m-init_file[0m [4mPerl_file[0m
MISSING_DESCRIPTION
[1m-up_url[0m [4mup_URL[0m, [1m-up_title[0m [4mup_title[0m
[1m-down_url[0m [4mdown_URL[0m, [1m-down_title[0m [4mdown_title[0m
[1m-prev_url[0m [4mprev_URL[0m, [1m-prev_title[0m [4mprev_title[0m
[1m-index[0m [4mindex_URL[0m,
[1m-contents[0m [4mtoc_URL[0m
[1m-biblio[0m [4mbiblio_URL[0m
If both of the listed two options are set then the "Up" ("Previous"
etc.) button of the navigation panel in the first node/page of a
converted document will point to [4mup_URL[0m etc. [4mup_title[0m should be set to
some text which describes this external link. Similarly you might use
these options to link external documents to your navigation panel.
[1m-external_file[0m [4mexternal_aux_file[0m
MISSING_DESCRIPTION
[1m-[0m([1mno[0m)[1mshort_index[0m
If this is set then [1mmakeidx.perl[0m will construct codified names for the
text of index references.
[1m-[0m([1mno[0m)[1munsegment[0m
Use this to translate a segmented document as if it were not
segmented.
[1m-[0m([1mno[0m)[1mdebug[0m
If this is set then intermediate files are left for later inspection
and a lot of diagnostic output is produced. This output may be useful
when searching for problems and/or submitting bug reports to the
developers. Temporary files include $$_images.tex and $$_images.log
created during image conversion. Caution: Intermediate files can be
[4menormous[0m!
[1m-tmp[0m [4mpath[0m
Path for temporary files. This should be a local, fast filesystem
because it is heavily used during image generation. The default is set
in l2hconf.pm.
[1m-[0m([1mno[0m)[1mldump[0m
This will cause LaTeX2HTML to produce a LaTeX dump of images.tex which
is read in on subsequent runs and speeds up startup time of LaTeX on
the images.tex translation. This actually consumes additional time on
the first run, but pays off on subsequent runs. The dump file will
need about 1 Meg of disk space.
[1m-[0m([1mno[0m)[1mtiming[0m
MISSING_DESCRIPTION
[1m-verbosity[0m [4mnum[0m
The amount of message information printed to the screen during
processing by [1mLaTeX2HTML[0m is controlled by this setting. By increasing
this value, more information is displayed. Here is the type of extra
information that is shown at each level:
0 no extra information
1 section types and titles
2 environment
3 command names
4 links, labels and internal sectioning codes
[1m-html_version[0m [4mlist[0m
Which HTML version should be generated. Currently available are: 2.0,
3.0, 3.2, 4.0. Some additional options that may be added are: "math"
(parse mathematics), "i18n" (?), "table" (generate tables), "frame"
(generate frames), "latin1"..."latin9" (use ISO-Latin-x encoding),
"unicode" (generate unicode characters). Separate the options with
',', e.g. "4.0,math,frame".
[1m-[0m([1mno[0m)[1mstrict[0m
MISSING_DESCRIPTION
[1mFILES[0m
$LATEX2HTMLPLATDIR/l2hconf.pm
This file holds the global defaults and configuration settings for
[1mLaTeX2HTML[0m.
$HOME/.latex2html-init
./.latex2html-init
These files may contain settings that override the global defaults,
just like specifying command line switches.
[1mENVIRONMENT[0m
LATEX2HTMLDIR
Path where LaTeX2HTML library files are found. On this installation
LATEX2HTMLDIR is /usr/share/latex2html
PERL5LIB
Set by the [1mlatex2html[0m program to find perl modules.
L2HCONFIG
An alternative configuration filename. The standard configuration file
is $LATEX2HTMLPLATDIR/l2hconf.pm. You may specify a sole filename
(searched for in $LATEX2HTMLPLATDIR (and $PERL5LIB) or a complete
path.
L2HINIT_NAME
The standard user-specific configuration filename is .latex2html-init.
This environment variable will override this name.
HOME
Evaluated if the system does not know about "home" directories (like
DOS, WinXX, OS/2, ...) to determine the path to $L2HINIT_NAME.
TEXE_DONT_INCLUDE, TEXE_DO_INCLUDE
Used internally for communication with [1mtexexpand[0m.
TEXINPUTS
Used to find TeX includes of all sorts.
[1mPROBLEMS[0m
For information on various problems and remedies see the WWW online
documentation or the documents available in the distribution. An online
bug reporting form and various archives are available at
http://www.latex2html.org/
There is a mailing list for discussing [1mLaTeX2HTML[0m: "latex2html@tug.org"
[1mAUTHOR[0m
Nikos Drakos, Computer Based Learning Unit, University of Leeds
<nikos@cbl.leeds.ac.uk>. Several people have contributed suggestions,
ideas, solutions, support and encouragement.
The [1mpstoimg[0m script was written by Marek Rouchal
<marek@saftsack.fs.uni-bayreuth.de> as a generalisation of the [1mpstogif[0m
utility to allow graphic formats other than GIF to be created. Various
options and enhancements have been added by Ross Moore. Some of the code
is based upon the pstoppm.ps postscript program originally written by
Phillip Conrad (Perfect Byte, Inc.) and modified by L. Peter Deutsch
(Aladdin Enterprises).
[1mSEE ALSO[0m
See the WWW online documentation or the $LATEX2HTMLDIR/doc/manual.ps file
for more detailed information and examples.
pstoing, texexpand