HEVEA(1)

NAME
hevea - convert LaTeX file to HTML

SYNOPSIS
hevea [OPTION...] [HVA-FILE...|LATEX-FILE...]

DESCRIPTION

Normal Mode
    Consult HVA-FILEs and LATEX-FILEs. The last LATEX-FILE in the command line is designated main-input file and it is expected to contain the \documentclass macro. All temporary and output filenames are derived from this main-input filename (unless overridden with option -o). Translate the main-input file to HTML given the definitions in the other HVA-FILEs and LATEX-FILEs.

Filter Mode
    If the last file on the command line is not a LATEX-FILE or no file is given at all Hevea operates in filter mode. It then consults all HVA-FILEs and LATEX-FILEs if any are passed on the command line then reads LaTeX-source from standard input and writes to standard output (unless overridden with option -o).

Options ‘-info’ and ‘-text’ change the output format to GNU Info and plain text, respectively.

OPTIONS

-dv Add borders to some block-level elements. This option is mainly interesting for the Hevea developers.

-e FILENAME
    Exclude FILENAME from being processed.

-entities
    Render symbols by using entities. This is the default.

-exec PROGRAM
    Execute external PROGRAM, then read its result.

-fix
    Iterate Hevea until reaching a fixpoint. This option does not work in “Filter Mode”.

-francais
    French mode (deprecated).

-help
    Display a list of all options and exit.

-I DIRECTORY
    Prepend DIRECTORY to search path for input files (*.tex, *.sty, and *.hva).

-info
    Output GNU Info files. Note that Hevea unconditionally splits the output Info files in parts like makeinfo without the --no-split flag! The default output filename extension is .info for the root Info file and .info-# for all leaf-files with # being a decimal number.

-mathml
    Generate MathML output for equations. This feature is very experimental!

-moreentities
    Enable the output of some rare entities.

-noiso
    Deprecated – does nothing.

-O  Call esponja to optimize HTML output for minimal size.

-o FILENAME
    Redirect Hevea output to FILENAME. If FILENAME is a path, this is, expands to DIRECTORY/FILENAME, all output goes into DIRECTORY and the output file therin will be called FILENAME. A single dash (-) as FILENAME redirects output to standard output.

-pedantic
    Be pedantic in interpreting the HTML 4.0 transitional definition.

-rsz SIZE
    Adjust the SIZE of leaves in rope implementation. The default rarely needs changing.

-s  Suppress warnings.

-text
    Output plain text. The default output filename extension is .txt.

-textsymbols
    Render symbols by English text.

-v  Verbose flag; repeat to increase verbosity.

-version
    Show Hevea version and library directory.

-w WIDTH
    Set the output WIDTH for plain text or GNU Info output. This option has no effect in HTML mode.

ENVIRONMENT

HEVEADIR
    If $HEVEADIR is set, its value is used as the Hevea library directory. This directory contains specific style files, supporting graphics files, and some auxiliary binaries needed for the translation.

EXAMPLES

•   Translate the LaTeX file paper.tex to HTML:

        hevea paper.tex

    The result goes into file paper.html.

•   Convert the LaTeX file text.tex to HTML and use manual.hva as additional source of definitions; write the result to manual.html.

        hevea -o manual.html manual.hva text.tex

•   Generate text.html of the LaTeX source text.tex, re-run hevea until all labels have definite values. Finally run esponia on the output of hevea to optimize the resulting HTML file.

        hevea -fix -O text.tex

SEE ALSO
esponja(1), hacha(1), makeinfo(1).