<?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>HelpOnDrawings</title></articleinfo><section><title>Working with Drawings</title><section><title>Basics</title><para>Since MoinMoin 1.9 you can choose from two drawing tools: TWikiDraw and (new) AnyWikiDraw. </para><para>TWikiDraw is available in MoinMoin since quite a while and a bit outdated meanwhile. We still provide it for compatibility with existing drawings. </para><para><ulink url="http://sourceforge.net/projects/anywikidraw/">AnyWikiDraw</ulink> is a special version for wikis of JHotDraw7, a successor of TWikiDraw with a modern user interface and a few very cool features. </para></section><section><title>Usage</title><para>Use this syntax for including a drawing on your page: </para><screen><![CDATA[{{drawing:<name of your drawing>[.tdraw|.adraw]}}]]></screen><para>Use <emphasis role="strong">.tdraw</emphasis> for TWikiDraw drawings and <emphasis role="strong">.adraw</emphasis> for AnyWikiDraw drawings. If you don't add an extension it will default to TWikiDraw. </para><para>If a drawing does not exist, you will see the attachment symbol instead of a drawing. A click on it will lead you to a page where the drawing applet gets started, so you can create a new drawing and save it. </para><para>When moin renders the wiki page afterwards, you'll see a rendered PNG of your new drawing. </para><para>If you click on the PNG rendering of an existing drawing, moin will invoke the drawing applet so you can modify it. </para><para><inlinemediaobject><imageobject><imagedata depth="15" fileref="http://guide.neatportal.com/moin_static/explorer/img/idea.png" width="15"/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> In case you see some message asking whether you want to load the applet, you should confirm that. </para><para>Please play around with the drawing tools on your own, you will explore a lot of cool features. </para><para>E.g. add images to your drawings, play around with grouping, transparency effects and rotate everything by slowly double clicking on it.  </para><para>Have fun! </para></section><section><title>Examples</title><section><title>Markup for a TWikiDraw drawing</title><screen><![CDATA[{{drawing:twikitest.tdraw}}]]></screen></section><section><title>Rendering of a TWikiDraw drawing</title><para>{{drawing:twikitest.tdraw}} </para></section><section><title>Markup for a AnyWikiDraw drawing</title><screen><![CDATA[{{drawing:anywikitest.adraw}}]]></screen></section><section><title>Rendering of a AnyWikiDraw drawing</title><para>{{drawing:anywikitest.adraw}} </para></section></section><section><title>.tdraw file format</title><para>MoinMoin &lt; 1.9 stored 3 files for each TWikiDraw drawing: </para><itemizedlist><listitem><para>drawingname.draw (drawing file for TWikiDraw) </para></listitem><listitem><para>drawingname.map (for clickable drawings) </para></listitem><listitem><para>drawingname.png (PNG rendering of the drawing) </para></listitem></itemizedlist><para>With MoinMoin 1.9 this was changed so that only 1 file is needed (please use <code>moin migration data</code> to convert existing data): </para><itemizedlist><listitem><para>drawingname.tdraw </para></listitem></itemizedlist><para>This .tdraw file is simply a tar archive that internally contains the 3 files (see above). The contained files are ever called <code>drawing.*</code> so they do not need to get renamed if the .tdraw file gets renamed. </para></section><section><title>.adraw file format</title><para>MoinMoin 1.9 now also supports AnyWikiDraw drawings and saves them into a .adraw tar file, which contains: </para><itemizedlist><listitem><para>drawing.svg (SVG file for AnyWikiDraw) </para></listitem><listitem><para>drawing.png (PNG rendering of the SVG) </para></listitem></itemizedlist><para>The contained files are ever called <code>drawing.*</code> so they do not need to get renamed if the .adraw file gets renamed. </para></section></section></article>