plasTeX 3.0 — A Python Framework for Processing LaTeX Documents

2.1.7 HTML5 Renderer Options

Each renderer can define its own configuration options. This section describes options from the HTML5 renderer. These options have no effect if another renderer is used. Also these options may have no effect if the default theme is not used.

The first three options give control on navigation helpers (tables of contents and breadcrumbs links). Together with the extra-css option, which allows to set css rules overriding the default ones, they allow radical changes to the output style without modifying any template or python code. See Section 5.4 for more information on the HTML5 renderer and how to customize its output.

Display table of contents on each page


Command-Line Options: --display-toc or --no-display-toc
Config File: [ html5 ] display-toc
Default: true
specifies whether to display the table of contents on each page.

Local table of contents level


Command-Line Options: --localtoc-level=level
Config File: [ html5 ] localtoc-level
Default: Node.DOCUMENT_LEVEL-1
specifies from which level one creates local table of contents. The default value implies local table of contents are never created.

Create breadcrumbs from this level


Command-Line Options: --breadcrumbs-level=level
Config File: [ html5 ] breadcrumbs-level
Default: 10
specifies from which level one creates breadcrumbs navigation links. The default value means no breadcrumb at all.

Use theme CSS


Command-Line Options: --use-theme-css or --no-theme-css
Config File: [ html5 ] use-theme-css
Default: True
specifies whether to use CSS files from the theme.

Theme CSS file


Command-Line Options: --theme-css=theme
Config File: [ html5 ] theme-css
Default: white
specifies when CSS theme to use. Possible values are currently white, blue or green.

Extra CSS file


Command-Line Options: --extra-css filename1 filename2 ...
Config File: [ html5 ] extra-css
Default: []
specifies a list of css files to use in addition the theme css. These files are copied to the output directory by the renderer and loaded by the main layout template in the list order after the theme css files (if any) and the packages css files (if any).

Use theme javascript


Command-Line Options: --use-theme-js or --no-theme-js
Config File: [ html5 ] use-theme-js
Default: True
specifies whether to use javascript files from the theme. The default theme javascript is used to hide or show part of the table of contents and proofs.

Extra javascript


Command-Line Options: --extra-js filename1 filename2 ...
Config File: [ html5 ] extra-css
Default: []
specifies a list of javascript files to use (in addition to those coming from the theme is the use-theme-js option is set to true). These files are copied to the output directory by the renderer and loaded by the main layout template in the list order after the theme javascript files (if any) and the packages javascript files (if any).

Use MathJax


Command-Line Options: --use-mathjax or --no-mathjax
Config File: [ html5 ] use-mathjax
Default: True
specifies whether to use MathJax for mathematics rendering. Setting this to False only makes sense if the document contains no mathematics or if some filter is expected to handle mathematics (see --filters option below).

MathJax library url


Command-Line Options: --mathjax-url=url
Config File: [ html5 ] mathjax-url
Default: http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_CHTML
specifies where to find the MathJax javascript lib (including the config information as in the default value).

Use single dollars as math delimiter for MathJax


Command-Line Options: --dollars or --no-dollars
Config File: [ html5 ] mathjax-dollars
Default: False
specifies whether single dollars can be used as math delimiters instead of \( and \). This information is used by MathJax.

MathJax macros


Command-Line Options: --mj-macros name value
Config File: [ mathjax-macros ] macros
Default: {}
specifies a dictionary of macros for MathJax. This can be used for common macros that are not implemented by MathJax, for instance \qedhere. On the command line, the option can be provided several times to define several macros. But this option is much more convenient to specify in a config file in a mathjax-macros section containing one line name=value per macro.

Filters applied on output


Command-Line Options: --filters filter1 filter2 …
Config File: [ html5 ] filters
Default: []
specifies a list of commands to invoke on each output page. Each command should expect one file to convert on stdin and output the converted file on stdout.