These settings establish a default chunking policy, to determine how topics are assorted into output files for each referenced document. The settings take effect for the entire map, unless chunking attributes are already present on the map element, and except where chunking attributes are present on individual topicref elements.
Note: There is no default policy if you do not set a chunking policy. However, in the absence of any settings to the contrary, DITA2Go uses chunk by topic for HTML output and chunk by document for RTF output.
Default output file names are overridden by copy-to attributes.
You can specify default policies for:
To specify chunking by topic or by document:
[Chunking] ; ChunkBy = Document (put all topics in one output file, ; or Topic (put each topic into its own file). ChunkBy = Topic
DITA2Go distributes topics according to the value of ChunkBy:
All referenced topics go into one output file, named for the top-level map or document. |
|
Each referenced topic goes into its own output file, named for the topic ID. |
There is no default value for ChunkBy.
To specify selection of all topics, of just the referenced topic, or of the referenced topic and all its descendants:
[Chunking] ; ChunkSel = Document (include all topics in the document, ; Topic (include only the topic id'd in the <topicref>, or ; Branch (include the id'd (or first) topic and all of its children). ChunkSel = Topic
DITA2Go includes topics according to the value of ChunkSel:
All topics in the referenced document are included in a single file. |
|
The file for each referenced topic includes all topics logically nested in (descended from) that topic. |
ChunkSel has no meaning for files that contain just one topic, only for those that contain nested topics, or topics wrapped in <dita>.