wiki:GliffyMacro

Embed Gliffy diagrams in wiki pages

Description

This plugin allows you to embed Gliffy diagrams in your Trac wiki pages. Gliffy is an online platform where you can create professional-quality flowcharts, wireframes, UML diagrams and more. The diagram is inlined on the page with an edit link that embeds the Gliffy editor.

When the editor launches, click the "Return to trac" link in the upper right corner to go back to your Trac page. The Gliffy editor will prompt you to save if you have made changes to the diagram.

This plugin requires that you have a gliffy.com account. For API access you may need a paid account.

I haven't tested this with Trac 0.11, so I may need assistance there to make it compatible.

Bugs/Feature Requests

Existing bugs and feature requests for GliffyMacro are here.

If you have any issues, create a new ticket.

defect

0 / 2

Download

Download the zipped source from here.

Source

You can check out GliffyMacro from here using Subversion, or browse the source with Trac.

Installation

  1. Copy oauth.py, gliffylib.py, and GliffyDiagram.py to your wiki-macros directory. For example: /usr/share/trac/wiki-macros
  2. Edit your trac.ini and add a [gliffy] block with 4 settings:
    # example in trac.ini
    [gliffy]
    consumer_key = aaaaaaaaa
    consumer_secret = zzzzzzzzzzzz
    account_id = 1234
    username = youruser@example.com
    

Example

  • Example macro: [[GliffyDiagram(Test Doc 2|ROOT/myfolder)]]
  • Format is: [[GliffyDiagram(filename|folder path|type|size)]]
FilenameRequiredName of doc to edit (if doc doesn't exist it will be created)
folderoptional. default is ROOTFolder path to place document in. Folder must have been previously created on gliffy.com. The path that the Gliffy API uses is a little funny. All user created folders are under ROOT/, so if you create a "Work" folder, then the path you should supply would be: ROOT/Work
typeoptional. default is pngFormat of image to return. Valid values are: png, jpg, svg, xml
sizeoptional. default is MSize of image to inline. Valid values: T, S, M, L

Recent Changes

7116 by jcooper on 2009-11-10 01:57:52
initial commit
7115 by jcooper on 2009-11-10 01:53:03
New hack GliffyMacro, created by jcooper
(more)

Author/Contributors

Author: jcooper
Maintainer: James Cooper
Contributors:

Last modified 5 months ago Last modified on Mar 28, 2016, 1:32:25 PM