Introduction of blockdiag

Features

  • Generate block-diagram from dot like text (basic feature).
  • Multilingualization for node-label (utf-8 only).
  • Sphinx embedding (using sphinxcontrib-blockdiag package)

Setup

Install with pip:

$ pip install blockdiag

Or with easy_install:

$ easy_install blockdiag

If you want to export as PDF format, give pdf arguments

$ easy_install "blockdiag[pdf]"

Usage

Execute blockdiag command

$ blockdiag simple.diag
$ ls simple.png
simple.png

If you want SVG images or PDF images, use -T option

$ blockdiag -Tsvg simple.diag
$ ls simple.svg
simple.svg
$ blockdiag -Tpdf simple.diag
$ ls simple.pdf
simple.pdf

Font Configuration

blockdiag uses TrueType Font to render text. blockdiag try to detect installed fonts but if nothing detected, You can specify fonts with -f (–font) option

$ blockdiag -f /usr/share/fonts/truetype/ttf-dejavu/DejaVuSerif.ttf simple.diag

If you always use same font, write $HOME/.blockdiagrc

$ cat $HOME/.blockdiagrc
[blockdiag]
fontpath = /usr/share/fonts/truetype/ttf-dejavu/DejaVuSerif.ttf

Requirements

  • Python 2.6, 2.7, 3.2, 3.3 or later
  • Pillow 2.2.1 or later.
  • funcparserlib 0.3.6 or later.
  • setuptools or distribute.

License

Apache License 2.0