sidebar
sidebar — A portion of a document that is isolated from the main narrative flow.
Synopsis
- Sequence of:
- One of:
- One or more of:
annotation
bridgehead
remark
revhistory
- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)
- List elements
- Paragraph elements
- Publishing elements
- Synopsis elements
- Technical elements
- Verbatim elements
- One of:
Attributes
Additional Constraints
- sidebar must not occur in the descendants of sidebar
Description
A sidebar
is a short piece of text, rarely
longer than a single column or page, that is presented outside the
narrative flow of the main text.
Sidebars are often used for digressions or interesting observations that are related, but not directly relevant, to the main text.
Processing expectations
Formatted as a displayed block. Sometimes
sidebar
s are boxed or shaded.
DocBook does not specify the location of the
sidebar
within the final displayed flow of text.
The wrapper may float or remain where it is located.
This element occurs in 73 elements.
This element contains 63 elements.
See Also
Examples
1 <article xmlns='http://docbook.org/ns/docbook'> 2 <title>Example sidebar</title> 4 <section><title>An Example Section</title> 6 <para>Some narrative text. </para> 8 <sidebar><title>A Sidebar</title> 10 <para>Sidebar content. </para> 12 </sidebar> 14 <para>The continuing flow of the narrative text, as if the sidebar was not present. 16 </para> 18 </section> 20 </article>