para
para — A paragraph.
Synopsis
- Sequence of:
info
? (db.titleforbidden.info)- Zero or more of:
- 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
alt
anchor
annotation
biblioref
indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)inlinemediaobject
link
olink
remark
subscript
superscript
xref
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)
- List elements
- Publishing elements
- Synopsis elements
- Technical elements
- Verbatim elements
Attributes
Additional Constraints
- The root element 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
Examples
An ordinary paragraph.
1 <article xmlns='http://docbook.org/ns/docbook'> 2 <title>Example para</title> 4 <para>The component suffered from three failings: <itemizedlist> 6 <listitem><para>It was slow</para></listitem> <listitem><para>It ran hot</para></listitem> 8 <listitem><para>It didn't actually work</para></listitem> </itemizedlist> 10 Of these three, the last was probably the most important. </para> 12 </article>
The component suffered from three failings:
It was slow
It ran hot
It didn't actually work
A formal paragraph.
1 <article xmlns='http://docbook.org/ns/docbook'> 2 <title>Example para</title> 4 <formalpara><title>A Test</title> <para>This is a test. This is only a test. Had this been a real 6 example, it would have made more sense. </para> 8 </formalpara> 10 </article>
This is a test. This is only a test. Had this been a real example, it would have made more sense.
A simple paragraph.
1 <article xmlns='http://docbook.org/ns/docbook'> 2 <title>Example para</title> 4 <simpara> Just the text, ma'am. 6 </simpara> 8 </article>
Just the text, ma'am.