Skip to main content
Version: DocBook V4.5

bridgehead

bridgehead — A free-floating heading

Synopsis

Mixed Content Model

bridgehead ::=
(#PCDATA|footnoteref|xref|biblioref|abbrev|acronym|citation|
citerefentry|citetitle|citebiblioid|emphasis|firstterm|
foreignphrase|glossterm|termdef|footnote|phrase|orgname|quote|
trademark|wordasword|personname|link|olink|ulink|action|
application|classname|methodname|interfacename|exceptionname|
ooclass|oointerface|ooexception|package|command|computeroutput|
database|email|envar|errorcode|errorname|errortype|errortext|
filename|function|guibutton|guiicon|guilabel|guimenu|guimenuitem|
guisubmenu|hardware|interface|keycap|keycode|keycombo|keysym|
literal|code|constant|markup|medialabel|menuchoice|mousebutton|
option|optional|parameter|prompt|property|replaceable|
returnvalue|sgmltag|structfield|structname|symbol|systemitem|uri|
token|type|userinput|varname|nonterminal|anchor|author|
authorinitials|corpauthor|corpcredit|modespec|othercredit|
productname|productnumber|revhistory|remark|subscript|
superscript|inlinegraphic|inlinemediaobject|inlineequation|
indexterm)*

Attributes

Common attributes

Name

Type

Default

renderas

Enumeration:

other

sect1

sect2

sect3

sect4

sect5

None

Description

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

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

Future Changes

The InterfaceDefinition element will be discarded in DocBook V4.0. It will no longer be available in the content model of this element.

Attributes

renderas

The RenderAs attribute identifies how the BridgeHead should be rendered. In this way, a BridgeHead can be made to appear as a Sect1, for example.

Examples

For examples, see chapter.