3.16. Creating an Assembly File Manually

3.16. Creating an Assembly File Manually
Prev	Chapter 3. Manipulating DocBook Document Structure	Next

Difficulty: ★☆☆ (easy)

Keywords: topic, assemblies

Problem

You want create topic oriented documents with the assembly element manually.

Solution

In its simplest form, an assembly file contains the following elements:

assembly

The root element of an assembly file. It is bound to the DocBook 5 namespace http://docbook.org/ns/docbook.

resources

Wrapper element for a collection of topics. Each topic is identified by a resource element and its xml:id or fileref attributes:

<resource xml:id="preface" fileref="preface.xml"/>

An assembly file can contain more than one resource elements.

structure

Wrapper element for a document to be assembled. Primarily it contains of modules which refers to a resource elements.

The following example assumes, the files are composed of topic root elements, except for the glossary.xml file (which is comprised by a glossary element).

<assembly version="5.1" xmlns="http://docbook.org/ns/docbook">
  <resources>
    <resource fileref="intro.xml" xml:id="intro"/>
    <resource fileref="kde.xml" xml:id="kde"/>
    <resource fileref="gnome.xml" xml:id="gnome"/>
    <resource fileref="glossary.xml" xml:id=""/>
  </resources>
  <structure xml:id="user-guide">
    <output renderas="book"/>
    <module resourceref="intro"/>
    <module resourceref="kde"/>
    <module resourceref="gnome"/>
    <module resourceref="glossary"/>
  </structure>
</assembly>

Discussion

TDB

Prev	Up	Next
3.15. Assembling Topics	Home	3.17. Using Entities as Placeholders