This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description


TracBlockdiag is a trac plugin that integrate blockdiag series into wiki pages. It’s provide wiki macros for blockdiag, seqdiag, actdiag, nwdiag and rackdiag.

This software is available under the MIT license.


TracBlockdiag has several features.

  • Support almost blockdiag features (fontmap is not supported).
  • Support PNG/SVG output (SVG support is Trac 0.12 only).
  • Fastest wiki rendering.
  • Multi thread/process safe.
  • Check installed blockdiag series and provide only supported macros.
  • Don’t create temporary file.


  • Python >= 2.5
  • Trac >= 0.11

If you need all features, you must use Trac 0.12 or later.


First, clone the repository.

$ git clone
$ cd TracBlockdiag

Then, you can install globally

# python install

or install to a specific Trac environment.

$ python bdist_egg
$ cp dist/*.egg /path/to/tracenv/plugins

Moreover, you must install blockdiag series which you want to integrate. For example, below command will install all blockdiag series (rackdiag is currently included in nwdiag).

$ pip install blockdiag seqdiag actdiag nwdiag

Optionally, you can use blockdiag plugins. If you need a plugin, you simply install it. For example, below command will install new shapes.

$ pip install blockdiagcontrib-cisco


If you are not familiar with blockdiag, you should read the blockdiag documentation first.

for Trac 0.12 or later

Macro synopsis like this:

{{{#!(block|seq|act|nw|rack)diag [type=(png|svg)] [IMG_TAG_ATTR=VALUE ...]

You can write blockdiag source text as a wiki macro like below.

  A -> B -> C;
       B -> D;

You can specify output format and width.

{{{#!blockdiag type=svg width=800px
  A -> B -> C;
       B -> D;

for Trac 0.11

Macro synopsis like this:


In Trac 0.11, macro arguments is not supported. So, all diagrams are generated with the format specified in default_type option.

You can write blockdiag source text as a wiki macro like below.

  A -> B -> C;
       B -> D;


TracBlockdiag has several configuration parameters. These parameters are specify in [tracblockdiag] section of the trac.ini config file. These parameters are defined as follows.

name type default description
font string array (auto) Paths to font file which are used in PNG generation.
cachetime int 300 Time in seconds which the plugin caches a generated diagram in.
gc_interval int 100 The number of diagram generation. Unused cache is cleared every this count.
default_type string svg Default diagram type to generate.
syntax_check bool True Check syntax of source text and show error insted of 500 response. Note that when using syntax check, the performance is slightly down.
fallback bool False Fallback to png image when a browser is not support svg. Note that using fallback causes double image generation because major browsers request png image whether svg rendering succeeded or not. So, enabling this option may causes high load.


0.2.1 (2012-02-26)
  • fix issue on setup from PyPI
0.2.0 (2012-01-21)
  • change default type from png to svg
  • add option for default type
  • add option to enable syntax checking for detailed error
  • support fallback to png if a browser doesn’t support svg
  • fix bug which generating incorrect diagram when there are multiple diagrams in one page
0.1.1 (2012-01-12)
  • fix bug when source text contains unicode
  • fix bug which drawing incorrect font while png rendering
0.1.0 (2012-01-11)
  • first release
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
TracBlockdiag-0.2.1.tar.gz (6.7 kB) Copy SHA256 Checksum SHA256 Source Feb 26, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting