structure

structure — Describes the structure of a document.

Synopsis

structure ::=

Sequence of:
- Interleave of:
  - Zero or more of:
    output
  - filterin?
  - filterout?
  - info? (db.info)
- merge?
- revhistory?
- One or more of:
  - module

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.


resources		transform