<?xml version="1.0" encoding="utf-8"?>

<?xml-stylesheet type="text/css"
    href="../docbook.css"?>

<!--
<?xml-stylesheet type="text/css" alternate="yes"
    title="ORA DocBook lite"
    href="http://WWW.sabi.co.UK/style/docbook-lite.css"?>
<?xml-stylesheet type="text/css" alternate="yes"
    title="Brian Lalonde for full DocBook"
    href="http://WWW.sabi.co.UK/style/docbook-brian.css"?>
<?xml-stylesheet type="text/css" alternate="yes"
    title="Brian Lalonde for Simplified Docbook"
    href="http://WWW.sabi.co.UK/style/docbook-simple-brian.css"?>
-->

<!--
<?xml-stylesheet type="text/xsl" alternate="yes"
    title="XSLT to XHTML"
    href="../../style/docbook.xsl"?>
-->

<!DOCTYPE article
  PUBLIC "-//IDN sabi.co.UK/DTD DocBook XML V4.2-Based Extension MathML 2.0 V3//EN"
  "http://sabi.co.UK/docbook/dbmathml-sabi3.dtd"
  [
    <!-- Mozilla handles these canonical namespaces specially -->
    <!ENTITY svgns    "http://www.w3.org/2000/svg">
    <!ENTITY xlinkns  "http://www.w3.org/1999/xlink">
    <!ENTITY xhtmlns  "http://www.w3.org/1999/xhtml">
    <!ENTITY mathmlns "http://www.w3.org/1998/Math/MathML">

    <!-- Mozilla comes with two lists of entities from XHTML 1.1 and
     MathML 2.0, and they must be explicitly included with relative
     system identifiers. -->
    <!ENTITY % MozillaXHTML11 SYSTEM "xhtml11.dtd"> %MozillaXHTML11;
    <!ENTITY % MozillaMathML  SYSTEM "mathml.dtd">  %MozillaMathML;
  ]
>

<article>
  <articleinfo>
    <title>Example document</title>
    <subtitle>Subtitle of the example document</subtitle>

    <authorgroup>
      <author>
        <firstname>Eric</firstname>
        <surname>Bellot</surname>

        <affiliation>
          <jobtitle>Formateur </jobtitle>
          <orgname>MonEntreprise</orgname>
        </affiliation>
      </author>

      <author>
        <firstname>Peter</firstname>
        <surname>G.</surname>

        <affiliation>
          <jobtitle>Software Architect</jobtitle>
          <orgname>MUSS fans</orgname>
        </affiliation>
      </author>
    </authorgroup>

    <pubdate>2002-10-30</pubdate>

    <copyright>
     <year>2004</year>
     <holder>Peter G.</holder>
    </copyright>

    <legalnotice>
     <para>Licensed under the GNU GPL 2.0 or later.</para>
    </legalnotice>

    <keywordset>
      <keyword>DocBook</keyword>
      <keyword>example</keyword>
      <keyword>XML</keyword>
      <keyword>XSL</keyword>
    </keywordset>

    <abstract>
      <para>Example of a DocBook document.</para>
    </abstract>
  </articleinfo>

  <section>
    <title>
      <phrase id="theTitle"/>Examples of paragraphs</title>

    <para>Just a normal paragraph.</para>

    <para>A preformatted paragraph follows:</para>

    <programlisting>Example of preformatted text.

      The spacing is preserved <lineannotation>(note)</lineannotation>
      Three space between brackets [    ]
      The line endings are preserved too (two follow)

      TABs are converted to spaces.
      Two TABS between brackets [		]
    </programlisting>

    <para>Below we have a quotation.</para>

    <blockquote lang="en">
      <para>Free software is a matter of
      freedom: people should be free to use software in all the
      ways that are socially useful. Software differs from
      material objects -- such as chairs, sandwiches, and
      gasoline -- in that it can be copied and changed much more
      easily.</para>
      <para>These possibilities make software as useful as it
      is; we believe software users should be able to make use of
      them. (Philosophy of the GNU Project)</para>
    </blockquote>

    <para>And we have here a classic equation:

      <math xmlns="&mathmlns;">
        <mi>F</mi>
        <mo>=</mo>
        <mi>m</mi>
        <mo>*</mo>
        <mi>a</mi>
      </math>.
    </para>

  </section>

  <section>
    <title>Examples of text styles</title>

    <para>We have here some <emphasis>emphasis</emphasis>.</para>

    <para>here we have instead some <emphasis role="strong">strong
        emphasis</emphasis>.
    </para>

    <para>An example of <literal>literal (fixed width)</literal> text.
    </para>

    <para>We can also have a pathname, like
      <filename>/usr/lib/python21</filename>.
    </para>
  </section>

  <section>
    <title>Example of sections and their titles (title level 1)</title>

    <section>
      <title>Example of title level 2</title>

      <para>Text of the subsection.</para>

      <section>
        <title>Example of title level 3</title>

        <para>text of the sub-subsection.</para>
      </section>
    </section>

    <section>
      <title>Example of title level 2</title>

      <para>Text of the subsection.</para>
    </section>
  </section>

  <section>
    <title>Examples of lists</title>

    <para>We only do examples of bullet lists and numbered lists here.
    </para>

    <section>
      <title>Bullet lists</title>

      <itemizedlist>
        <listitem>
          <para>Bulleted item.</para>
        </listitem>

        <listitem>
          <para>Bulleted item.</para>

          <itemizedlist>
            <listitem>
              <para>Bulleted subitem P1.</para>
              <para>Bulleted subitem P2.</para>
            </listitem>
            <listitem>
              <para>Bulleted subitem.</para>
            </listitem>
          </itemizedlist>
        </listitem>

        <listitem>
          <para>Bulleted item.</para>
        </listitem>
      </itemizedlist>
    </section>

    <section>
      <title>Numbered lists</title>

      <orderedlist continuation="restarts">
        <listitem>
          <para>Numbered item.</para>
        </listitem>

        <listitem>
          <para>Numbered item.</para>

          <orderedlist continuation="restarts">
            <listitem>
              <para>Numbered subitem P1.</para>
              <para>Numbered subitem P2.</para>
            </listitem>

            <listitem>
              <para>Numbered subitem.</para>
            </listitem>
          </orderedlist>
        </listitem>

        <listitem>
          <para>Numbered item.</para>
        </listitem>
      </orderedlist>
    </section>
  </section>

  <section>
    <title>Example of table</title>

    <para>It is possible to merge table cells, but only
      horizontally.
    </para>

    <para>This is example of the <literal>&lt;informaltable></literal>
      element, which does not support captions.
    </para>

    <informaltable>
      <tgroup cols="5">
        <colspec colname="c1" colwidth="3.399cm"/>
        <colspec colname="c2" colwidth="3.399cm"/>
        <colspec colname="c3" colwidth="3.399cm"/>
        <colspec colname="c4" colwidth="3.399cm"/>
        <colspec colname="c5" colwidth="3.399cm"/>

        <thead>
          <row>
            <entry><para>Column 1</para></entry>
            <entry><para>Column 2</para></entry>
            <entry><para>Column 3</para></entry>
            <entry><para>Column 4</para></entry>
            <entry><para>Column 5</para></entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry><para>Column 1 cell</para></entry>
            <entry namest="c2" nameend="c3">
              <para>Merged columns 2 and 3 cell</para>
            </entry>
            <entry><para>Column 4 cell</para></entry>
            <entry><para>Column 5 cell</para></entry>
          </row>

          <row>
            <entry><para>Column 1 cell</para></entry>
            <entry><para>Column 2 cell</para></entry>
            <entry namest="c3" nameend="c4">
              <para>Merged columns 3 and 4 cell</para>
            </entry>
            <entry><para>Column 5 cell</para></entry>
          </row>

          <row>
            <entry><para>Column 1 cell</para></entry>
            <entry><para>Column 2 cell</para></entry>
            <entry><para>Column 3 cell</para></entry>
            <entry><para>Column 4 cell</para></entry>
            <entry><para>Column 5 cell</para></entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
  </section>

  <section>
    <title>Examples of links and footnotes</title>

    <para>Here is a link to

      <ulink url="http://www.openoffice.org/"
             type="">OpenOffice.org</ulink>
    </para>

    <para>Here instead is a links back to the title of the section

      <link linkend="theTitle">Examples of paragraphs</link>.

      The title is linkable to thanks to a signpost
      of the form &lt;phrase id="theTitle"/&gt;.
    </para>

    <para>This is instead a paragraph with a
      footnote<footnote id="fn1">
        <para>Footnote text.</para>
      </footnote>.
    </para>
  </section>

  <section>
    <title>Example of inserting an image</title>

    <mediaobject>
      <imageobject>
        <imagedata fileref="http://www.docbook.org/graphics/smallcover.gif"
                   width="2cm" depth="3cm"/>
      </imageobject>
      <textobject>
        <phrase>Text substitute for the image</phrase>
      </textobject>
      <caption>
        <para>Caption for the image</para>
      </caption>
    </mediaobject>
    <para/>
  </section>

  <section>
    <title>Example of bibliography</title>
    <para>This document has been based on

      <xref linkend="sDocbook2002"/>

      and also on

      <xref linkend="Eckstein2000"/>.
    </para>
  </section>

  <bibliography>
    <title>Bibliography</title>

    <bibliomixed id="sDocbook2002">
      <abbrev>sDocbook2002</abbrev>
      <citetitle>Simplified DocBook DTD</citetitle>
      <pubdate>2002</pubdate>
    </bibliomixed>

    <bibliomixed id="Eckstein2000">
      <abbrev>Eckstein2000</abbrev>

      <author>
        <firstname>Robert</firstname>
        <surname>Eckstein</surname>
      </author>

      <author>
        <firstname>Michel</firstname>
        <surname>Casabianca</surname>
      </author> 

      <citetitle>XML in a nutshell</citetitle>

      <publishername>O'Reilly</publishername>
      <pubdate>2000</pubdate>
    </bibliomixed>
  </bibliography>

  <script xmlns="&xhtmlns;" type="text/javascript"
    src="http://WWW.sabi.co.UK/style/docbook.js"></script>
</article>
