Reference. Reference for the DocBook DTD

[Prev] [Next]


Preface

Name

Preface---Introductory textual matter in a Book

Synopsis

Content Model
  ((DocInfo?, Title, TitleAbbrev?), (((CalloutList
  | GlossList | ItemizedList | OrderedList | SegmentedList
  | SimpleList | VariableList | Caution | Important | Note
  | Tip | Warning | LiteralLayout | ProgramListing
  | ProgramListingCO | Screen | ScreenCO | ScreenShot
  | Synopsis | CmdSynopsis | FuncSynopsis | FormalPara | Para
  | SimPara | Address | BlockQuote | Graphic | GraphicCO
  | InformalEquation | InformalExample | InformalTable
  | Equation | Example | Figure | Table | MsgSet | Procedure
  | Sidebar | Anchor | BridgeHead | Comment | Highlights
  | Abstract | AuthorBlurb | Epigraph)+, (Sect1*
  | (RefEntry)* | SimpleSect*)) | (Sect1+ | (RefEntry)+
  | SimpleSect+)))+
  (IndexTerm | BeginPage)

Inclusions

Preface includes these elements at every level:

  IndexTerm | BeginPage

Attributes

This element has common and Role attributes.

Name Value(s) Type Default Value
Status CDATA #IMPLIED  

Tag Minimization

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

Description

Introductory textual matter in a Book. Preface may occur more than once in Book, before any Chapter, Part, or Reference: for example, you might have two Prefaces, one titled "Preface" and the other "Introduction." Preface may begin with a DocInfo, followed by a required Title, optional TitleAbbrev, and anything found in the body of a Chapter. Preface has Status and common attributes.

Parents

These elements contain Preface: Book, and Part.

Children

Preface contains these elements: Abstract, Address, Anchor, AuthorBlurb, BeginPage, BlockQuote, BridgeHead, CalloutList, Caution, CmdSynopsis, Comment, DocInfo, Epigraph, Equation, Example, Figure, FormalPara, FuncSynopsis, GlossList, Graphic, GraphicCO, Highlights, Important, IndexTerm, InformalEquation, InformalExample, InformalTable, ItemizedList, LiteralLayout, MsgSet, Note, OrderedList, Para, Procedure, ProgramListing, ProgramListingCO, RefEntry, Screen, ScreenCO, ScreenShot, Sect1, SegmentedList, Sidebar, SimPara, SimpleList, SimpleSect, Synopsis, Table, Tip, Title, TitleAbbrev, VariableList, and Warning.

In some contexts, additional elements may be allowed by inclusions in parent elements.

Attributes

Status

Editorial or publication status ofthe element it applies to, such as "in review" or "approved for distribution." There is no default.

Examples

<BOOK>
<TITLE>My Short SGML Book</TITLE>
<BOOKINFO>
<BOOKBIBLIO>
<AUTHORGROUP>
<AUTHOR>
<FIRSTNAME>George</FIRSTNAME>
<SURNAME>Tirebiter</SURNAME>
</AUTHOR>
</AUTHORGROUP>
</BOOKBIBLIO>
</BOOKINFO>
<TOC></TOC>
<LOT></LOT>
<PREFACE>
<TITLE>Introduction</TITLE>
<PARA>Short paragraph.
</PARA>
</PREFACE>
<PART>
<TITLE>This Part Is First</TITLE>
<PARTINTRO>
<TITLE>Introducing This Part</TITLE>
<PARA>This Part is like no other Part.</PARA>
</PARTINTRO>
<CHAPTER>
<TITLE>A Chapter</TITLE>
<PARA>Short paragraph.
</PARA>
</CHAPTER>
<CHAPTER>
<TITLE>Another Chapter</TITLE>
<PARA>Short paragraph.
</PARA>
</CHAPTER>
</PART>
<PART>
<TITLE>This Part Is Second</TITLE>
<CHAPTER>
<TITLE>Yet Another Chapter</TITLE>
<PARA>Short paragraph.
</PARA>
</CHAPTER>
<CHAPTER>
<TITLE>Still Yet Another Chapter</TITLE>
<PARA>Short paragraph.
</PARA>
</CHAPTER>
</PART>
<APPENDIX LABEL="A">
<TITLE>One Appendix</TITLE>
<PARA>Short paragraph.
</PARA>
</APPENDIX>
<APPENDIX LABEL="B">
<TITLE>The Other Appendix</TITLE>
<PARA>Short paragraph.
</PARA>
</APPENDIX>
<GLOSSARY>
<GLOSSENTRY>
<GLOSSTERM>fum</GLOSSTERM>
<GLOSSDEF>
<PARA>Syllable following "fee, fie, fo"</PARA>
</GLOSSDEF>
</GLOSSENTRY>
</GLOSSARY>
<BIBLIOGRAPHY>
<BIBLIOENTRY>
<BOOKBIBLIO>
<TITLE>Recursive Tooth Exercises
</TITLE>
<AUTHORGROUP>
<AUTHOR>
<FIRSTNAME>George</FIRSTNAME>
<SURNAME>Tirebiter</SURNAME>
</AUTHOR>
</AUTHORGROUP>
</BOOKBIBLIO>
</BIBLIOENTRY>
</BIBLIOGRAPHY>
<INDEX></INDEX>
</BOOK>


[Prev] Postcode
[Next] Primary
[Reference Home] [Davenport Group Home]