<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>
