AnyWikiDrawPlugin

NOTE: This is an early release use for development purpose only.

AnyWikiDraw adds support for drawing directly into a Wiki page.

The following file formats are supported:

• Scaleable Vector Graphics (.svg, .svgz). – Use this file format, if you want to create an illustration, for example a street map. SVG retains the structure of a drawing, which allows to edit existing drawings efficiently. SVG drawings can be scaled and edited multiple times without loss of quality. Files with the extension .svgz are compressed versions of the .svg files.

• Portable Network Graphics (PNG). – Use this file format, if you want to retouch a picture, for example, a photograph of your home. PNG does not retain the structure of a drawing. If you intend to add structured drawing elements to a photograph (like captions, or line drawings), consider pasting the PNG image into an SVG file, and adding these drawing elements using SVG. PNG images degrade in quality if they are scaled. PNG images can be edited multiple times without loss of quality.

• Joint Photographics Expert Group (JPEG). – This file format is often used to publish photographs, because it is able to compress them highly. If possible, convert the photograph into PNG for photo retouching, or paste it into an SVG image before adding structural drawing elements to it. JPEG images degrade in quality if they are scaled, or if they are edited multiple times.

This plugin is very similar in functionality to the TWiki:Plugins.TWikiDrawPlugin. In a future version, it may be used as a replacement for the TWikiDrawPlugin.

AnyWikiDraw is available for other Wikis as well, currently TWiki, MediaWiki and PmWiki are supported.

The main project site of AnyWikiDraw is at Sourceforge.net: http://sourceforge.net/projects/anywikidraw/

Warning: This is an experimental plugin. Data loss may occur. Install it only on a Wiki system that does not contain critical data.

Syntax Rules

   %ANYWIKIDRAW{ "drawing.svg" width="240" height="320"}%
   %AWDRAW{ "drawing.svg" width="240" height="320"}%

• The parameter drawing.svg specifies the name of the drawing file.
• The drawing file can have one of the following extensions .draw, .svg, .svgz, .png, .jpg.
• If you specify a drawing file that does not yet exist in your Wiki, the drawing is created the first time you save a drawing.
• The parameter width specifies the width of the drawing.
• The parameter height specifies the height of the drawing.

Examples

Plugin Settings

Installation Instructions

• Download on of the archive and unpack into your TWiki installation directory.
• Fix the shebang line and file extension for /bin/pack200.
• Fix your files access right.
• Review your apache configuration keeping in mind the newly added script /bin/pack200.

Plugin Info

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

-- TWiki:Main.WernerRandelshofer - 30 Aug 2007