Options for httex, htlatex and httexi¶

httex, htlatex and httexi are shell scripts that can be used to convert a file in the TeX/LaTeX/texinfo format into HTML. This TeX source file should be like any other TeX source file normally used to produce a .dvi file by processing with TeX and friends. The name of such a file is the mandatory file argument for each script. This is followed by up to three optional arguments (delimited with quotation marks). These arguments, which are not required for typical usage, are as follows:

1.

The first argument is a list of options for the tex4ht.sty style file (used with tex or latex), separated with commas. See the HTML documentation for the list of options available. The .log file generated by tex/latex also includes summaries of some of the options available. If not empty, this argument must start with html or xhtml. Additional options could be mathml or docbook to indicate appropriate style of output.

2.

This argument is used to select tagged sections of tex4ht.env that specifies the font files (*.htf) to use. This corresponds to the -c option for the command tex4ht as explained below. Examples include unicode or mozilla.

3.

This argument lists options for the t4ht program as explained below.

See the HTML documentation for more details and examples.

Similar scripts are available within the directory /usr/share/tex4ht for generating other kinds of hypertext output. It is also possible to use the perl script mk4ht as explained below.

Options for mk4ht¶

mk4ht is a perl script that can be used to convert TeX source files from numerous dialects of TeX into different hypertext variants. This script takes two mandatory arguments: the name of the command to run and the file to run it on. Each possible command is of the form "<variant><dialect>": so for example xhmlatex denotes a LaTeX source that needs to be converted to XHTML with MathML extensions. The possible names for commands can be found by listing the directory /usr/share/tex4ht. The three optional arguments to mk4ht are identical to those outlined above for httex, htlatex and httexi. In fact, the command htlatex foo is identical to mk4ht htlatex foo except that the former is shorter to type! However, mk4ht can be configured to shorten the command line as follows.

Each user can create the configuration file mk4ht.cfg or .mk4ht in the home or working directory to configure commonly used options for mk4ht; in addition options to clean up temporary files can also be added to this configuration file. Running the command mk4ht without any arguments will summarise the use of this user configuration file.

Options for ht¶

ht is a small shell script that is used to run the tex4ht programs. It has two compulsory arguments, as follows:

1.

The TeX command name to run, usually either tex or latex.

2.

The input file name (with or without extension).

It may take any additional options, which will be passed on to the call to t4ht.

General directory/file search options¶

Several of the options detailed below relate to setting directory paths to find particular kinds of files. Note the following when specifying directories for the programs:

1.

There must be no space between the option letter (eg, -t) and the directory/file name.

2.

The directory name must end with a trailing slash (/, or /! - see below).

3.

You can add an exclamation mark (!) to the end of the directory name, to enable sub-directory searching.

4.

Only one directory can be specified at a time. To search multiple directories, either use the sub-directory searching facility or repeat the option. (The directory search options can be repeated as often as required.)

5.

When compiled with kpathsea (as in the Debian package), the path-searching is in part taken over by kpathsea. On a Debian system see /usr/share/doc/tex4ht/README.kpathsea for more information on path-searching in a kpathsea-enabled tex4ht.

As well as command-line options, most of these options can (and normally should) be set in the configuration file tex4ht.env. The format within this file is similar, but without using a hyphen before the option letter. See the HTML documentation for more details on the configuration options available. The file tex4ht.env can be superseded on a per-directory and/or a per-user basis as explained in the HTML documentation. On a Debian system see /usr/share/doc/tex4ht/README.Debian as well.

Options for tex4ht¶

-ctag-name

Certain lines within the tex4ht.env configuration file can be marked with tags. These lines (typically htf-font-dir search lines) will be omitted unless specifically requested by specifying the tag name on the tex4ht command line. If not used, a command-line option of -cdefault is assumed. (See the supplied tex4ht.env file for examples of tagged sections.)

-eenv-file

Specify address of the tex4ht configuration file tex4ht.env.

-gbitmap-file-ext

Set the extension of bitmap images to bitmap-file-ext instead of the default .png. Note that the extension should begin with a dot (.). Note also that this option only affects images generated automatically for symbol fonts, and not images generated with the \Picture macro of tex4ht.

-he

Trace errors and warnings (produces verbose output).

-hg

Trace groups

-hs

Trace \specials.

-hV

Trace search path for tex4ht.env configuration file

-hF

Trace search path for .htf font files

-hv

Dump contents of found tex4ht.env configuration file to stderr (for debugging)

-hf

Dump contents of each .htf font file found to stderr (for debugging)

-ihtf-font-dir

Set directory for HTF font files (used by tex4ht) to htf-font-dir.

-lbookkeeping-file

Specify name of the file listing cache used to speed up filename lookups (ignored if compiled with kpathsea support)

-Pfilter

Restrict system calls requested in the source (La)TeX files to utilities whose names have filter as a prefix. Use a single asterisk as filter to allow any system calls.

-ttfm-font-dir

Set directory for TFM font files to tfm-font-dir (ignored if compiled with kpathsea support).

-u10

Use base 10 encoding for unicode characters.

-utf8

Use utf-8 encoding for unicode characters.

-xs

Use 8.3 (MSDOS style) file names for the generated PNG files.

Options for t4ht¶

-ctag-name

Certain lines within the tex4ht.env configuration file can be marked with tags. These lines (typically scripts for post-processing files) will be omitted unless specifically requested by specifying the tag name on the tex4ht command line. If not used, a command-line option of -cdefault is assumed. (See the supplied tex4ht.env file for examples of tagged sections.)

-dout-dir

Output files to directory out-dir, instead of to the current directory.

-eenv-file

Specify address of the tex4ht configuration file tex4ht.env.

-i

Generate verbose debugging output.

-mmode

Create any new output files with access mode as indicated by mode. The mode should be a numeric mode, as used by the chmod(1) command.

-Mmode

As -m but change all mode of all output files (including reused bitmaps).

-p

Do not convert pictures (ie, images generated with macros like \Picture, not characters in symbol fonts that will be automatically converted into a graphic file).

-r

Do not resuse existing bitmaps of glyphs (for characters in symbol fonts etc), but instead generate all bitmaps anew.

-Sfilter

Restrict system calls requested in the source (La)TeX files to utilities whose names have filter as a prefix. Use a single asterisk as filter to allow any system calls.

-Xfield-content

Scripts for post-processing of files can be specified in tex4ht.env. If these scripts refer to a field %%3, content for that field can be set with this command-line option.

-.field-content

Scripts for post-processing of groups of files with a particular extension can be specified in tex4ht.env. If these scripts refer to a field %%2, content for that field can be set with this command-line option.