27.2.1 Choosing between splitting and chunking

By default, DITA2Go splits documents at DITA topic boundaries to produce an output file for every topic. To use DITA chunking to assort topics into output files instead:

[Chunking]
; SplitTopicFiles = Yes (default, produce an output file for every
; topic, override any chunkby attributes), or No (use DITA chunking
; if any, otherwise produce one output file)
SplitTopicFiles = No

When SplitTopicFiles=Yes, DITA2Go overrides chunking attributes and produces a separate output file for each topic. SplitTopicFiles=Yes has the same effect as setting ChunkBy=Topic; see §27.2.2 Specifying a chunking policy.

When SplitTopicFiles=No, DITA2Go uses DITA chunking, if any is specified. In the absence of chunking, DITA2Go produces one large file. At that point, you can use the DITA2Go split mechanism instead; see §27.3 Splitting files.

To disable chunking entirely:

[Chunking]
; DisableChunking = No (default, process chunking attribute normally),
; or Yes (ignore chunking attribute)
DisableChunking = Yes

When DisableChunking=Yes, DITA2Go ignores the chunking attribute, and instead goes by the setting for SplitTopicFiles, or by the Split settings in [HTMLParaStyles]; see §27.3 Splitting files.

Note:  For generated files (see §14.1 Understanding how DITA2Go produces lists) you do not have to disable chunking in order for SplitTopicFiles to be effective.

Previous Topic:  27.2 Chunking DITA maps

Next Topic:  27.2.2 Specifying a chunking policy

Parent Topic:  27.2 Chunking DITA maps

Sibling Topics:

27.2.2 Specifying a chunking policy

27.2.3 Providing a page break between title and TOC

27.2.4 Producing a single HTML file that includes generated lists