V5.1 Assemblyassembly

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

Synopsis

assembly ::=

Attributes

Common attributes.

No additional 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.

Attributes

Common attributes.

any attribute

Any attribute in any other explicit namespace

Children

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

Examples

See Chapter 6, DocBook Assemblies.