Mediawiki SvGViz extension

Definition

SvGViz is a mediawiki extension to visualize the links in a page with SVG.

Have a look the toolbox to your left and click on "Visualize this article with SVG". This menu item is available for all regular wiki pages.

Compatible browsers

It has been tested with :

• Firefox (not too old versions) on Win, Mac (?) and Linux
• With IE 6/7 on Windows using the Adobe SVG plugin. Note: You may have trouble installing this plugin on IE 7.
• With Opera 9.2x on Windows

Mediawiki versions

• SvGViz runs with 1.10, but should also run with 1.8 and 1.9 (it will not run with older versions since SvGViz relies on a given database architecture for links extraction).

• SvGViz also relies on the MonoBook Skin/Theme (the one you see here). It is needed to insert the menu item into the toolbox menu and uses a theme-specific hook. Else you have to hack the skins files or make chances to the source code.

Source and status

You can grab the source zip file, license is GPL, no warranty.

Status

This is unsupported beta software.

Romain Sauvain did this project for one of my classes. The links extractor has been developed by Urs Richle for an earlier project, the JavaViz extension.

The future of this extension is not clear for now - Daniel K. Schneider 20:00, 27 June 2007 (MEST). But it's a GPL license ... so if you make signification contributions and redistribute another copy somewhere (e.g. on Mediawiki), please let us know.

Documentation

Here is copy of the readme file:

++++++++++++++++++++++++++++
WikiViz: Installation guide
++++++++++++++++++++++++++++

+----------------------------------------------------------------------+
| SVGViz, a MediaWiki(1.9.3) extension                                 |
+----------------------------------------------------------------------+
| Copyright (C) 2007  Romain Sauvain                                   |
+----------------------------------------------------------------------+
| This program is free software; you can redistribute it and/or
| modify it under the terms of the GNU General Public License
| as published by the Free Software Foundation; either version 2
| of the License, or (at your option) any later version.
|
| This program is distributed in the hope that it will be useful,
| but WITHOUT ANY WARRANTY; without even the implied warranty of
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
| GNU General Public License for more details.
|
| You should have received a copy of the GNU General Public License
| along with this program; if not, write to the Free Software
| Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
| MA  02110-1301, USA.
+----------------------------------------------------------------------+
| Author: Romain Sauvain <romain.sauvain@a3.epfl.ch>                   |
+----------------------------------------------------------------------+
SVGViz is an extension for the MediaWiki platforme. (http://www.mediawiki.org/wiki/MediaWiki)
SVGViz creates a specific visualization of the MediaWiki semantic content diplayed with SVG

ATTENTION: SVGViz requires PHP 5!
++++++++++++++++++++++++++++++++++
SVGViz-Installation
++++++++++++++++++++++++++++++++++

PLACEMENT

1) download SVGViz zip, unpack and put the SVGViz package into the
   directory "extensions". Do not change the name of the directories
   or files.

2) put the follwing lines into the file "LocalSettings.php" (just after
   "require_once ("includes/DefaultSettings.php")" or at the end of
   the script)

# SvgViz Extension
require_once("extensions/SvgViz/SvgViz.php");

3) Sets the permissions of the "tempfiles" directory to "write", so
   that Php would be able to create temporary files in this directory.


DEFINE PATH AND GLOBALS

4) Open the file "define.php" in the directory "includes" of SVGViz
   (go to "SVGViz" directory and find "includes" directory there).

5) Define your default selected Node name: open the script
   "define.php" in the directory "includes" - define the global
   variable "$initialNodeName" with your default Node-name.

VIEW

6) Go to specialpages on MediaWiki. You will find "SVGViz" in the
   list. You should also have link called "Visualise this article" in
   your left menu.

IF SOMETHING GOES WRONG (added by DKS / June 26)

There may be a problem with wikiproject.php, i.e. definition of file
and URL pathes (look at the beginning and the end of the file).

At TECFA we have the following setup (file LocalSettings.php):

$wgScriptPath	    = "/mediawiki";
$wgScript           = "$wgScriptPath/index.php";
$wgRedirectScript   = "$wgScriptPath/redirect.php";

# DKS 3/2006
$wgArticlePath      = "/en/$1";

$wgStylePath        = "$wgScriptPath/skins";
$wgStyleDirectory   = "$IP/skins";
$wgLogo             = "$wgStylePath/monobook/tecfa/wiki.png";

$wgUploadPath       = "$wgScriptPath/images";
$wgUploadDirectory  = "$IP/images";

Apache httpd.conf looks like this:

Alias /mediawiki "/data/portails/mediawiki"
Alias /en "/data/portails/mediawiki/index.php"
Alias /en/index.php "/data/portails/mediawiki/index.php"