DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

bridgehead

bridgehead — A free-floating heading.

Synopsis

bridgehead ::= [-]

Attributes

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.

Bridge heads are not numbered, even when they are rendered as headings that are otherwise numbered.

Attributes

Common attributes and common linking attributes.

otherrenderas

Identifies the nature of the non-standard 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 a fifth-level section

Children

The following elements occur in bridgehead: text, abbrev, acronym, alt, anchor, author, biblioref, citation, citebiblioid, citetitle, coref, date, editor, email, emphasis (db._emphasis), emphasis (db.emphasis), firstterm (db._firstterm), firstterm (db.firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), foreignphrase (db.foreignphrase), glossterm (db._glossterm), glossterm (db.glossterm), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlineequation, inlinemediaobject, jobtitle, link, literal, olink, optional, org, orgname, person, personname, phrase (db._phrase), phrase (db.phrase), productname, productnumber, quote (db._quote), quote (db.quote), remark, subscript, superscript, termdef, trademark, uri, wordasword, xref.