Power Feature: Breadcrumbing

This feature allows you to split the document into chunks, and to navigate forwards, backwards and upwards within it.

The directive used to tell the processor to do this is

 // split into pages //

By default (as shown above), Doco will split every section into a separate page. However, it is usual to want breadcrumbing to occur up to a specified level, rather than for all levels.

You do this with an until clause.

 // split into pages until level 2 //

Whenever page splitting is enabled, Doco also writes a 'printable' version (i.e. one that is not split into pages) to the file, i.e.

 <originalFileName>_full.html

..in the target directory.

You can always reference this file from within the breadcrumbed document using the following variable.

 $(doco.document.printable)