AnyWikiDrawPlugin

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 your files access right.

Plugin Info

Plugin Author:	TWiki:Main.WernerRandelshofer
Copyright:	© 2007, TWiki:Main.WernerRandelshofer
License:	Client-side code: LGPL (Lesser GNU General Public License) and/or CC-By 3.0 (Creative Commons Attribution 3.0). Server-side code: GPL (GNU General Public License).
Plugin Version:	4 Jul 2009 (V0.13.2)
Change History:
4 JUL 2009:	Fixed 'can't call method forceAuthentication on undefined value' issue by TWiki:Main.WernerRandelshofer
14 Feb 2008:	Proper packaging and code cleaning by TWiki:Main.StephaneLenclud
30 Aug 2007:	Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.1
CPAN Dependencies:	none
Other Dependencies:	none
Perl Version:	5.005
Benchmarks:	GoodStyle nn%, FormattedSearch nn%, AnyWikiDrawPlugin nn%
Plugin Home:	http://TWiki.org/cgi-bin/view/Plugins/AnyWikiDrawPlugin
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/AnyWikiDrawPluginDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/AnyWikiDrawPluginAppraisal

Related Topics: TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

-- TWiki:Main.WernerRandelshofer - 30 Aug 2007