§ 2.3. Splitting the Output

For larger documents, it is often desirable to break the result into several interlinked pages. This split, carried out before scanning, is requested by

--splitat=level

where level is one of chapter, section, subsection, or subsubsection. For example, section would split the document into chapters (if any) and sections, along with separate bibliography, index and any appendices. The removed document nodes are replaced by a Table of Contents.

The extra files are named using either the id or label of the root node of each new page document according to

--splitnaming=(id|idrelative|label|labelrelative)

The relative foms create shorter names in subdirectories for each level of splitting. The --urlstyle option may also be useful here, as well as the latexml option --documentid.

Additionally, the index and bibliography can be split into separate pages according to the initial letter of entries by using the options

--splitindex and --splitbibliography