assembly

DocBook 5.1: The Definitive Guide (Version 1.5.3 for DocBook 5.1)

V5.1 Assemblyassembly

assembly — Defines the hierarchy and relationships for a collection of resources.

Synopsis

assembly ::=

Sequence of:
- One of:
  - Sequence of:
    Interleave of:
    title?
    titleabbrev?
    subtitle?
    info? (db.titleforbidden.info)
  - info? (db.info)
- One or more of:
  - resources
- Zero or more of:
  - structure
- Zero or more of:
  - relationships
- transforms?

Attributes

Common attributes.

Additional Constraints

If this element is the root element, it must have a version attribute.

Description

An assembly describes how a set of resources are combined together to form a new structure. In topic-oriented authoring scenarios, a set of topics (perhaps, but not necessarily, in topic elements) is used to assemble a structure, a new document composed from those topics.

The assembly imposes a structure on the topics that may never have been conceived by the topic authors.

Processing expectations

An assembly is a container, it is not expected to produce any particular output. When an assembly is processed, one or more of its structure elements is rendered.

Children

The following elements occur in assembly: info (db.info), info (db.titleforbidden.info), relationships, resources, structure, subtitle, title, titleabbrev, transforms.

Examples

FIXME: TBD.