![[5.1 Assembly]](figs/web/rev_5.1_assembly.png)
assembly
assembly — Defines the hierarchy and relationships for a collection of resources.
Synopsis
assembly ::=
- Sequence of:
- One of:
- One or more of:
- Zero or more of:
- Zero or more of:
transforms?
- One of:
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.