| Name | hypergraph |
|---|---|
| Version | 1.0 |
| Product Versions | 2.x |
| Author(s) | Steve Terry |
| Homepage | |
| Price | Free |
| License | BSD |
| JavaDocs | |
| IssueTracking | |
| Download JAR | hypergraph-plugin.jar |
| Download Source | hypergraph-plugin.zip |
Description/Features
Displays a Hypergraph of the Space page hierarchy drawn using an applet from Jens Kanschik's Hypergraph Project at Sourceforge.
Usage
Installation
requires hyperapplet.jar and GraphXML.dtd files be placed in the Confluence webapp/images directory.
It also appears to work better if the hypergraph-plugin.jar is loaded into the WEB-INF/lib directory and Confluence is restarted
Parameters
toggle parameter will place a hide/show toggle switch to the upper left of the applet value is either true or false
width parameter will take percent value or integer value default is 100%
height parameter will take percent value or integer value default is 300
| parameter | value | required | default |
|---|---|---|---|
| width | int value or % |  |
100% |
| height | int value or % | |
300 |
| toggle | true or false | |
false |
Warnings
- does not like to be nested in other macros
- Firefox does not like toggle switch. It forces an applet refresh with no GraphXML file available.
- Some differences in behavior with back button between Standalone installation and war deploy for Confluence
Examples
{hypergraph}
{hypergraph:width=80%|height=300}
{hypergraph:width=80%|height=300|toggle=true}
Version History
Screenshots
Screenshots |
||
|---|---|---|
|
|
|
|
|
|
Comments (42)
Jul 06, 2006
Damian Fawkner says:
An excellent tool - if only I can get it to work I've installed it, so that Pl...An excellent tool - if only I can get it to work
I've installed it, so that Plugin Manager tells me that it is there and enabled, yet I'm not seeing anything (all I see is a grey box) (using
I'm running Confluence 2.2.1a. I've copied hyperapplet.jar and GraphXML.dtd into the Confluence/images directory and copied the hypergraph-plugin-1.0.jar into the confluence/WEB-INF/lib.
I don't see any errors coming in in Tomcat (4.1) logs, so I'm not sure what's going on
Must admin I am curious why a jar file would be copied into the images directory, but that's another story...
Any ideas, things I can check etc...??
Jul 11, 2006
Agnes Ro says:
Could you please check that you have correctly installed the plugin in the Admin...Could you please check that you have correctly installed the plugin in the Admin section and also that it is enabled?
Agnes.
Aug 18, 2006
patrice saint-louis says:
Followed the instructions - I m getting the errors below. Cause: bucket.core....Followed the instructions - I m getting the errors below.
Cause:
at com.atlassian.confluence.util.XWorkTransactionInterceptor.intercept(XWorkTransactionInterceptor.java:151)
at java.lang.ClassLoader.defineClass0(Native Method)
Stack Trace: [hide]bucket.core.InfrastructureException: java.lang.UnsupportedClassVersionError: org/lcra/confluence/plugin/hypergraph/HypergraphMacro (Unsupported major.minor version 49.0)
at com.atlassian.confluence.util.XWorkTransactionInterceptor.intercept(XWorkTransactionInterceptor.java:151)
at com.opensymphony.xwork.DefaultActionInvocation.invoke(DefaultActionInvocation.java:165)
at com.opensymphony.xwork.interceptor.AroundInterceptor.intercept(AroundInterceptor.java:35)
at com.opensymphony.xwork.DefaultActionInvocation.invoke(DefaultActionInvocation.java:165)
at com.opensymphony.xwork.DefaultActionProxy.execute(DefaultActionProxy.java:115)
at com.opensymphony.webwork.dispatcher.ServletDispatcher.serviceAction(ServletDispatcher.java:229)
at com.opensymphony.webwork.dispatcher.ServletDispatcher.service(ServletDispatcher.java:199)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:802)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:252)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:173)
at com.opensymphony.module.sitemesh.filter.PageFilter.parsePage(PageFilter.java:118)
at com.atlassian.confluence.util.profiling.ProfilingPageFilter.parsePage(ProfilingPageFilter.java:143)
at com.opensymphony.module.sitemesh.filter.PageFilter.doFilter(PageFilter.java:52)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:202)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:173)
at com.atlassian.confluence.util.ServletContextThreadLocalFilter.doFilter(ServletContextThreadLocalFilter.java:30)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:202)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:173)
Aug 18, 2006
Steve Terry says:
there is a version conflict between jdk used to compile the classes and the one ...there is a version conflict between jdk used to compile the classes and the one you are using. Are you using 1.4 or 1.5.
Jul 12, 2006
Steve Terry says:
I made slight mods to the plugin and tested with the standalone version of Confl...I made slight mods to the plugin and tested with the standalone version of Confluence 2.2.6a using the instructions above. Download the new hypergraph-plugin.jar and install as described. The same issues exist with the toggle and nested in macros.
Jul 26, 2006
Roshan Jhunja says:
This is really neat! Got it to work ... keep getting an -unable to find...This is really neat! Got it to work ... keep getting an
-unable to find '/display/<SpaceName>/sitemap.prop' -
error though - unless I create a dummy sitemap.prop page in the space ... and it goes away. What is this about?
Jul 26, 2006
Steve Terry says:
It looks like I left a reference to the global properties file in the applet tag...It looks like I left a reference to the global properties file in the applet tag
see this page http://hypergraph.sourceforge.net/propfiles.html at Jens Kanschik's project site for more information on properties files.
Aug 18, 2006
Wes Thompson says:
I am still confused. I see only a grey box (in IE6) where the hypergraph s...I am still confused. I see only a grey box (in IE6) where the hypergraph should be. I have also tried to see the page in Mozilla (shows an Icon and the grey box) with no luck.
I am running Confluence 2.2.8 Standalone. I placed the following files in the following directories
r-I checked the Confluence admin plugin panel and the hypergraph plugin is installed and active
I have looked at the source html in the web browser and found the applet tag
I checked that my browser could access /images/hyperapplet.jar and =/download/temp/space17.xml?contentType=text/xml&delete=true (it could download both).
Additional info from the admin section of Confluence
Any help/pointing in the right direction/etc on debugging this problem is greatly appreciated.
Aug 18, 2006
Steve Terry says:
I would first check the java console to see if some exceptions were thrown. You ...I would first check the java console to see if some exceptions were thrown. You can find it from your browser - IE under Tools -> Sun Java Console. It sounds like the applet is failing to initialize. I am only guessing with out looking at more info.
I would also get someone else to try and access the page to make sure it is not a desktop jvm problem.
I will setup 2.2.8 standalone and see if I can recreate the problem.
Aug 22, 2006
Wes Thompson says:
My corporate environment uses Microsoft VM so my path to the Java error log is s...My corporate environment uses Microsoft VM so my path to the Java error log is slightly different than prescribed.
First, I enabled Java logging, JIT compiler, and script debugging in IE6 (Tools->Internet Options->Advanced). I then had to restart IE6 and opened the script debugger (View->Script Debugger->Open). Here is the output of the debugger.
Aug 23, 2006
Wes Thompson says:
Follow-up note: I tried to access a page with a hypergraph o...Follow-up note: I tried to access a page with a hypergraph on two different computers with IE6. They both have the same problem. I then accessed the same page with Mozilla on a Linux box through an X-Session and it also showed only a grey box.
Oct 12, 2006
P. Payette says:
I too am seeing a gray box and getting the same error on Windows with IE7. IE7 i...I too am seeing a gray box and getting the same error on Windows with IE7. IE7 is showing "load: class hypergraph.applications.hexplorer.HExplorerApplet not found" error in the bottom bar. (where should that file be found?)
Oct 12, 2006
Guy Fraser says:
Might be time to upgrade to a browser that actually works, is secure, faster and...Might be time to upgrade to a browser that actually works, is secure, faster and open standards compliant: http://www.mozilla.com/firefox/
By running IE you ensure that your computer is less secure, your web browsing experience far less reliable (and slower) and if your organisation mandates the use of IE you're adding about 60% to the costs of any custom web applications you get developed. It never ceases to amaze me how people use a truly awful web browser (internet exploder) and then complain to plugin devs about it not working. Get Firefox and tell everyone you know to do the same
If you want to keep using IE, then please also upgrade your OS to Vista for the worst possible experience.
Oct 12, 2006
P. Payette says:
Agreed, (although using IE6 is a standard for our company ). But no luck w...Agreed, (although using IE6 is a standard for our company
). But no luck with Firefox either: it displays a plugin update message, then tries to install JRE5 and miserably fails since it is already installed. Any other suggestion?
Oct 12, 2006
Guy Fraser says:
It's possible that a recent version of Confluence (there's been about 3-4 versio...It's possible that a recent version of Confluence (there's been about 3-4 versions released since this plugin was made if memory serves) might have changed something that's causing the plugin not to be able to locate it's required libraries. Adaptavist submitted a patch for the plugin loader which that allows dependant libraries to be bunded in the plugin jar for easier deployment and reliability - it might be worth the author of this plugin taking advantage of that feature (which became standard in Confluence 2.2 I think) if he's still around....
Oct 12, 2006
P. Payette says:
Also, been desperate for a vizualisation solution for a long time ([CON...Also, been desperate for a vizualisation solution for a long time ([CONF-6676]) to view/navigate our wiki content, either with a built-in tool, plugin, or through XML-RPC. Still trying to get something to work, but in vain. Any other suggestion would be appreciated.
Oct 12, 2006
Guy Fraser says:
Would 2D visualisation be ok? If so, do you have any specific requirements for w...Would 2D visualisation be ok? If so, do you have any specific requirements for what needs to be shown and how you want to interact with it?
Oct 12, 2006
P. Payette says:
We need not only parent-children, but also internal links inter-relations. This ...We need not only parent-children, but also internal links inter-relations. This is why 2D is not enough. 3D is needed at a minimum, and 4D (with timeline) enabling to see the graph according to page dates will definitely be needed as wikis become older and pages become obsolete. Vizualisation tools can get complex and go beyond the scope of Confluence, but having a basic built-in feature would be nice, or having Confluence dynamically generate 3Dgraph format file would allow us to integrate third-party tools (see XML-RPC TouchGraphWikiBrowser) . In that sense, Hypergraph does a really good job as it can be included into the wikipage itself. If only I could get it to work.
Oct 13, 2006
Steve Terry says:
I have been looking at visualization solutions as well. Currently unless you use...I have been looking at visualization solutions as well. Currently unless you use applets or adobe's SVG viewer or some ActiveX control there is no way to get interactive graphs in the web page. You could possibly craft a Javascript library for this . I was unable to find one anything helpful in the open source world.
The link here shows how 3D SVG would look and I considered using it but adobe doesn't seem to be supporting the svg viewer. You have to install the SVG viewer before you can view the examples [svg examples|http://www.adobe.com/svg/examples.html]. Try the Chemical Markup example for true 3D interaction.
Hypergraph could be used to display a graph.xml inserted into the macro itself, uploaded as an attachment or generated from page labels, referring links ect, ect.
Oct 13, 2006
Guy Fraser says:
We've been looking to develop a Flash based navigator but having assessed the ti...We've been looking to develop a Flash based navigator but having assessed the timescales and costs required for development gave up on the idea
We've got all the ideas ready as to what we want it to do, it just costs too much. Obviously, if someone was willing to help contribute funds towards development we'd be able to give it a go...
Oct 13, 2006
P. Payette says:
Finally starting to work after: re-installing java, adding dummy sitemap.prop...Finally starting to work after:
Yet 2 things:
Oct 12, 2006
Guy Fraser says:
On the linux box you probably need to upgrade your JRE to 1.5On the linux box you probably need to upgrade your JRE to 1.5
Oct 12, 2006
patrice saint-louis says:
I am having the same problem like the first comment in the beginning of th...I am having the same problem like the first comment in the beginning of this thread where the author asked what JDK is used. I am using 2.2.1. with JDK 1.4.2_06. Do I need anything else?
Oct 13, 2006
Steve Terry says:
I have noticed that a lot of people are having applet loading problems. I have d...I have noticed that a lot of people are having applet loading problems. I have done some investigation but I am limited to versions of software available to me.
First. Use Sun's plugin for the browser. I use the latest 1.5 and update it when a new release comes out. Microsoft itself tells users to Sun's JRE plugin for the desktop when having applet problems.
IE 6.0.2900.2180_xpsp_sp2 works
FireFox 1.5.0.7 works as did previous versions
On the serverside I'm using JDK 1.5.0_03 for Confluence.
Second. All the plugin does is generate an xml file to be read by the applet. I have uploaded a test pack hypergraph_test.zip for testing your browser desktop config in isolation. Unpack the zip somewhere and open up test.html in your browser.
This should tell if your browser and java runtime can handle the applet.
You should see
If you do not see the applet (get a grey box or an X) open Sun's plugin console and check for error messages.
If this is working and the applet still fails to load from Confluence download there may be some proxy settings or browser settings interfering with the applet call.
You may also test a download directly from the browser by looking at the applet parameters in the html. ie.
See if you can download the hyperapplet.jar with http://yourhost/confluence/images/hyperapplet.jar (for war install) might need to modify for standalone install.
Check to see if the spaceXXXX.xml is still on the server. Confluence deletes this file if a successful request takes place.
Other than this I don't have any answers for configuration problems on the desktop.
Oct 13, 2006
patrice saint-louis says:
Thanks - I installed the latest jdk & jre. It works for me both in IE...Thanks -
I installed the latest jdk & jre. It works for me both in IE and firefox.
However, I keep getting this popup. Can I correct it?
Oct 13, 2006
Steve Terry says:
I need to remove or fix the output but until then a work around was found by ano...I need to remove or fix the output but until then a work around was found by another user
dummy sitemap.prop page in the space ... and it goes away.
Oct 13, 2006
patrice saint-louis says:
Thanks - it works in my personal space. When I put a test page in another space...Thanks - it works in my personal space.
When I put a test page in another space that has more pages - i get this error.
Oct 13, 2006
P. Payette says:
Getting better but still some bugs: Had the problem above until I refreshed...Getting better but still some bugs: Had the problem above until I refreshed Confluence: I assume the new sitemap.prop page needs a few seconds to be indexed and do it job. But then I get another error stating that the applet cannot download the XML file..."Starting with the default graph". Java also freezes the browser if asked to refresh. It must be a path issue with my Confluence since the standalone test applet works fine.
Oct 13, 2006
Steve Terry says:
This is definitely an error in the xml that was formed. Hypergraph works with m...This is definitely an error in the xml that was formed.
Hypergraph works with most macros(not all) on the same page but it does not like being nested with any other macros.
Oct 13, 2006
P. Payette says:
I identified one problem: deleted ampersands in some page titles (&, like R&...I identified one problem: deleted ampersands in some page titles (&, like R&D or P&L for example), and the graph now displays correctly. Since ampersands are a permitted character in Confluence's titles, the plugin should be modified to ignore them (and any other such permitted character).
Oct 13, 2006
P. Payette says:
...and the same problem goes for space names: our R&D space, regardless of p......and the same problem goes for space names: our R&D space, regardless of page titles, will not render the graph.
Oct 14, 2006
Steve Terry says:
I'll look into changing the way the xml is built and make it safe for the Hyperg...I'll look into changing the way the xml is built and make it safe for the Hypergraph library which does all the xml parsing.
Oct 16, 2006
P. Payette says:
That would be great! Also, if I may suggest, fixing the "Back" button a...That would be great! Also, if I may suggest, fixing the "Back" button as well as adding a new "toggleDefault=off" parameter (to make the graph invisible by default) would allow us to add Hypergraph to our prod deployment without upsetting old-school users with "futuristic" interfaces (or so they may think) ...