<?xml version="1.0" encoding="UTF-8"?>
<!-- example uses of the most common docbook templates -->
<?oxygen RNGSchema="DBx.rnc" type="compact"?>
<chapter

    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink" 
    xml:id="chap_XXX">
    
    <title>Some DocBook 5 templates</title>
    
    <info>
        <keywordset><keyword>keyword for this document</keyword></keywordset>
    </info>
    
    <indexterm class="startofrange" xml:id="section_start">
        <primary>instance document</primary>
    </indexterm>
    <!-- range of the section -->
    <indexterm class="endofrange" startref="section_start"/>
    
    <section xml:id="sec_title">
        <title>Title</title>
        <indexterm><primary>index term</primary></indexterm>
    
    <!-- list : bulleted -->
    <itemizedlist spacing="compact">
        <listitem>
            <para>first bullet...</para>
        </listitem>
        <listitem>
            <para>second bullet...</para>
        </listitem>
    </itemizedlist>
    
    <!-- list : definition -->
    <variablelist spacing="compact">
        <varlistentry>
            <term>TERM</term>
            <listitem><simpara>DEF</simpara></listitem>
        </varlistentry>                
    </variablelist>
    
    <!-- figure -->
    <figure xml:id="fig_NAME"  floatstyle="before">
        <title>TITLE</title>
        <simpara>CAPTION at the top</simpara>
        <mediaobject>
            <imageobject>
                <imagedata fileref="FILE.pdf" scale="100" align="center"/>
            </imageobject>
        </mediaobject>    
        <caption><simpara/></caption><!-- if a line is wanted at the bottom -->
    </figure>
    <!-- table -->
    
    <table xml:id="tab_NAME" shortentry="1">
        <title>TITLE</title>
        <titleabbrev>TITLE small</titleabbrev>
        <tgroup cols="2" align="left">
            <tbody>
                <row>
                    <entry>ROW1_COL1</entry>
                    <entry>ROW1_COL2</entry>
                </row>
                <row>
                    <entry>ROW2_COL2</entry>
                    <entry>ROW2_COL2</entry>
                </row>
            </tbody>
        </tgroup>        
        <caption><simpara>CAPTION</simpara></caption>
    </table>
    
    
    <!-- example listing -->
    <example xml:id="fileName.ext">
        <title>[<filename>fileName.ext</filename>] a title </title>
        <indexterm>
            <primary>examples</primary>
            <secondary>fileName.ext</secondary>
        </indexterm>
        <simpara>caption to appear at the example.</simpara>
        <!-- listing with callouts -->
        <programlistingco>
            <areaspec units="linecolumn">
                <area xml:id="co_id" coords="L 70"/>
            </areaspec>
            <programlisting linenumbering="numbered">
            <!--<xi:include href="file..." parse="text"/>--></programlisting>
            <calloutlist>
                <callout arearefs="co_id">
                    <para>XXX</para>
                </callout>
            </calloutlist>
        </programlistingco>
    </example>
    
    <para> <!-- things that can appear in a paragraph... -->
        <!-- references to line numbers in a listing (personal extension to docbook) -->
        <refline lineid="co_id"/>
        <!--<refline lineid="co_id" source="yes"/>-->
        <refline lineid="co_id" linkend="fileName.ext"/>
        
        <!-- italics and bold face -->
        <emphasis>italics</emphasis>
        <emphasis role="strong">bold</emphasis>
    
        <!-- link to an external url -->
        <link xl:href="http:..."/>
        <link xl:href="http:...">TEXT</link>
        
        <!-- references to an ID, 
             can also be used for refering to a bibliography entries -->
        <xref linkend="ID"/> 
        <xref linkend="ID" xrefstyle="select: label page"/>
        
        <!-- index terms -->
        <indexterm class="startofrange" xml:id="PRIMARY_start">
            <primary>PRIMARY</primary>
        </indexterm>
        <indexterm class="endofrange" startref="PRIMARY_start"/>
        
        <indexterm><primary>PRIMARY</primary></indexterm>
    </para>
    </section>
    
    <!-- forcing a page break -->
    <?hard-pagebreak?>
    
    <!-- bibliography entry -->
    <bibliography>
        <biblioentry xml:id="ID">
            <authorgroup>
                <author>
                    <personname>
                        <firstname>FIRSTNAME</firstname>
                        <surname>NAME</surname>
                    </personname>
                </author>
            </authorgroup>
            <publishername>PUB</publishername>
            <pubdate>YYYY</pubdate>
            <title>TITRE</title>
        </biblioentry>
    </bibliography>
    
</chapter>