Guide to the DocBook DTD
PrevNext

Para

Name

Para — Paragraph

Content Model

  (#PCDATA | FootnoteRef | XRef | Abbrev | Acronym | Citation
  | CiteRefEntry | CiteTitle | Emphasis | FirstTerm
  | ForeignPhrase | GlossTerm | Footnote | Phrase | Quote
  | Trademark | WordAsWord | Link | OLink | ULink | Action
  | Application | ClassName | Command | ComputerOutput
  | Database | Email | EnVar | ErrorCode | ErrorName
  | ErrorType | Filename | Function | GUIButton | GUIIcon
  | GUILabel | GUIMenu | GUIMenuItem | GUISubmenu | Hardware
  | Interface | InterfaceDefinition | KeyCap | KeyCode
  | KeyCombo | KeySym | Literal | Markup | MediaLabel
  | MenuChoice | MouseButton | MsgText | Option | Optional
  | Parameter | Prompt | Property | Replaceable | ReturnValue
  | SGMLTag | StructField | StructName | Symbol | SystemItem
  | Token | Type | UserInput | Anchor | Author | AuthorInitials
  | CorpAuthor | ModeSpec | OtherCredit | ProductName
  | ProductNumber | RevHistory | Comment | Subscript
  | Superscript | InlineGraphic | InlineEquation | Synopsis
  | CmdSynopsis | FuncSynopsis | CalloutList | GlossList
  | ItemizedList | OrderedList | SegmentedList | SimpleList
  | VariableList | Caution | Important | Note | Tip | Warning
  | LiteralLayout | ProgramListing | ProgramListingCO
  | Screen | ScreenCO | ScreenShot | Address | BlockQuote
  | Graphic | GraphicCO | InformalEquation
  | InformalExample | InformalTable | Equation | Example
  | Figure
  | Table)+

Attributes

This element has common and Role attributes.

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Description

Para is simply a paragraph. A Para may not have a Title: to attach a Title to a Para use FormalPara. Para may contain any in-line element and almost any block-oriented element. Abstract, AuthorBlurb, Caution, Important, Note, and Warning are excluded, as are Sects and higher-level elements. Para has common attributes. See also FormalPara and SimPara.

Parents

These elements contain Para: Abstract, Appendix, Article, AuthorBlurb, BiblioDiv, Bibliography, BlockQuote, Callout, Caution, Chapter, Dedication, Epigraph, Example, Footnote, FormalPara, GlossDef, GlossDiv, Glossary, Highlights, Important, Index, IndexDiv, InformalExample, LegalNotice, ListItem, MsgExplan, MsgText, Note, PartIntro, Preface, PrintHistory, Procedure, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, SetIndex, Sidebar, SimpleSect, Step, Tip, Warning, entry.

Children

Para contains these elements: Abbrev, Acronym, Action, Address, Anchor, Application, Author, AuthorInitials, BlockQuote, CalloutList, Caution, Citation, CiteRefEntry, CiteTitle, ClassName, CmdSynopsis, Command, Comment, ComputerOutput, CorpAuthor, Database, Email, Emphasis, EnVar, Equation, ErrorCode, ErrorName, ErrorType, Example, Figure, Filename, FirstTerm, Footnote, FootnoteRef, ForeignPhrase, FuncSynopsis, Function, GUIButton, GUIIcon, GUILabel, GUIMenu, GUIMenuItem, GUISubmenu, GlossList, GlossTerm, Graphic, GraphicCO, Hardware, Important, InformalEquation, InformalExample, InformalTable, InlineEquation, InlineGraphic, Interface, InterfaceDefinition, ItemizedList, KeyCap, KeyCode, KeyCombo, KeySym, Link, Literal, LiteralLayout, Markup, MediaLabel, MenuChoice, ModeSpec, MouseButton, MsgText, Note, OLink, Option, Optional, OrderedList, OtherCredit, #PCDATA, Parameter, Phrase, ProductName, ProductNumber, ProgramListing, ProgramListingCO, Prompt, Property, Quote, Replaceable, ReturnValue, RevHistory, SGMLTag, Screen, ScreenCO, ScreenShot, SegmentedList, SimpleList, StructField, StructName, Subscript, Superscript, Symbol, Synopsis, SystemItem, Table, Tip, Token, Trademark, Type, ULink, UserInput, VariableList, Warning, WordAsWord, XRef.

In some contexts, additional elements may be allowed by inclusions in parent elements. Similarly, in some contexts, some of these elements may be invalid due to exclusions in parent elements.

Examples

<CHAPTER LABEL="II">
<TITLE>A Chapter Devoted to Hierarchy</TITLE>
<TITLEABBREV>Hierarchy</TITLEABBREV>
<TOCCHAP>
<TOCENTRY>Hierarchy</TOCENTRY>
<TOCLEVEL1>
<TOCENTRY>Lonely at the Top</TOCENTRY>
</TOCLEVEL1>
<TOCLEVEL1>
<TOCENTRY>A Gravid Section</TOCENTRY>
</TOCLEVEL1>
</TOCCHAP>
<EPIGRAPH>
<ATTRIBUTION>Benjamin Franklin</ATTRIBUTION>
<PARA>In going on with these experiments, how many pretty systems do we build,
which we soon find ourselves obliged to destroy?</PARA>
</EPIGRAPH>
<HIGHLIGHTS>
<SIMPLELIST>
<MEMBER>Best of the Top</MEMBER>
<MEMBER>Best of the Middle</MEMBER>
<MEMBER>Best of the Bottom</MEMBER>
</SIMPLELIST>
</HIGHLIGHTS>
<SECT1
<TITLE>Lonely at the Top</TITLE>
<FORMALPARA>
<TITLE>A Formal Paragraph</TITLE>
<PARA>A short paragraph, but a formal one.</PARA>
</FORMALPARA>
<SIMPLESECT>
<TITLE>Don't Delve Deeper</TITLE>
<PARA>SimpleSects can't contain other Sects.
</PARA>
</SIMPLESECT>
</SECT1>
<SECT1>
<TITLE>A Gravid Section</TITLE>
<PARA>A short paragraph.</PARA>
<SECT2>
<TITLE>Under the Forest Canopy</TITLE>
<GLOSSARY>
<GLOSSENTRY>
<GLOSSTERM>fum
</GLOSSTERM>
<GLOSSDEF><PARA>Syllable following "fee, fie, fo"</PARA>
</GLOSSDEF>
</GLOSSENTRY>
</GLOSSARY>
<SIMPARA>A short, simple paragraph that can't contain
blocklike objects.</SIMPARA>
<BRIDGEHEAD RENDERAS="sect4">Down to Brass Tacks</BRIDGEHEAD>
<PARA>A short paragraph.</PARA>
<BRIDGEHEAD RENDERAS="sect4">Brass Tacks and Brass Tasks</BRIDGEHEAD>
<PARA>A short paragraph.</PARA>
<SECT3>
<TITLE>Delving Deeper</TITLE>
<PARA>A short paragraph.</PARA>
<SECT4>
<TITLE>We Like Short Sections</TITLE>
<PARA>A short paragraph.</PARA>
<SIDEBAR>
<TITLE>Feeling Out of the Flow?</TITLE>
<PARA>That's because you're in a Sidebar.</PARA>
</SIDEBAR>
<SECT5 RENDERAS="sect4">
<TITLE>Some Writers are Compulsive</TITLE>
<PARA>A short paragraph.</PARA>
</SECT5>
</SECT4>
</SECT3>
</SECT2>
</SECT1>
<BIBLIOGRAPHY>
<BIBLIOENTRY>
<BOOKBIBLIO>
<TITLE>Recursive Tooth Exercises
</TITLE>
<AUTHORGROUP>
<CORPAUTHOR>The Incisor Group
</CORPAUTHOR>
</AUTHORGROUP>
</BOOKBIBLIO>
</BIBLIOENTRY>
</BIBLIOGRAPHY>
<INDEX></INDEX>
</CHAPTER>

PrevHomeNext
PageNumsUpParamDef