Extension:AnyWikiDraw

From MediaWiki.org

Jump to: navigation, search
Manual on MediaWiki Extensions
List of MediaWiki Extensions
AnyWikiDraw drawing editor

Release status: experimental

Implementation Parser functions, Page action
Description Allows to edit SVG, PNG and JPEG images directly in a page using a Java applet.
Author(s) Werner Randelshofer
Version 0.10
MediaWiki 1.7
Download http://sourceforge.net/projects/anywikidraw

Contents

[edit] What can this extension do?

The AnyWikiDraw extensions adds a {{#drawing:}} tag to the MediaWiki parser which allows to edit SVG, PNG and JPEG images directly in a page using a Java applet.

This extension is also available for PmWiki and TWiki.

[edit] Usage

The tag has the following form:

{{#drawing:image.svg|width|height}}

  • The tag needs to be put into two curly braces.
  • The name of the tag is #drawing:
  • The parameter image.svg specifies the name of the image file. If you specify an image file that does not yet exist in your Wiki, the image is created the first time you save a drawing.
  • The image name may have one of the following extensions: svg, svgz, png, jpg.
  • The parameter width specifies the width of the image
  • The parameter height specifies the height of the image

To draw the image HappyWiki.svg with a width of 400 pixels and a height of 300 pixels on a page, insert the following tag:

{{#drawing:HappyWiki.svg|400|300}}

[edit] Installation

  1. Copy the AnyWikiDraw folder into the extensions folder of your MediaWiki installation.
  2. Change the LocalSettings.php file as described below.

[edit] Changes to LocalSettings.php

require_once("$IP/extensions/AnyWikiDraw/AnyWikiDraw.php");


[edit] To Do

This extension is in experimental state, because its functionality is incomplete, and because there are some known issues:

[edit] Missing functionality

  • Support for the ODG file format is missing. ODG is the Open Document Drawing format used by Open Office, Neo Office and other open source office programs.
  • Support for the TWikiDraw and PmWikiDraw file formats is missing.
  • SVG Color gradients are displayed but can not be edited.
  • SVG Markers are not yet supported.
  • The offline version of AnyWikiDraw is missing.

[edit] Known issues

  • Does not work with current version (1.11) of MediaWiki.
  • Images are not refreshed when they are saved. We need either find a way to clear the image cache of the browser, or to deliver images without letting the browser cache them.
  • Pages which use the drawing tag are not listed as linking to the image file.
  • It is not clear, how we can add support for image formats like ODG .odg, TWikiDraw .draw an PmWikiDraw .draw. For these file formats MediaWiki can not render a thumbnail image. Of course, the AnyWikiDraw Applet can render the thumbnail image, and even passes it to the server. But there seems to be no way to 'convince' MediaWiki to use this thumbnail image.
Personal tools