<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>HelpOnFormatting</title></articleinfo><para><ulink url="https://wiki.hcoop.net/HelpOnFormatting/HelpForUsers#">HelpForUsers</ulink> &gt; <ulink url="https://wiki.hcoop.net/HelpOnFormatting/HelpOnEditing#">HelpOnEditing</ulink> &gt; HelpOnFormatting </para><para>This page describes using the <ulink url="https://wiki.hcoop.net/HelpOnFormatting/MoinMoin#">MoinMoin</ulink> wiki syntax (which is the default syntax for a <ulink url="https://wiki.hcoop.net/HelpOnFormatting/MoinMoin#">MoinMoin</ulink> based wiki, but not the only one). For other parsers/syntaxes take a look at <ulink url="https://wiki.hcoop.net/HelpOnFormatting/HelpOnParsers#">HelpOnParsers</ulink>. </para><section><title>General</title><itemizedlist><listitem><para>Use one or more blank lines to separate paragraphs. </para></listitem><listitem><para>Use <code>&lt;&lt;BR&gt;&gt;</code> to insert linebreaks into paragraphs. </para></listitem></itemizedlist></section><section><title>Typeface</title><informaltable><tgroup cols="3"><colspec colname="col_0"/><colspec colname="col_1"/><colspec colname="col_2"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis role="strong"> Name/Sample</emphasis> </para></entry><entry colsep="1" rowsep="1"><para> <emphasis role="strong"> Markup </emphasis>   </para></entry><entry colsep="1" rowsep="1"><para> <emphasis role="strong"> Notes </emphasis>          </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <emphasis>italic</emphasis>     </para></entry><entry colsep="1" rowsep="1"><para> <code>''italic''</code>       </para></entry><entry colsep="1" rowsep="1"><para> Double single quotes.  </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <emphasis role="strong">bold</emphasis>     </para></entry><entry colsep="1" rowsep="1"><para> <code>'''bold'''</code>       </para></entry><entry colsep="1" rowsep="1"><para> Triple single quotes.  </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <code>monospace</code>    </para></entry><entry colsep="1" rowsep="1"><para> <code>`monospace`</code>  </para></entry><entry colsep="1" rowsep="1"><para> Single backticks.  Wiki markup is ignored.   </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <code>code</code>     </para></entry><entry colsep="1" rowsep="1"><para> <code>{{{code}}}</code>       </para></entry><entry colsep="1" rowsep="1"><para> <link linkend="code_example">Example.</link>  Wiki markup is ignored. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <emphasis role="underline">underline</emphasis>  </para></entry><entry colsep="1" rowsep="1"><para> <code>__underline__</code>    </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <superscript>super</superscript>script  </para></entry><entry colsep="1" rowsep="1"><para> <code>^super^script</code>    </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <subscript>sub</subscript>script  </para></entry><entry colsep="1" rowsep="1"><para> <code>,,sub,,script</code>    </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <!--"~-smaller-~" is not applicable to DocBook-->smaller    </para></entry><entry colsep="1" rowsep="1"><para> <code>~-smaller-~</code>      </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para>  <!--"~+bigger+~" is not applicable to DocBook-->larger     </para></entry><entry colsep="1" rowsep="1"><para> <code>~+larger+~</code>       </para></entry><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <emphasis role="strikethrough">stroke</emphasis>    </para></entry><entry colsep="1" rowsep="1"><para> <code>--(stroke)--</code>     </para></entry><entry colsep="1" rowsep="1"/></row></tbody></tgroup></informaltable></section><section><title>Colorize text</title><para>Colorizing is enabled in tables without additional macros (see <ulink url="https://wiki.hcoop.net/HelpOnFormatting/HelpOnTables#">HelpOnTables</ulink>).  </para><para>See also <ulink url="http://moinmaster.wikiwikiweb.de/HelpMiscellaneous/FrequentlyAskedQuestions#head-337b0c57eeb073c9550a2ed281d4ca6dda4f47e5">How can I colorize my text?</ulink> in the FAQ. </para></section><section><title>Colorize code (Syntax Highlighting)</title><para>There are several ways to highlight code: </para><orderedlist numeration="arabic"><listitem><para>Start a special code block containing the parser's name: <code>{{{#!parsername</code> </para></listitem><listitem><para>Embed a file attachment bearing a supported extension (such as <code>&quot;.py&quot;</code>) with <code>{{attachment:test.py}}</code> </para></listitem><listitem><para>Begin a page with the format processing instruction: <code>#format parsername</code> </para></listitem></orderedlist><para><link linkend="SyntaxHighlighting">Example.</link> </para><para>To see the list of supported languages see <ulink url="https://wiki.hcoop.net/HelpOnFormatting/HelpOnParsers#">HelpOnParsers</ulink>. </para><!--rule (<hr>) is not applicable to DocBook--></section><section><title>Examples</title><section><title>Mixing ''italic'' and '''bold'''</title><para><anchor id="italic_bold_example"/> </para><informaltable><tgroup cols="2"><colspec colname="col_0"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis role="strong">Markup</emphasis>                       </para></entry><entry colsep="1" rowsep="1"><para> <emphasis role="strong">Result</emphasis>                     </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>'''''Mix''' at the beginning''</code>  </para></entry><entry colsep="1" rowsep="1"><para>  <emphasis><emphasis role="strong">Mix</emphasis> at the beginning</emphasis>  </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>'''''Mix'' at the beginning'''</code>  </para></entry><entry colsep="1" rowsep="1"><para>  <emphasis role="strong"><emphasis>Mix</emphasis> at the beginning</emphasis>  </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>'''Mix at the ''end'''''</code>        </para></entry><entry colsep="1" rowsep="1"><para>  <emphasis role="strong">Mix at the <emphasis>end</emphasis></emphasis>        </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>''Mix at the '''end'''''</code>        </para></entry><entry colsep="1" rowsep="1"><para>  <emphasis>Mix at the <emphasis role="strong">end</emphasis></emphasis>        </para></entry></row></tbody></tgroup></informaltable></section><section><title>Code</title><para><anchor id="SyntaxHighlighting"/> </para><para><code>{{{</code> </para><para> <code>10 PRINT &quot;Hello, world!&quot;</code> </para><para> <code>20 GOTO 10</code> </para><para> <code>}}}</code> </para><para>Result: </para><screen><![CDATA[10 PRINT "Hello, world!"
20 GOTO 10]]></screen></section><section><title>Superscript &amp; Subscript</title><para><code>You might recall ''a''^2^ </code>+<code> ''b''^2^ </code>=<code> ''c''^2^ from your math lessons, unless your head is filled with H,,2,,O.</code> </para><para>Result: </para><para>You might recall <emphasis>a</emphasis><superscript>2</superscript> <code>+</code> <emphasis>b</emphasis><superscript>2</superscript> <code>=</code> <emphasis>c</emphasis><superscript>2</superscript> from your math lessons, unless your head is filled with H<subscript>2</subscript>O. </para></section><section><title>Colorized Code, Method #1</title><para><anchor id="color_code_example"/> </para><screen><![CDATA[{{{#!python
from colors import palette
palette.colorize('python')
}}}]]></screen><para>Result: </para><programlisting format="linespecific" language="python" linenumbering="numbered" startinglinenumber="1"><token><![CDATA[from]]></token><![CDATA[ ]]><methodname><![CDATA[colors]]></methodname><![CDATA[ ]]><token><![CDATA[import]]></token><![CDATA[ ]]><methodname><![CDATA[palette]]></methodname>
<methodname><![CDATA[palette]]></methodname><![CDATA[.]]><methodname><![CDATA[colorize]]></methodname><![CDATA[(]]><phrase><![CDATA[']]></phrase><phrase><![CDATA[python]]></phrase><phrase><![CDATA[']]></phrase><![CDATA[)]]>
</programlisting></section></section></article>