Users can enable section-by-section navigation based on DITA chunking by using the following attribute:
chunk="to-content"
Users must then create a Pagination rule set to Content-driven pagination.
Example:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">
<map>
<title>Chocolate Cake Recipe</title>
<topicref href="t_ingredients.dita">
<topicref href="t_chocolates.dita" chunk="to-content">
<topicref href="t_milk_chocolate.dita"/>
<topicref href="t_chocolate_powder.dita"/>
</topicref>
<topicref href="t_flour.dita"/>
<topicref href="t_sugar.dita"/>
<topicref href="t_butter.dita"/>
</topicref>
<topicref href="t_recipe.dita">
<topicref href="t_preheat_the_oven.dita"/>
<topicref href="t_cook.dita"/>
</topicref>
</map>
Since the <topicref> for the topic t_chocolates.dita includes the chunk="to-content" attribute, it is the first topic of a page including the content of t_milk_chocolate.dita and t_chocolates_powder.dita.
Users can still bookmark t_milk_chocolate.dita and t_chocolates_powder.dita, or add the topics to a personal book.
All other topics appear in their own page.
To fully merge these chunks together in a single t_chocolates.dita topic, it is necessary to add the outputclass="ft-merge" attribute. See Merge DITA topics.