|DITA map files / DITA map vocabulary|
The chunk attribute can control the way output files are generated during the publishing process. Most chunk attribute values apply only to composite topics, which should be avoided. The to-content value is used to generate a single output topic from multiple DITA source topics.
The ditamap's topicref element includes a chunk attribute that can be used to aggregate source DITA topics during processing to a deliverable document.
Setting the chunk attribute effectively overrides the default processing of the publishing tool. As well as specifying that multiple DITA topics be generated as single output topics, the chunk attribute can also be used to specify that single DITA topics be split on output into multiple output topics.
The chunk attribute is also available on the map element; values set will apply to all the topics in the ditamap.
The chunk attribute is only ever applied to a parent node topicref element or a map element, and its value applies to the parent and its child topics.
The chunk attribute has up to three parts, or tokens, each separated by a space. For example, an attribute coded as chunk="select-topic to-content" has two tokens; select-topic and to-content.
<topicref href="c_safety.dita" chunk="to-content"> <topicref href="c_electronic_brake_force_distribution.dita" /> <topicref href="t_child_restraint.dita" /> <topicref href="c_other_restraint_systems.dita" /> </topicref>will be output as one single HTML topic, with a file name of c_safety.html.