Docs:HTMLInputHandler Configuration

The course processor configuration file may contain a section that allows you to modify the behaviour of the HTMLInputHandler in various ways. This section, and all directives within it, are optional: the HTMLInputHandler will fall back on defaults if this section, or any directives, are not specified.

[HTMLInputHandler]
latexcmd       = /usr/bin/latex2html
latexargs      = -nonavigation -noaddress -white -noinfo -antialias_text -html_version "4.1"
latexintro     = \documentclass[12pt]{article}\n\usepackage{html}\n\usepackage[dvips]{color}\n\pagecolor{white}
cleanup        = 1

[HTMLInputHandler] introduces the section in which the settings for the HTMLInputHandler can be specified. The following directives may be specified within this section (any other directives in this section will be ignored):

latexcmd

This directive is optional.

Allows you to specify the location of the latex2html command if it is not in the default '/usr/bin/latex2html' location.

latexargs

This directive is optional.

Specifies the arguments to pass to latex2html when processing [latex] blocks. You must specify at least -nonavigation -noaddress -white -noinfo, otherwise the processing of [latex] blocks will fail hilariously.

latexintro

This directive is optional.

Overrides the default LaTeX document preamble. This will be automatically placed at the start of temporary LaTeX files created while processing [latex] blocks. If you need multiple lines, insert \n to indicate a newline is needed.

cleanup

This directive is optional.

If set to 1, all temporary files are removed after processing, and all source steps are removed. If set to 0, temporary files and source steps are retained - this can be useful for debugging processing problems in some situations. If not specified, the default is to remove temporary and source files.