DocBook 5: The Definitive Guide

Name

bridgehead — A free-floating heading

Synopsis

bridgehead ::= (text | Bibliography inlines | Error inlines | Graphic inlines | GUI inlines | Indexing inlines | Keyboard inlines | Linking inlines | Markup inlines | Math inlines | Object-oriented programming inlines | Operating system inlines | Product inlines | Programming inlines | Publishing inlines | Technical inlines | Ubiquitous inlines)*

Attribute synopsis

Common attributes and common linking attributes.

Additional attributes:

• At most one of:

  • renderas (enumeration) = “sect1” | “sect2” | “sect3” | “sect4” | “sect5”

  • All or none of:

    • renderas (enumeration) = “other”

    • otherrenderas (NMTOKEN)

Description

Some documents, usually legacy documents, use headings that are not tied to the normal sectional hierarchy. These headings may be represented in DocBook with the bridgehead element.

A bridgehead may also be useful in fiction or journalistic works that don’t have a nested hierarchy.

Processing expectations

A bridgehead is formatted as a block, using the same display properties as the section heading which it masquerades as. The renderas attribute controls which heading it mimics.

Attributes

Common attributes and common linking attributes.

otherrenderas

Identifies the nature of the nonstandard rendering

renderas

Indicates how the bridge head should be rendered

Enumerated values:
“sect1”	Render as a first-level section.
“sect2”	Render as a second-level section.
“sect3”	Render as a third-level section.
“sect4”	Render as a fourth-level section.
“sect5”	Render as ...