para

para — A paragraph.

Synopsis

para ::=

Attributes

Common attributes and common linking attributes.

No additional attributes.

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.

Attributes

Common attributes and common linking attributes.

any attribute

Any attribute in any other explicit namespace

Parents

These elements contain para: abstract, acknowledgements, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption, caution, chapter, colophon, cover, danger, dedication, dialogue, drama, entry, epigraph, example, figure, footnote, formalpara, glossary, glossdef, glossdiv, glosslist, important, index, informalexample, informalfigure, itemizedlist, legalnotice, linegroup, listitem, meta (db.meta.content), note, orderedlist, partintro, personblurb, poetry, preface, printhistory, procedure, qandadiv, qandaset, question, result, revdescription, section, setindex, sidebar, simplesect, stagedir, step, taskprerequisites, taskrelated, tasksummary, textobject, tip, toc, variablelist, warning.

Children

The following elements occur in para: text, abbrev, acronym, address, alt, anchor, author, bibliolist, biblioref, blockquote, bridgehead, calloutlist, caution, citation, citebiblioid, citetitle, coref, danger, date, editor, email, emphasis (db._emphasis), emphasis (db.emphasis), epigraph, equation, example, figure, firstterm (db._firstterm), firstterm (db.firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), foreignphrase (db.foreignphrase), formalgroup, glosslist, glossterm (db._glossterm), glossterm (db.glossterm), important, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), informalequation, informalexample, informalfigure, informaltable, inlineequation, inlinemediaobject, inlinestagedir, itemizedlist, jobtitle, link, literal, literallayout, mediaobject, note, olink, optional, orderedlist, org, orgname, person, personname, phrase (db._phrase), phrase (db.phrase), procedure, productname, productnumber, qandaset, quote (db._quote), quote (db.quote), remark, revhistory, revnumber, sidebar, simplelist, subscript, superscript, table, task, templatename, termdef, tip, trademark, uri, variablelist, warning, wordasword, xref.

See Also

Related elements: formalpara, simpara.

Examples

An ordinary paragraph.

 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |<title>Example para</title>
   | 
   |<para>The component suffered from three failings:
 5 |<itemizedlist>
   |<listitem><para>It was slow</para></listitem>
   |<listitem><para>It ran hot</para></listitem>
   |<listitem><para>It didn't actually work</para></listitem>
   |</itemizedlist>
10 |Of these three, the last was probably the most important.
   |</para>
   | 
   |</article>

The component suffered from three failings:

  • It was slow

  • It ran hot

  • It didn't actually work

Of these three, the last was probably the most important.

A formal paragraph.

 1 |<article xmlns='http://docbook.org/ns/docbook'>
   |<title>Example para</title>
   | 
   |<formalpara><title>A Test</title>
 5 |<para>This is a test.  This is only a test.  Had this been a real
   |example, it would have made more sense.
   |</para>
   |</formalpara>
   | 
10 |</article>

A TestThis 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'>
  |<title>Example para</title>
  | 
  |<simpara>
5 |Just the text, ma'am.
  |</simpara>
  | 
  |</article>

Just the text, ma'am.