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

para — A paragraph

Synopsis

para ::= (infodb.titleforbidden.info, (text | bridgehead | revhistory | Bibliography inlines | Error inlines | Graphic inlines | GUI inlines | Indexing inlines | Keyboard inlines | Linking inlines | Markup in⁠lines | Math inlines | Object-oriented programming inlines | Operating system inlines | Product in⁠lines | Programming inlines | Publishing inlines | Technical inlines | Ubiquitous inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)*)

Additional constraints

  • If this element is the root element, it must have a version attribute.

Description

A para is a paragraph. Paragraphs in DocBook may contain almost all inlines and most block elements. Sectioning and higher-level structural elements are excluded. DocBook offers two variants of paragraph: simpara, which cannot contain block elements, and formalpara, which has a title.

Some processing systems may find the presence of block elements in a paragraph difficult to handle. On the other hand, it is frequently most logical, from a structural point of view, to include block elements, especially informal block elements, in the paragraphs that describe their content. There is no easy answer to this problem.

Processing expectations

Formatted as a displayed block.

See Also

formalpara, simpara

Examples

An ordinary paragraph: ...

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