<article xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'>

<section>
<title>A docbook document</title>
<simpara>
This page shows the different features of our native DocBook support. A table of contents is automatically
generated from section titles.
</simpara>
<section>
<title>Lists</title>


<section>
<title>Itemized List</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<itemizedlist>
  <listitem>
    <para>Item 1
    </para>
  </listitem>
  <listitem>
    <para>Item 2
    </para>
  </listitem>
  <listitem>
    <para> Item 3
    </para>
  </listitem>
</itemizedlist>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<itemizedlist>
  <listitem>
    <para>Item 1
    </para>
  </listitem>
  <listitem>
    <para>Item 2
    </para>
  </listitem>
  <listitem>
    <para> Item 3
    </para>
  </listitem>
</itemizedlist>
</section>


<section>
<title>Ordered List</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<orderedlist numeration="lowerroman">
  <listitem>
    <para>One</para>
  </listitem>
  <listitem>
    <para>Two</para>
  </listitem>
  <listitem>
    <para>Three</para>
  </listitem>
  <listitem>
    <para>Four</para>
  </listitem>
</orderedlist>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<orderedlist numeration="lowerroman">
  <listitem>
    <para>One</para>
  </listitem>
  <listitem>
    <para>Two</para>
  </listitem>
  <listitem>
    <para>Three</para>
  </listitem>
  <listitem>
    <para>Four</para>
  </listitem>
</orderedlist>
</section>


<section>
<title>Variable List</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<variablelist><title>Font Filename Extensions</title>
  <varlistentry>
    <term><filename>TTF</filename></term>
    <listitem>
      <para>TrueType fonts.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><filename>PFA</filename></term>
    <term><filename>PFB</filename></term>
    <listitem>
      <para>
        PostScript fonts. <filename>PFA</filename> files are common
        on <acronym>UNIX</acronym> systems, <filename>PFB</filename>
        files are more common on Windows systems.
      </para>
    </listitem>
  </varlistentry>
 </variablelist>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<variablelist><title>Font Filename Extensions</title>
  <varlistentry>
    <term><filename>TTF</filename></term>
    <listitem>
      <para>TrueType fonts.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><filename>PFA</filename></term>
    <term><filename>PFB</filename></term>
    <listitem>
      <para>
        PostScript fonts. <filename>PFA</filename> files are common
        on <acronym>UNIX</acronym> systems, <filename>PFB</filename>
        files are more common on Windows systems.
      </para>
    </listitem>
  </varlistentry>
 </variablelist>

</section>

</section>



<section>
<title>Simple text formatting</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<para>
<emphasis role="bold">This</emphasis> paragraph contains
<emphasis>some <emphasis>emphasized</emphasis> text</emphasis>
and a <superscript>super</superscript>script
and a <subscript>sub</subscript>script.
</para>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
<emphasis role="bold">This</emphasis> paragraph contains
<emphasis>some <emphasis>emphasized</emphasis> text</emphasis>
and a <superscript>super</superscript>script
and a <subscript>sub</subscript>script.
</para>

</section>



<section>
<title>Footnotes</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<para>An annual percentage rate (<abbrev>APR</abbrev>) of 13.9%
<footnote>
The prime rate, as published in the Wall Street
Journal on the first business day of the month,
plus 7.0%.
</footnote>
will be charged on all balances carried forward.
</para>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>An annual percentage rate (<abbrev>APR</abbrev>) of 13.9%
<footnote>
The prime rate, as published in the Wall Street
Journal on the first business day of the month,
plus 7.0%.
</footnote>
will be charged on all balances carried forward.
</para>

</section>



<section>
<title>Quotes</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<para>This software is provided <quote>as is</quote>, without expressed
or implied warranty.
</para>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>This software is provided <quote>as is</quote>, without expressed
or implied warranty.
</para>

</section>



<section>
<title>Trademarks and Copyrights</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<para><trademark class='registered'>Nutshell Handbook</trademark> is a
registered trademark of O'Reilly Media, Inc.
</para><para>
<trademark class="copyright">2014 Joe Doe</trademark>
</para><para>
<trademark class="trade">Foo Bar</trademark> is an unregistered trademark.
</para><para>
<trademark class="service">Foo Bar</trademark> is an unregistered servicemark.
</para>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para><trademark class='registered'>Nutshell Handbook</trademark> is a
registered trademark of O'Reilly Media, Inc.
</para><para>
<trademark class="copyright">2014 Joe Doe</trademark>
</para><para>
<trademark class="trade">Foo Bar</trademark> is an unregistered trademark.
</para><para>
<trademark class="service">Foo Bar</trademark> is an unregistered servicemark.
</para>

</section>



<section>
<title>Preformatted Data</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<screen><![CDATA[
<para>
My  preformatted      data.

Remove blanks from "] ] >" below:
</para>
] ] ></screen>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<screen><![CDATA[
<para>
My  preformatted      data.

Remove blanks from "] ] >" below:
</para>
]]></screen>

</section>



<section>
<title>Links</title>

<section>
<title>External Links</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<link xlink:href="http://moinmo.in/">MoinMoin rocks</link>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
<link xlink:href="http://moinmo.in/">MoinMoin rocks</link>
</para>

</section>


<section>
<title>Internal Links</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<link xlink:href="../Sibling">Sibling of this page</link>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
<link xlink:href="../Sibling">Sibling of this page</link>
</para>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<link xlink:href="/SubItem">SubItem of this page</link>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
<link xlink:href="/SubItem">SubItem of this page</link>
</para>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<link xlink:href="../../Home">wiki_root based path to Home</link>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
<link xlink:href="../../Home">wiki_root based path to Home</link>
</para>

</section>


<section>
<title>Anchor Links</title>

<para>linkend to anchor in this page</para>
<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<link linkend="Video_with_caption">linkend to Video with caption</link>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
<link linkend="Video_with_caption">linkend to Video with caption</link>
</para>
</section>

</section>


<section>
<title>Tables</title>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<table frame='all'><title>Sample Table</title>
<tgroup cols='5' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<colspec colnum='5' colname='c5'/>
<thead>
<row>
  <entry namest="c1" nameend="c2" morecols='1' align="center">Horizontal Span</entry>
  <entry>a3</entry>
  <entry>a4</entry>
  <entry>a5</entry>
</row>
</thead>
<tfoot>
<row>
  <entry>f1</entry>
  <entry>f2</entry>
  <entry>f3</entry>
  <entry>f4</entry>
  <entry>f5</entry>
</row>
</tfoot>
<tbody>
<row>
  <entry>b1</entry>
  <entry>b2</entry>
  <entry>b3</entry>
  <entry>b4</entry>
  <entry morerows='1' valign='middle'><para>  <!-- Pernicous Mixed Content -->
  Vertical Span</para></entry>
</row>
<row>
  <entry>c1</entry>
  <entry namest="c2" nameend="c3" morecols='1' align='center' morerows='1' valign='bottom'>Span Both</entry>
  <entry>c4</entry>
</row>
<row>
  <entry>d1</entry>
  <entry>d4</entry>
  <entry>d5</entry>
</row>
</tbody>
</tgroup>
</table>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<table frame='all'><title>Sample Table</title>
<tgroup cols='5' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<colspec colnum='5' colname='c5'/>
<thead>
<row>
  <entry namest="c1" nameend="c2" morecols='1' align="center">Horizontal Span</entry>
  <entry>a3</entry>
  <entry>a4</entry>
  <entry>a5</entry>
</row>
</thead>
<tfoot>
<row>
  <entry>f1</entry>
  <entry>f2</entry>
  <entry>f3</entry>
  <entry>f4</entry>
  <entry>f5</entry>
</row>
</tfoot>
<tbody>
<row>
  <entry>b1</entry>
  <entry>b2</entry>
  <entry>b3</entry>
  <entry>b4</entry>
  <entry morerows='1' valign='middle'><para>  <!-- Pernicous Mixed Content -->
  Vertical Span</para></entry>
</row>
<row>
  <entry>c1</entry>
  <entry namest="c2" nameend="c3" morecols='1' align='center' morerows='1' valign='bottom'>Span Both</entry>
  <entry>c4</entry>
</row>
<row>
  <entry>d1</entry>
  <entry>d4</entry>
  <entry>d5</entry>
</row>
</tbody>
</tgroup>
</table>

<para>
<emphasis role="bold">Note:</emphasis> Moin2 does not support the "tgroup" or "title" tags within a table. Moin2 does not support the entry tag attributes of "namest" and "nameend". Use the "morecols" attribute as an alternative.
</para>

</section>



<section>
<title>Objects</title>

<section>
<title>Image embedded in a sentence</title>

<para>
An "inlinemediaobject" may be positioned within a paragraph and aligned to the text top, middle, or bottom
through use of the align attribute.
</para>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<para>
Here is an image
<inlinemediaobject>
  <imageobject>
    <imagedata format="png" align="middle" fileref="help-common/logo.png"/>
  </imageobject><caption>My Logo</caption>
</inlinemediaobject>
embedded in a sentence.
</para>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<para>
Here is an image
<inlinemediaobject>
  <imageobject>
    <imagedata format="png" align="middle" fileref="help-common/logo.png"/>
  </imageobject><caption>My Logo</caption>
</inlinemediaobject>
embedded in a sentence.
</para>
</section>


<section>
<title>Video with caption</title>

<para>
A "mediaobject" is a block level element that may
be positioned to the left, center, or right through use of the align attribute.
</para>

<simpara>
Here is a video courtesy of http://techslides.com/sample-webm-ogg-and-mp4-video-files-for-html5/. This video has a caption.
</simpara>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<mediaobject>
  <videoobject>
    <videodata fileref="help-common/video.mp4" align="center"/>
  </videoobject>
  <caption>MY VIDEO</caption>
</mediaobject>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<mediaobject>
  <videoobject>
    <videodata fileref="help-common/video.mp4" align="center"/>
  </videoobject>
  <caption>MY VIDEO</caption>
</mediaobject>

</section>


<section>
<title>Audio with caption</title>
<simpara>
Here is a sound, courtesy of http://www.mediacollege.com/audio/tone/download/.
The align="center" attribute centers the object.
</simpara>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<mediaobject>
  <audioobject>
    <audiodata align="center" fileref="help-common/audio.mp3"/>
  </audioobject>
  <caption>My Audio</caption>
</mediaobject>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<mediaobject>
  <audioobject>
    <audiodata align="center" fileref="help-common/audio.mp3"/>
  </audioobject>
  <caption>My Audio</caption>
</mediaobject>

</section>



<section>
<title>Invalid media format</title>
<simpara>
Display textobject when an invalid format is specified.
</simpara>

<emphasis role="bold">Markup:</emphasis>

<screen><![CDATA[
<mediaobject>
  <audioobject><audiodata format="qqq" fileref="audio.mp3"/>
  </audioobject>
  <textobject>The media format "qqq" is not supported!</textobject>
</mediaobject>
]]></screen>

<emphasis role="bold">Results:</emphasis>

<mediaobject>
  <audioobject><audiodata format="qqq" fileref="audio.mp3"/>
  </audioobject>
  <textobject>The media format "qqq" is not supported!</textobject>
</mediaobject>

</section>

</section>

</section>
</article>
