DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

FormalPara

Name

FormalPara -- A paragraph with a title

Synopsis

Content Model

FormalPara ::=
(Title,
 (IndexTerm)*,
 Para)

Attributes

Common attributes

Tag Minimization

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

Parameter Entities

%admon.mix;	%bookcomponent.content;	%component.mix;
%divcomponent.mix;	%example.mix;	%footnote.mix;
%glossdef.mix;	%highlights.mix;	%indexdivcomponent.mix;
%legalnotice.mix;	%para.class;	%qandaset.mix;
%refcomponent.mix;	%sidebar.mix;	%tabentry.mix;
%tbl.entry.mdl;	%textobject.mix;

Description

Formal paragraphs have a title.

Processing expectations

Formatted as a displayed block. The Title of a FormalPara is often rendered as a run-in head.

Parents

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

Children

The following elements occur in FormalPara: IndexTerm, Para, Title.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

In some contexts, the following elements are excluded: IndexTerm.

See Also

Para, SimPara

Examples

<!DOCTYPE formalpara PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<formalpara><title>This Paragraph Has a Title</title>
<para>
This is a test.  This is only a test.  Had this been a real
example, it would have made more sense.  Or less.
</para>
</formalpara>

This Paragraph Has a Title. This is a test. This is only a test. Had this been a real example, it would have made more sense. Or less.

For additional examples, see also Para.

---

Prev	Home	Next
ForeignPhrase	Up	FuncDef

Back to: DocBook: The Definitive Guide