Next / Previous / Contents / TCC Help System / NM Tech homepage

4. Overall section structure

Here is the model file discussed in Section 2, “Setting up your directory for DocBook”:

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<article>
  <!-- Replace all fields ### below. Then delete this comment -->
  <articleinfo>
    <title>###
</title>
    <authorgroup>
      <author>
        <firstname>###
</firstname>
        <surname>###
</surname>
      </author>
    </authorgroup>
    <address><email>###
</email>
    </address>
    <revhistory>
      <revision>
        <revnumber>$Revision: 1.34 $</revnumber>
        <date>$Date: 2009/10/10 22:32:39 $</date>
      </revision>
    </revhistory>
  </articleinfo>
  <section>
    <!-- On the next line, place the title of your first section. -->
    <title>
</title>
    <!-- Add the body of your first section here. -->
  </section>
  <!--Place additional sections here with <section>...</section>
   !  tags.
   !-->
</article>

Note the last few lines above. This is the skeleton of the first section of your document. Place the section's title inside the title element, and add the section's content after it.

Each section element is a top-level section. They will be numbered as sections 1, 2, 3, and so on. To add subsections, use a section element inside the section element. For example:

  <section>
    <title>Main section title</title>
    <para>Main section content...</para>
    <section>
      <title>First subsection title</title>
      <para>First subsection content...</para>
    </section>
    <section>
      <title>Second subsection title</title>
      <para>Second subsection content...</para>
    </section>
  </section>

If the main section were section 3, then the two subsections inside it would be numbered 3.1 and 3.2.

You can include more section elements for sub-sub-sections, and so on.

4.1. The titleabbrev element: Short title

The title element inside your articleinfo group will appear in the running footer on every page in the PDF version of the document. If your title is too long, it will be folded into two or more lines inside the footer.

To cure this problem, place a titleabbrev element just after the main title element, containing a shorter version of the title that will fit inside the running footer. For example:

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<article>
  <articleinfo>
    <title>Exegesis of archetypal content and pataphysical normatives
    in <citetitle >Monty Python and the Holy Grail</citetitle ></title>
    <titleabbrev><citetitle >Monty Python</citetitle > and
    pataphysics</titleabbrev>
    <authorgroup>
      ...