<?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>HelpOnComments</title></articleinfo><section><title>Comments</title><para><ulink url="http://clip.ipipan.waw.pl/HelpOnComments/MoinMoin#">MoinMoin</ulink> has the capability to use in-context comments to directly add some comment or additional information to the place you are commenting on, while still enabling the user to get a clean display of the page contents without the comments. </para><para>The edit bar has a toggle for the visibility of these comments. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://clip.ipipan.waw.pl/wiki_static/mandarin_clip/img/idea.png" width="16"/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> Just click on Comments to toggle the visibility (requires Javascript enabled in your browser). </para><para>The comments will usually be rendered slightly different from normal text (e.g. different colour), so the user can still see what is main content and what is a comment. </para><section><title>Inline comments</title><section><title>Markup</title><screen><![CDATA[Diamonds are expensive. /* BTW, there are also inexpensive industrial diamonds. */ Their price depends on multiple factors: ...]]></screen></section><section><title>Display</title><para>Diamonds are expensive. <remark>BTW, there are also inexpensive industrial diamonds.</remark> Their price depends on multiple factors: ... </para></section></section><section><title>Comment sections</title><section><title>Markup</title><screen><![CDATA[Some normal text.
]]><![CDATA[
{{{#!wiki comment
This is just a wiki parser using a div class="comment" to contain its output.
 1. first
 1. second
 1. ...
}}}
]]><![CDATA[
More normal text.]]></screen></section><section><title>Display</title><para>Some normal text. </para><remark><para>This is just a wiki parser using a div class=&quot;comment&quot; to contain its output. </para><orderedlist numeration="arabic"><listitem><para>first </para></listitem><listitem><para>second </para></listitem><listitem><para>... </para></listitem></orderedlist></remark><para>More normal text. </para></section></section><section><title>Hints for using comments</title><itemizedlist><listitem><para>You need Javascript to toggle the visibility of the comments. If you don't have Javascript, see below. </para></listitem><listitem><para>You can set the visibility of comments in your user preferences, the default is to not show comments (so you need to click on Comments to see them). </para><itemizedlist><listitem><para>This default was chosen because the main intention of this feature is to have a <emphasis>clean</emphasis> page display. </para></listitem><listitem><para>You still have the choice of seeing everything without additional clicks (and hiding by using the toggle) by enabling Show comment sections in your user preferences. </para></listitem></itemizedlist></listitem></itemizedlist><para>Additionally to the comments feature, there is also the &quot;supplementation page&quot; feature (see <ulink url="http://clip.ipipan.waw.pl/HelpOnComments/HelpOnConfiguration/SupplementationPage#">HelpOnConfiguration/SupplementationPage</ulink>). </para></section></section></article>