wiki:GraphvizPlugin

Graphviz for dynamic generation of diagrams

Description

This is a plugin that allows the dynamic generation of diagrams by Graphviz programs. The text of a wiki page can contain the source text for Graphviz and the web browser will show the resulting image.

Bugs/Feature Requests

Existing bugs and feature requests for GraphvizPlugin are here.

If you have any issues, create a new ticket.

Be sure to mention which version of Trac and which version of the plugin you are using. If the version number ends with dev, then please also specify the changeset number corresponding to the version you are using.

defect

56 / 81

enhancement

21 / 31

task

1 / 2

Source and Download

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

Or you can download the zipped source from here. Note that this contains everything regarding the Graphviz plugin including tagged releases and branches. The 0.10 directory contains the latest released version of the code for Trac 0.10 and the 0.11 directory contains the latest code for Trac 0.11.

  • download latest stable version (0.7.5) for Trac 0.11.
  • download latest version for Trac 0.10.

That version has some trouble with rsvg support for creating anti-aliased images. The upcoming version contains a few related fixes:

  • download latest unstable version for Trac 0.11 and later.
  • download latest unstable version for Trac 1.0

If you want to have anti-aliased images, it might be a better option anyway to get/build a recent version of graphviz tools, which support producing anti-aliased images directly, through pangocairo support.

Installation

  1. A prerequisite for installation are the programs from http://www.graphviz.org.
  2. Install
  3. Restart your web server (this example command line for Apache on Ubuntu):
    [sudo] /etc/init.d/apache2 restart
    
  4. Enable the plugin:
    • by updating your trac.ini with this:
      [components]
      ...
      graphviz.* = enabled
      ...
      
    • or accessing your Admin panel ( ..admin/general/plugins ).
  5. Configure your environment:
    • by modifying your trac.ini file.
    • by accessing your Admin panel case you have WebAdminPlugin enabled.

Example

Add the following lines to a wiki page:

{{{
#!graphviz
digraph G {Hello->World->Graphviz->Rules}
}}}

and that would produce an image as follows:

Sample outout from the graphviz plugin, produced with graphviz-2.20.3 with pangocairo support

Note that you can insert TracLinks like this:

{{{
#!graphviz
  digraph G {
    rankdir = "LR"
    GraphvizPlugin [ URL=GraphvizPlugin ]
    Trac [ 
      URL="http://trac.edgewall.org/"   
      fontcolor=red
    ]
    GraphvizPlugin -> Trac
    }
}}}

This produces an image like this, but with clickable nodes (note that nodes aren't actually clickable in this example):

second example, this time with colour and TracLinks, also produced with graphviz-2.20.3 on Linux

More examples at: http://www.graphviz.org/Gallery.php

Recent Changes

15369 by cboos on 2016-02-28 14:30:32
GraphvizPlugin: restart trunk based on 1.0 branch (1.0.0.8). Refs #11155.
15368 by cboos on 2016-02-28 14:29:10
GraphvizPlugin 1.0: do a bit of clean-up for the headers and meta data.
15367 by cboos on 2016-02-28 14:15:41
GraphvizPlugin 1.0: fix an UnicodeDecodeError when reading back the map info
(more)

Author/Contributors

Author: pkropf
Maintainer: Christian Boos
Contributors: cboos

Last modified 6 weeks ago Last modified on Mar 25, 2016, 8:27:12 AM

Attachments (4)

Download all attachments as: .zip