O'Reilly logo

DocBook 5: The Definitive Guide by Richard L. Hamilton, Norman Walsh

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

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 ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required