Chunk Attribute

Chunk your content to control how topics appear on a page when published.

When you specify a chunking attribute value, it overrides the default chunking behavior, which is to show each topic on its own page. For example, if you have a parent topic with several children, you can use the chunking attribute to specify if the topics appear on a single page or separate pages when publishing to HTML.

Here's an example map with some hierarchy:

example map with a parent topic and two child topics

When you publish this map with no chunking attribute applied, the parent topic shows on the page with links to each of the child topics. The following HTML example highlights this behavior.

example PDF output of a map with a parent topic and two child topics

When you publish this map with the to-content value for the chunking attribute, the parent topic and each of it's children show on the same page. The following PDF example highlights this behavior.

example PDF output with a parent topic and two child topics, but with the chunking attribute applied

You can apply a chunk attribute to a single topic or to a map. When you apply a chunk attribute to a topic, the chunking behavior applies only to the topic and any children of that topic. When you apply a chunk attribute to a map, the chunking behavior is established for the entire map.

Here are the chunk attributes in DITA:

AttributeBehavior
by-topic Produces a separate output chunk for the target topic and each of its descendants.
by-document Produces a single output chunk for the referenced document.
select-topic Selects an individual topic.
select-document Selects the topic and any other topics in the document.
select-branch Selects an individual topic and any nested topics.
to-content Generates a single document containing an individual topic and any nested topics.
to-navigation Generates a new chunk of navigation, such as a Table of Contents.