DocBook Topic (5.1 and Later)
The DocBook Topic document type was introduced with DocBook 5.1 and it is used as a modular unit of documentation. It is similar to the concept of the DITA Topic and can be used as modular resources in conjunction with DocBook Assembly documents.
For detailed information about the DocBook Topic document type, see The Definitive Guide - DocBook Topic.
File Definition
A DocBook file is considered to be a Topic when the root name is
topic
.
Default Document Templates
A default Topic document template is available when creating new documents from templates and it can be found in: .
The default template for DocBook Assembly documents is located in the [OXYGEN_INSTALL_DIR]/frameworks/docbook/templates/Docbook5.1 folder.
Default Schema for Validation and Content Completion
The default schema that is used if one is not detected is docbookxi.rng and it is stored in [OXYGEN_INSTALL_DIR]/frameworks/docbook/5.1/rng/.
Transformation Scenarios
Since DocBook Topics are modular resources, they are assembled and transformed in the DocBook Assembly transformation process. You can also use any of the built-in DocBook transformation scenarios to transform individual DocBook Topics to a variety of outputs, such as PDF, HTML, EPUB, and more. They are found in the DocBook 5 section in the Configure Transformation Scenario(s) dialog box.
Resources
- The Definitive Guide - DocBook Topic
- DocBook Specifications
- Sample files: [OXYGEN_INSTALL_DIR]/samples/docbook/v5/assembly/