docbook:section

Element Information

Model

(docbook:title | docbook:titleabbrev | docbook:subtitle) , docbook:info{0,1} , (((docbook:itemizedlist | docbook:orderedlist | docbook:procedure | docbook:simplelist | docbook:variablelist | docbook:segmentedlist | docbook:glosslist | docbook:bibliolist | docbook:calloutlist | docbook:qandaset | docbook:example | docbook:figure | docbook:table | docbook:equation | docbook:informalexample | docbook:informalfigure | docbook:informaltable | docbook:informalequation | docbook:sidebar | docbook:blockquote | docbook:address | docbook:epigraph | docbook:mediaobject | docbook:screenshot | docbook:task | docbook:productionset | docbook:constraintdef | docbook:msgset | docbook:screen | docbook:literallayout | docbook:programlistingco | docbook:screenco | docbook:programlisting | docbook:synopsis | docbook:bridgehead | docbook:remark | docbook:revhistory | docbook:indexterm | docbook:funcsynopsis | docbook:classsynopsis | docbook:methodsynopsis | docbook:constructorsynopsis | docbook:destructorsynopsis | docbook:fieldsynopsis | docbook:cmdsynopsis | docbook:caution | docbook:important | docbook:note | docbook:tip | docbook:warning | docbook:anchor | docbook:para | docbook:formalpara | docbook:simpara | docbook:annotation) , ((docbook:section+ , docbook:simplesect*) | docbook:simplesect+ | docbook:refentry+)) | (docbook:section+ , docbook:simplesect*) | docbook:simplesect+ | docbook:refentry+) , (docbook:glossary | docbook:bibliography | docbook:index | docbook:toc)
Children: docbook:address, docbook:anchor, docbook:annotation, docbook:bibliography, docbook:bibliolist, docbook:blockquote, docbook:bridgehead, docbook:calloutlist, docbook:caution, docbook:classsynopsis, docbook:cmdsynopsis, docbook:constraintdef, docbook:constructorsynopsis, docbook:destructorsynopsis, docbook:epigraph, docbook:equation, docbook:example, docbook:fieldsynopsis, docbook:figure, docbook:formalpara, docbook:funcsynopsis, docbook:glossary, docbook:glosslist, docbook:important, docbook:index, docbook:indexterm, docbook:info, docbook:informalequation, docbook:informalexample, docbook:informalfigure, docbook:informaltable, docbook:itemizedlist, docbook:literallayout, docbook:mediaobject, docbook:methodsynopsis, docbook:msgset, docbook:note, docbook:orderedlist, docbook:para, docbook:procedure, docbook:productionset, docbook:programlisting, docbook:programlistingco, docbook:qandaset, docbook:refentry, docbook:remark, docbook:revhistory, docbook:screen, docbook:screenco, docbook:screenshot, docbook:section, docbook:segmentedlist, docbook:sidebar, docbook:simpara, docbook:simplelist, docbook:simplesect, docbook:subtitle, docbook:synopsis, docbook:table, docbook:task, docbook:tip, docbook:title, docbook:titleabbrev, docbook:toc, docbook:variablelist, docbook:warning

Attributes

QName Type Fixed Default Use Inheritable Annotation
annotations optional
arch optional
audience optional
condition optional
conformance optional
dir restriction of xs:token optional
label optional
linkend xs:IDREF optional
os optional
remap optional
revision optional
revisionflag restriction of xs:token optional
role optional
security optional
status optional
userlevel optional
vendor optional
version optional
wordsize optional
xlink:actuate xlink:actuateType optional
xlink:arcrole xlink:arcroleType optional
xlink:href xlink:hrefType optional
xlink:role xlink:roleType optional
xlink:show xlink:showType optional
xlink:title xlink:titleAttrType optional
xlink:type xlink:typeType optional
xml:base xs:anyURI optional 
See http://www.w3.org/TR/xmlbase/ for
information about this attribute.
xml:id xs:ID optional 
See http://www.w3.org/TR/xml-id/ for
information about this attribute.
xml:lang union of(xs:language, restriction of xs:string) optional 
Attempting to install the relevant ISO 2- and 3-letter
         codes as the enumerated possible values is probably never
         going to be a realistic possibility.  See
         RFC 3066 at http://www.ietf.org/rfc/rfc3066.txt and the IANA registry
         at http://www.iana.org/assignments/lang-tag-apps.htm for
         further information.

         The union allows for the 'un-declaration' of xml:lang with
         the empty string.
xreflabel optional

Used By

Elements docbook:appendix, docbook:article, docbook:chapter, docbook:partintro, docbook:preface, docbook:section

Source 

<xs:element name="section">
  <xs:complexType>
    <xs:sequence>
      <xs:sequence>
        <xs:choice minOccurs="0" maxOccurs="unbounded">
          <xs:element ref="docbook:title"/>
          <xs:element ref="docbook:titleabbrev"/>
          <xs:element ref="docbook:subtitle"/>
        </xs:choice>
        <xs:element minOccurs="0" ref="docbook:info"/>
      </xs:sequence>
      <xs:choice>
        <xs:sequence>
          <xs:choice maxOccurs="unbounded">
            <xs:element ref="docbook:itemizedlist"/>
            <xs:element ref="docbook:orderedlist"/>
            <xs:element ref="docbook:procedure"/>
            <xs:element ref="docbook:simplelist"/>
            <xs:element ref="docbook:variablelist"/>
            <xs:element ref="docbook:segmentedlist"/>
            <xs:element ref="docbook:glosslist"/>
            <xs:element ref="docbook:bibliolist"/>
            <xs:element ref="docbook:calloutlist"/>
            <xs:element ref="docbook:qandaset"/>
            <xs:element ref="docbook:example"/>
            <xs:element ref="docbook:figure"/>
            <xs:element ref="docbook:table"/>
            <xs:element ref="docbook:equation"/>
            <xs:element ref="docbook:informalexample"/>
            <xs:element ref="docbook:informalfigure"/>
            <xs:element ref="docbook:informaltable"/>
            <xs:element ref="docbook:informalequation"/>
            <xs:element ref="docbook:sidebar"/>
            <xs:element ref="docbook:blockquote"/>
            <xs:element ref="docbook:address"/>
            <xs:element ref="docbook:epigraph"/>
            <xs:element ref="docbook:mediaobject"/>
            <xs:element ref="docbook:screenshot"/>
            <xs:element ref="docbook:task"/>
            <xs:element ref="docbook:productionset"/>
            <xs:element ref="docbook:constraintdef"/>
            <xs:element ref="docbook:msgset"/>
            <xs:element ref="docbook:screen"/>
            <xs:element ref="docbook:literallayout"/>
            <xs:element ref="docbook:programlistingco"/>
            <xs:element ref="docbook:screenco"/>
            <xs:element ref="docbook:programlisting"/>
            <xs:element ref="docbook:synopsis"/>
            <xs:element ref="docbook:bridgehead"/>
            <xs:element ref="docbook:remark"/>
            <xs:element ref="docbook:revhistory"/>
            <xs:element ref="docbook:indexterm"/>
            <xs:element ref="docbook:funcsynopsis"/>
            <xs:element ref="docbook:classsynopsis"/>
            <xs:element ref="docbook:methodsynopsis"/>
            <xs:element ref="docbook:constructorsynopsis"/>
            <xs:element ref="docbook:destructorsynopsis"/>
            <xs:element ref="docbook:fieldsynopsis"/>
            <xs:element ref="docbook:cmdsynopsis"/>
            <xs:element ref="docbook:caution"/>
            <xs:element ref="docbook:important"/>
            <xs:element ref="docbook:note"/>
            <xs:element ref="docbook:tip"/>
            <xs:element ref="docbook:warning"/>
            <xs:element ref="docbook:anchor"/>
            <xs:element ref="docbook:para"/>
            <xs:element ref="docbook:formalpara"/>
            <xs:element ref="docbook:simpara"/>
            <xs:element ref="docbook:annotation"/>
          </xs:choice>
          <xs:choice minOccurs="0">
            <xs:sequence>
              <xs:element maxOccurs="unbounded" ref="docbook:section"/>
              <xs:element minOccurs="0" maxOccurs="unbounded" ref="docbook:simplesect"/>
            </xs:sequence>
            <xs:element maxOccurs="unbounded" ref="docbook:simplesect"/>
            <xs:element maxOccurs="unbounded" ref="docbook:refentry"/>
          </xs:choice>
        </xs:sequence>
        <xs:sequence>
          <xs:element maxOccurs="unbounded" ref="docbook:section"/>
          <xs:element minOccurs="0" maxOccurs="unbounded" ref="docbook:simplesect"/>
        </xs:sequence>
        <xs:element maxOccurs="unbounded" ref="docbook:simplesect"/>
        <xs:element maxOccurs="unbounded" ref="docbook:refentry"/>
      </xs:choice>
      <xs:choice minOccurs="0" maxOccurs="unbounded">
        <xs:element ref="docbook:glossary"/>
        <xs:element ref="docbook:bibliography"/>
        <xs:element ref="docbook:index"/>
        <xs:element ref="docbook:toc"/>
      </xs:choice>
    </xs:sequence>
    <xs:attribute name="role"/>
    <xs:attributeGroup ref="docbook:db.common.attributes"/>
    <xs:attributeGroup ref="docbook:db.common.linking.attributes"/>
    <xs:attribute name="label"/>
    <xs:attribute name="status"/>
  </xs:complexType>
</xs:element>

Sample

< section xmlns = "http://docbook.org/ns/docbook" xml:id = "introduction" >

< title>

Introduction

</ title>

< para>

The differences between DocBook V4.x and V5.0 are quite radical in some aspects, but the basic idea behind DocBook is still the same, and almost all element names are unchanged. Because of this it is very easy to become familiar with DocBook V5.0 if you know any previous version of DocBook. You can find a complete list of changes in

< citation>

DB5SPEC

</ citation>

, here we will discuss only the most fundamental changes.

</ para>

< section xml:id = "introduction-ns" >

< title>

Finally in a namespace

</ title>

< para>

All DocBook V5.0 elements are in the namespace

< uri>

http://docbook.org/ns/docbook

</ uri>

.

< acronym>

XML

< alt>

Extensible Markup Language

</ alt>

namespaces are used to distinguish between different element sets. In the last few years, almost all new XML grammars have used their own namespace. It is easy to create compound documents that contain elements from different XML vocabularies. DocBook V5.0 is following this design rule. Using namespaces in your documents is very easy. Consider this simple article marked up in DocBook V4.5: