The topic.fo file

When you build a PDF from a bookmap or a map using the DITA Open Toolkit’s PDF plugin, one of the first things that happens is that the plugin combines all of the topics in your map into one big XML file named [map name]_MERGED_xml. It then converts that file from the DITA tag set to a different tag set, the XSL-FO tag set. The result of that conversion is a file named topic.fo. This file, topic.fo, is sent to the PDF renderer. topic.fo is useful as a troubleshooting tool. Normally, the Open Toolkit deletes topic.fo after the build is complete, but it’s a good idea to retain it. To set up your ANT build files to retain topic.fo, see Retain the topic.fo file for troubleshooting.

It’s beyond the scope of this book to explain ...