Name
para — A paragraph
Synopsis
para ::=
(info? db.titleforbidden.info, (text |
bridgehead | revhistory |
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 | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)*)
Attribute synopsis
Additional constraints
If this element is the root element, it must have a
versionattribute.
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: ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access