para — A paragraph
para ::=
info
? (db.titleforbidden.info)abbrev
accel
acronym
address
alt
anchor
annotation
application
author
bibliolist
biblioref
blockquote
bridgehead
calloutlist
caution
citation
citebiblioid
citerefentry
citetitle
classname
classsynopsis
cmdsynopsis
code
command
computeroutput
constant
constraintdef
constructorsynopsis
coref
database
date
destructorsynopsis
editor
email
emphasis
(db.emphasis)envar
epigraph
equation
errorcode
errorname
errortext
errortype
example
exceptionname
fieldsynopsis
figure
filename
firstterm
footnote
footnoteref
foreignphrase
funcsynopsis
function
glosslist
glossterm
guibutton
guiicon
guilabel
guimenu
guimenuitem
guisubmenu
hardware
html:button
html:fieldset
html:input
html:label
html:select
html:textarea
important
indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)initializer
inlineequation
inlinemediaobject
interfacename
itemizedlist
keycap
keycode
keycombo
keysym
link
literal
literallayout
markup
mediaobject
menuchoice
methodname
methodsynopsis
modifier
mousebutton
msgset
nonterminal
note
olink
ooclass
ooexception
oointerface
option
optional
orderedlist
orgname
package
parameter
personname
phrase
(db.phrase)procedure
productionset
productname
productnumber
programlisting
programlistingco
prompt
property
qandaset
quote
remark
replaceable
returnvalue
revhistory
screen
screenco
screenshot
segmentedlist
shortcut
sidebar
simplelist
subscript
superscript
symbol
synopsis
systemitem
table
(db.cals.table)table
(db.html.table)tag
task
termdef
tip
token
trademark
type
uri
userinput
variablelist
varname
warning
wordasword
xref
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.
These elements contain para
: abstract
, ackno
, annotation
, answer
, appendix
, article
, bibliodiv
, bibliography
, bibliolist
, blockquote
, callout
, calloutlist
, caption
(db.caption), caution
, chapter
, colophon
, constraintdef
, dedication
, entry
, epigraph
, example
, figure
, footnote
, formalpara
, glossary
, glossdef
, glossdiv
, glosslist
, html:fieldset
, html:form
, important
, index
, indexdiv
, informalexample
, informalfigure
, itemizedlist
, legalnotice
, listitem
, msgexplan
, msgtext
, note
, orderedlist
, partintro
, personblurb
, preface
, printhistory
, procedure
, qandadiv
, qandaset
, question
, refsect1
, refsect2
, refsect3
, refsection
, refsynopsisdiv
, revdescription
, sect1
, sect2
, sect3
, sect4
, sect5
, section
, setindex
, sidebar
, simplesect
, step
, taskprerequisites
, taskrelated
, tasksummary
, td
, textobject
, th
, tip
, toc
, tocdiv
, variablelist
, warning
.
The following elements occur in para: text, abbrev
, accel
, acronym
, address
, alt
, anchor
, annotation
, application
, author
, bibliolist
, biblioref
, blockquote
, bridgehead
, calloutlist
, caution
, citation
, citebiblioid
, citerefentry
, citetitle
, classname
, classsynopsis
, cmdsynopsis
, code
, command
, computeroutput
, constant
, constraintdef
, constructorsynopsis
, coref
, database
, date
, destructorsynopsis
, editor
, email
, emphasis
(db.emphasis), envar
, epigraph
, equation
, errorcode
, errorname
, errortext
, errortype
, example
, exceptionname
, fieldsynopsis
, figure
, filename
, firstterm
, footnote
, footnoteref
, foreignphrase
, funcsynopsis
, function
, glosslist
, glossterm
, guibutton
, guiicon
, guilabel
, guimenu
, guimenuitem
, guisubmenu
, hardware
, html:button
, html:fieldset
, html:input
, html:label
, html:select
, html:textarea
, important
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), info
(db.titleforbidden.info), informalequation
, informalexample
, informalfigure
, informaltable
(db.cals.informaltable), informaltable
(db.html.informaltable), initializer
, inlineequation
, inlinemediaobject
, interfacename
, itemizedlist
, keycap
, keycode
, keycombo
, keysym
, link
, literal
, literallayout
, markup
, mediaobject
, menuchoice
, methodname
, methodsynopsis
, modifier
, mousebutton
, msgset
, nonterminal
, note
, olink
, ooclass
, ooexception
, oointerface
, option
, optional
, orderedlist
, orgname
, package
, parameter
, personname
, phrase
(db.phrase), procedure
, productionset
, productname
, productnumber
, programlisting
, programlistingco
, prompt
, property
, qandaset
, quote
, remark
, replaceable
, returnvalue
, revhistory
, screen
, screenco
, screenshot
, segmentedlist
, shortcut
, sidebar
, simplelist
, subscript
, superscript
, symbol
, synopsis
, systemitem
, table
(db.cals.table), table
(db.html.table), tag
, task
, termdef
, tip
, token
, trademark
, type
, uri
, userinput
, variablelist
, varname
, warning
, wordasword
, xref
.
An ordinary paragraph.
<article xmlns='http://docbook.org/ns/docbook'> <title>Example para</title> <para>The component suffered from three failings: <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> 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
A formal paragraph.
<article xmlns='http://docbook.org/ns/docbook'> <title>Example para</title> <formalpara><title>A Test</title> <para>This is a test. This is only a test. Had this been a real example, it would have made more sense. </para> </formalpara> </article>
A Test.
This is a test. This is only a test. Had this been a real example, it would have made more sense.
A simple paragraph.
<article xmlns='http://docbook.org/ns/docbook'> <title>Example para</title> <simpara> Just the text, ma'am. </simpara> </article>
Just the text, ma'am.