The DocBook Assembly document type was introduced with DocBook 5.1 and it is used to define the hierarchy and relationships for a collection of resources. It is especially helpful for topic-oriented authoring scenarios since it assembles a set of resources (such as DocBook 5.1 topics) to form a hierarchical structure for a larger publication.
<structure> element, an <output> element can be
used to identify the type of output to be generated and <module> elements
can be used to identify the resources to be included. An Assembly may identify one
or more structures.For detailed information about the DocBook Assembly document type, see The Definitive Guide - DocBook Assemblies.
A file is considered to be an Assembly when the root name is
assembly.
A default Assembly 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.
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/.
Oxygen XML Author Eclipse plugin includes a built-in transformation scenario that can be applied on an Assembly file to generate an assembled (merged) DocBook file. The scenario is called DocBook Assembly and is found in the DocBook 5 section in the Configure Transformation Scenario(s) dialog box.