6.2.1 Jade flags

There are a few flags which you can pass to the stylesheet via the --jadeflags option. For example, to turn on the show-element-ids and suppress-idindex options, you would give the sgml2docs option '--jadeflags=-Vshow-element-ids -Vsuppress-idindex'. These stylesheet options include the following. Note that these are on-switches rather than toggles: due to the way that Jade is implemented, it's not possible to turn these options off explicitly.

All-format parameterisation:

show-element-ids

Display exported IDs in the formatted document (can be useful when working with draft documents).

suppress-manifest

Suppress the generation of a manifest file in the output tarball. This can occasionally be useful when something appears to be going wrong with the packaging, but it's intended for debugging rather than production use.

HTML parameterisation:

nochunks

Output the HTML as a single file, rather than a collection of smaller ones.

stream-output

Send the output to stdout, rather than a generated file name.

suppress-navig

Suppress the navigation panels at the top and bottom of each output file.

separate-toc

Put the table of contents in a separate file.

suppress-banner

Prevents the Starlink banner from being output.

suppress-idindex

Suppress the generation of the ID Index page.

suppress-printable

Suppress the legend `Retrieve hardcopy' on the front page.

LaTeX mode parameterisations (these are more conveniently set via the --options argument described above):

section-samepage

Don't start a new page with each section.

appendix-samepage

Don't start a new page for the appendices.

onepass-latex

Generate LaTeX which does not need a second pass through the LaTeX processor - the TOC appears at the end of the file, in this case, with page numbers which require the paper to be moved to the beginning of the stack.

See Appendix E.4 for copious further details.