nwdiag の概要

機能

  • テキストファイルからネットワーク図を生成
  • 日本語(UTF-8)対応
  • Sphinx 文書への埋め込み (sphinxcontrib-nwdiag パッケージの利用)

インストール

easy_install を利用する場合

以下のコマンドでインストールすることができます。

$ sudo easy_install nwdiag

buildout を利用する場合

以下のコマンドでインストールすることができます。

$ hg clone http://bitbucket.org/tk0miya/nwdiag
$ cd nwdiag
$ python bootstrap.py
$ bin/buildout

Copy and modify ini file. example

$ cp <nwdiag installed path>/nwdiag/examples/simple.diag .
$ vi simple.diag

書式の詳細については nwdiag 出力サンプル を参照してください。

実行方法

コマンドラインで nwdiag コマンドを実行します。

$ nwdiag simple.diag
$ ls simple.png
simple.png

SVG 形式で出力したい場合は -T オプションを利用します。

$ nwdiag -Tsvg simple.diag
$ ls simple.svg
simple.svg

フォント設定

nwdiag は文字の描画に TrueType フォントを利用します。指定がない場合 nwdiag は自動的にフォントを検索しますが、フォントが見つからない場合もしくはフォントを指定したい場合は-f (-font) オプションを利用します。

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

もし常に同じ設定を利用する場合は $HOME/.blockdiagrc に以下の記述をするとよいでしょう。

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

事前に入れておくべきソフトウェア

  • Python 2.4 以降 (3.x は未対応)
  • Python Imaging Library 1.1.5 以降
  • funcparserlib 0.3.4 以降
  • setuptools もしくは distribute

ライセンス

Apache License 2.0