Whole document tree


www.fifi.org
    Documentation
        Manpages
        GNU Info
        Debian document tree
        Whole document tree
    Trigance web page
    Public services
    User info
    Mailing lists
    Secure server
    Multilingual usage
 

Copyright (C) 2000-2012
Philippe Troin
<webmaster@fifi.org>.

Validate HTML
Validate CSS

    

Whole document tree

Preface
Guide to the DocBook DTD
PrevNext

Preface

Name

Preface -- Introductory textual matter in a Book

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.

NameValue(s)TypeDefault Value
StatusCDATA#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, 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, 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>
PrevHomeNext
PostcodeUpPrimary