Much of this description is for the upcoming release, so if you download it to try it be warned!#

This plugin allows a live running JSPWiki to be visualized (much like the TouchGraphWikiBrowser). There are three parts to this:

1. A plugin, which just emits an <applet> tag for:
2. An applet which allows a user to launch the:
3. Swing based visualization application (which can incidentally be used from the commandline if desired).

The visualiztion polls the wiki server for recent changes every update= seconds, so you can watch new pages and links spring into existance on the graph.

Inspiration was taken from the TouchGraphWikiBrowser, code in the graphview package is courtesy of KAON OI-modelerwho heavily refactored and cleaned up the rough & ready TouchGraph code.

Here's what the applet looks like:

And here's a sample screen shot of a mostly empty wiki:

---

Installation#

The VisualizerPlugin is bundled in the attached visualizer.zip must be extracted into your root wiki directory (where the wiki.jsp and other non-template jsp's are located) for the applet and application to be runnable. This will put the needed jar files in an applet accessable place. Also your wiki must have XMLRPC enabled in it's deployment descriptor (WEB-INF/web.xml). The McKessonApsWikiPlugins.jar file (included in the zip) must be present in the root for the visualizer to run even if you don't want the plugins. Putting the McKessonApsWikiPlugins.jar in the root does not enable those plugins for your wiki, it is required for download to the client for the applets use.

Plugin Parameters#

This plugin has a bit more elaborate means of getting parameters beyond simple plugin invocation parameters. See VisualizerDirectivesPlugin for full documentation. There are some basic parameters to use beyond the directives though:

• xmlrpc= - Required, The full url of the WikiRPCInterface to be visualized.
• update= = Optional, polling frequency for updates, default is 10 seconds.
• unreferenced= - Optional, True or False, show unreferenced pages in the visualization. Unreferenced pages float as an island if shown. Defaults to true.
• pages= Optional, fed to a QueryPlugin instance, only pages returned by the query get visualized.

Visualizer Features#

A list of the features supported by the visualizer are kept over on the Visualizer Features page to keep this one shorter.

Visualizer Plugin Discussion#

Please keep most discussion about this plugin on this page.

Thanks...#

I cannot say enough good thigs for the folks who refactored the TouchGraph code for the KAON OI-modeler. The graphview code is quite a nice framework for doing this sort of thing. (I have a thing about clean code, and TouchGraph was a bit ickey, where as KAON's felt like home...)

Bugs#

Two files in the ZIP are world writable!

-r--r--r--    1 root     root         5380 Dez 23 10:22 BrowserLauncher.jar
-rw-rw-rw-    1 root     root       314158 Mär 15 09:59 McKessonApsWikiPlugins.jar
-rw-rw-rw-    1 root     root       234385 Mär 15 09:59 Visualizer.jar
-r--r--r--    1 root     root        59964 Dez 23 10:22 xmlrpc.jar

Please fix that!

---

ContributedPlugins