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

Sect1
Guide to the DocBook DTD
PrevNext

Sect1

Name

Sect1 -- Top-level section of a book component, including the Title of that section

Content Model

  (Sect1Info?, (Title, TitleAbbrev?), (ToC | LoT | Index
  | Glossary | Bibliography)*, (((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)+, ((RefEntry)* | Sect2*
  | SimpleSect*)) | (RefEntry)+ | Sect2+ | SimpleSect+)
  , (ToC | LoT | Index | Glossary
  | Bibliography)*)+
  (IndexTerm | BeginPage)

Inclusions

Sect1 includes these elements at every level:

  IndexTerm | BeginPage

Attributes

This element has common and Role attributes.

NameValue(s)TypeDefault Value
LabelCDATA#IMPLIED 
Renderas(Sect2 |Sect3 |Sect4 |Sect5)#IMPLIED 
StatusCDATA#IMPLIED 

Tag Minimization

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

Description

Top-level section of a book component, including the Title of that section. Sect2-5 nest in order within Sect1. Almost anything may occur within a Sect1 except a Preface, Chapter, Appendix, or another Sect1, including a Glossary, Bibliography, RefEntry, ToC, Index, or LoT. A Sect may begin with a SectNInfo element (Sect1Info, Sect2Info ...), it must have a Title, which is the text of the heading itself, and may have a TitleAbbrev; it must include some content, whether paragraphs or other block-oriented elements, including a Sect2. Sect1 has Status, Renderas, Label, and common attributes.

Parents

These elements contain Sect1: Appendix, Article, Chapter, PartIntro, Preface.

Children

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

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

Attributes

Renderas

Renderas indicates the format in which the BridgeHead or the Sect1-5 Title should appear.

Label

Label holds an identifying number or string to be output in some manner when the element it is applied to is rendered.

Status

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

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
SecondaryUpSect1Info