blockdiagのインストール

ブロック図生成ツール blockdiagのインストールは以下のコマンド

pip install sphinxcontrib-actdiag sphinxcontrib-blockdiag sphinxcontrib-nwdiag sphinxcontrib-seqdiag

準備としてconf.pyの編集も必要。以下の内容の追加が必要。

extensions = [
  'sphinxcontrib.blockdiag' ,
  'sphinxcontrib.seqdiag'   ,
  'sphinxcontrib.actdiag'   ,
  'sphinxcontrib.nwdiag'    ,
  'sphinxcontrib.rackdiag'  ,
  'sphinxcontrib.packetdiag',
]
blockdiag_html_image_format  = 'SVG'
seqdiag_html_image_format    = 'SVG'
actdiag_html_image_format    = 'SVG'
nwdiag_html_image_format     = 'SVG'
rackdiag_html_image_format   = 'SVG'
packetdiag_html_image_format = 'SVG'

ブロック図内で日本語を使うにはフォントパスの設定が必要でこれもconf.pyで設定する。

Windows Subsystem for Linux環境ではWindowsのフォントが使用できる。パス、設定例は以下の通り。 ブロック図、シーケンス図、アクティビティ図、ネットワーク図それそれで設定が必要。

blockdiag_fontpath = '/mnt/c/Windows/Fonts/meiryo.ttc'
seqdiag_fontpath   = '/mnt/c/Windows/Fonts/msgothic.ttc'
actdiag_fontpath   = '/mnt/c/Windows/Fonts/msgothic.ttc'
nwdiag_fontpath    = '/mnt/c/Windows/Fonts/msgothic.ttc'

ブロック図生成ツールの使い方の詳細は ブロック図生成ツール blockdiag のHPを参照。

pipのエラー

自分が実施したときにpip実行時に以下の様なエラーが発生した。(20180713)

Traceback (most recent call last):
  File "/usr/bin/pip", line 9, in 
    from pip import main
ImportError: cannot import name main

あまりLinuxなど詳しくないので適当だが、一応以下の手段でpipを実行できるようになった。

sudo python -m pip uninstall pip
sudo apt-get install pip --upgrade pip