| Name | diagram |
|---|---|
| Version | alpha |
| Product Versions | Confluence 2.x |
| Author(s) | Christopher John Gores |
| Homepage | |
| Price | |
| License | BSD |
| JavaDocs | |
| IssueTracking | |
| Download JAR | DiagramMacro-1.0.jar |
| Download Source | DiagramMacro-1.0-src.zip |
Description/Features
I'm staking my claim to the diagram macro for the contest. This marco provides Confluence with funtionality similar to the graph macro in SnipSnap, except it is custom code with no third-party libraries (for now). It translates it's text-based content (i.e. nested parentheses to show object heirarchy) into a pretty node diagram, similar to a flow chart.
Installation
- Simply upload the DiagramMacro-1.0.jar file from the plugin administration page!
Dependancies
- None!
Current features
- parses input text for heirarchy
- draws heirarchy using vertical layout
- nodes have bold title, normal text, and drop shadows
- saves as .png image file
Planned enhancements
- add horizontal layout
- add UML layout
- customizable style (color, node shape, font, etc)
- add table-based parsing option for interoperability with sql macro
Usage
{diagram}
<(> <node name> <[><attribute><:><type><]> <(><child node><)> <)>
{diagram}
Examples
Source macro
{diagram}
(2006
(Q1 (January [CODEGEIST:27 - BDay!])
(February [CODEGEIST:14 - VDay!])
(March [CODEGEIST:17 - St. Pat's!]) )
(Q2 (April) (May) (June) )
)
{diagram}
Actual result
Version History
Still in development... not ready for a release yet.
Open Issues
** Replace $DEV_JIRA_Project_ID with valid project **
{jiraissues:http://developer.atlassian.com/jira/secure/IssueNavigator.jspa?view=rss&&pid=$DEV_JIRA_Project_ID$&summary=true&description=true&body=true&status=1&status=3&status=4&sorter/field=issuekey&sorter/order=ASC&tempMax=25&reset=true&decorator=none|columns=type,key,summary,reporter,status}
{jiraissues}
Screenshots
Screenshots |
|---|
|
Comments (11)
Jan 21, 2006
Mike Cannon-Brookes says:
Chris, Apologies. I had the permissions wrong, anyone can create attachments no...Chris,
Apologies. I had the permissions wrong, anyone can create attachments now
Look forward to your entry!
Cheers,
Mike
Jan 21, 2006
Christopher John Gores says:
Thanks... I can post pics now. However, this being a contest, I probaby wo...Thanks... I can post pics now. However, this being a contest, I probaby won't attach the source (and code?) until the last minute, unless I can somehow do it privately. I will keep it up-to-date with current progress/screenshots, however!
Jan 21, 2006
Bob Swift says:
Very good idea. I take it you are not planning to use the Graphviz support for ...Very good idea. I take it you are not planning to use the Graphviz support for this? I would vote for the table based support. I assume you mean something like the way the chart macro takes a table as input allowing the table to be created by a number of other macros (sql, csv, excel, java scripting). We use scripting and Graphviz today to read a database table to produce relationships graphs although it might have been done more generally as a relationship table (node, relationship, node) potentially with adding attribute columns as well.
Jan 21, 2006
Christopher John Gores says:
Thanks! Yes, I'm planning to keep the code 100% custom Java (which mak...Thanks! Yes, I'm planning to keep the code 100% custom Java (which makes it fun for me), unless I hit a wall. The current class that did the work (above) is just 6k, so I hope to keep it small and tight. My primary goal is to make it easy to diagram new things, esp. basic UML. A secondary goal is to make it SnipSnap graph compatible so it can used by the SnipSnap importer.
Yes again to the "table as input" question. I'm thinking the macro params would take column indexes for name, attribs, and optional parent (the attrib syntax defines other relations, i.e "[orders:Order#0..*]".
Mar 15, 2006
Guy Fraser says:
It would be uber-cool if you could link the panels to pages or URL's using wiki ...It would be uber-cool if you could link the panels to pages or URL's using wiki notation - ie. instead of using [whatever] for the additional text in an item, it would be used to define a link using wiki notation (ie. output an image map). I assume you already know the co-ords and dimensions of each panel, so it should be relatively straightforward to do. Imagine the cool things that could lead to! You'd be able to do graphical site maps
Also, will there be any way to set the colors of the panels?
Mar 16, 2006
Guy Fraser says:
Oooh... Just had another thought - can you add a param for wiki notation parsing...Oooh... Just had another thought - can you add a param for wiki notation parsing? For example, you could use the {children} macro in the boy of the macro - or indeed anything that outputs an unordered list, and use that to define the chart
Imagine how cool that would look - instant graphical site map without the need for messy external libraries...
Mar 19, 2006
Christopher John Gores says:
Great ideas, but unfortunatley with my schedule the last couple of months I have...Great ideas, but unfortunatley with my schedule the last couple of months I haven't gotten back to this project. I was going to work on this today and was just implementing the color and font configurations, but I just realized that "11:59 on March 19" really means 7am my time! So I just packaged up what I have.
Jun 23, 2006
Cameron Moore says:
We're currently using this plugin to document some folder structures on our netw...We're currently using this plugin to document some folder structures on our network. It's working great, but I have a couple feature requests.
It would be nice if there was an option to tell the diagram to render top-down instead of left-right. It would look very similar to what you have now, but the line connecting the parent to the child would exit the parent object from the bottom instead of from the right, similar to a folder tree view.
I haven't checked to see if this is feasible or not, but it would be cool if you could create what amounts to an imagemap with the diagram to show tooltips for objects in the diagram. We would like to use a tooltip as a "description" for an object/folder since adding it into the rendered image would take up way too much space.
Thanks
Sep 27, 2006
Guy Fraser says:
Any chance this plugin could be added to the repository? It's a nice plugin and ...Any chance this plugin could be added to the repository? It's a nice plugin and should definately be in there
Jan 19, 2007
Clark Jackson says:
I noticed that the fact that brackets are used to specify text in the "diagram" ...I noticed that the fact that brackets are used to specify text in the "diagram" macro makes them show up in the Browse Space>Undefined Pages area.
For example:
{diagram}
(idSystemLoadCPData(idLoads [Date/Time]))
{diagram}
"Date/Time" will show up as an undefined page in the Browse Space>Undefined Pages area. The "Undefined Pages" feature is a great help and it's usefulness is greatly compromised by this bug.
The diagram macro is very useful. I need them both to work.
Thanks! Clark
Jun 03, 2008
preeti jain says:
Hi , I want to build a diagram showing a hierarchial relationship using Diagram...Hi ,
I want to build a diagram showing a hierarchial relationship using Diagram Macro . I hereby , want to add URL in each of my step in the hierarchial structure and also i want to expand and collapse the sub node structure from parent node . Can anyone please tell me a way to do the same ?