5.4.3 Themes
The theming support in the HTML5 renderer is a superset of that of the Page Template Renderer. Any template directory can have a subdirectory called ‘Themes’ which contains theme directories with sets of templates in them. The names of the directories in the ‘Themes’ directory corresponds to the name of the theme. Each of these directories can contain folders named ‘css’ and ‘js’, and containing CSS and javascript files respectively. Those files are copied while rendering, unless option --copy-theme-extras is unset.
There are currently three themes included with plasTeX: default, minimal and fragment. The first two themes produce standalone HTML files, including a head section. The fragment theme produces output that is meant to be inserted in a HTML document already containg a head section. The default theme include some javascript and CSS file. One can choose between three variations on CSS using option --theme-css which can be white, blue or green. The default value is white which uses a sober black on white color scheme with no gradient background of shadow. The green CSS theme uses the historical plasTeX green and yellow color scheme, with gradients and shadows. The blue one uses a blue and gray color scheme, with gradients and shadows.
When displaying the table of contents navigation panel, the default theme adds at the end the elements of the list document.rendererdata['html5']['extra_toc_items']
. Each element should be a dictionary with keys text
and url
.