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

V5.1 Assemblystructure

structure — Describes the structure of a document.

Synopsis

structure ::=

Attributes

Common attributes.

Additional attributes:

  • defaultformat (NMTOKEN)
  • renderas (QName)
  • resourceref (IDREF)
  • type (NMTOKEN)

Additional Constraints

  • The renderas attribute can be specified on either the structure or output, but not both.

Description

A structure is the top-level unit of an assembly. A structure represents the book, help system, web site, or other artifact to be produced by assembling modules, which are further composed of resources.

Processing expectations

A structure is rendered by assembling the modules that it contains into a new, assembled document.

Common attributes on the structure element are generally copied onto the output root element.

Attributes

Common attributes.

defaultformat

Identifies the default format of the structure

renderas

Specifies the DocBook element to which this unit should be renamed

resourceref

Indicates a single resource from which to construct this structure

type

Identifies the structure type of the structure

Parents

These elements contain structure: assembly.

Children

The following elements occur in structure: filterin, filterout, info (db.info), merge, module, output, revhistory.

Examples

FIXME: TBD.