[Prev] [Next]

2.2 Paragraphs and Text Blocks

Paragraphs

DocBook has three kinds of paragraph, regular, simple, and formal:

• The regular Para element may contain %para.char.mix; inline elements and #PCDATA, along with the object-level elements in %para.mix;. For example, a Para may contain an ItemizedList.

• The SimPara element contains only %para.char.mix; inline elements and #PCDATA; it may not contain object-level elements such as lists.

• The FormalPara element requires a Title and contains a single Para element.

Abstract and Highlights

An Abstract briefly describes the purpose of a document. A Highlights element provides highlights to help a reader navigate the material within a Book component.

An Abstract contains an optional Title, followed by one or more of the paragraph elements in %para.class;.

A Highlights element contains one or more object-level elements from the %highlights.mix; mixture.

AuthorBlurb

An AuthorBlurb briefly describes the author of a document. It contains an optional Title, followed by one or more paragraph elements from %para.class;.

BlockQuote and Epigraph

A BlockQuote is an extended, set-off excerpt from another document. An Epigraph is a brief text, typically a quotation, that is somehow relevant to a document's content and is set at the beginning of the document. Both may contain an Attribution element for attribution of the source of their content.

BlockQuote contains an optional Title, an optional Attribution, and one or more object-level elements from the %component.mix; mixture.

Epigraph contains an optional Attribution and one or more paragraph elements from %para.class;.

[Prev] Terms and Concepts
[Next] Admonitions and Sidebars
[User's Guide Home] [Davenport Group Home]