Reference. Reference for the DocBook DTD

[Prev] [Next]


Para

Name

Para---Paragraph

Synopsis

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, and 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, and 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>


[Prev] PageNums
[Next] ParamDef
[Reference Home] [Davenport Group Home]