MTGraphviz AT&Tが開発しているグラフ視覚化ツールであるGraphvizをMovable...
AT&Tが開発しているグラフ視覚化ツールであるGraphvizをMovable Typeから利用するためのプラグインです。
Movable Typeでのブログに概念などを説明するちょっとした図を記載するときも、従来はグラフィックソフトなどを立ち上げ、画像ファイルを生成し、管理画面やFTPなどを通してアップロードしていました。
Graphvizプラグインであるmt_graphvizを利用することによって、テキスト中にdotと呼ばれる言語を用いてグラフを記述することによって、エントリーの編集のみで画像を生成することができます。
Graphvizはについては詳しくは公式サイトなどをご覧下さい。
このようにdotが記述されているテンプレート・タグを括ります。
<MTGraphviz
cache_dir="/usr/local/apache2/htdocs/graphviz"
prefix_url="/graphviz"
block_id="entry"
default_node_fontname
= "/usr/share/fonts/ja/TrueType/gothic.ttf"
default_graph_fontname
= "/usr/share/fonts/ja/TrueType/gothic.ttf"
default_edge_fontname
= "/usr/share/fonts/ja/TrueType/gothic.ttf">
<$MTEntryBody$>
</MTGraphviz>
エントリーにおいて下記のようなテキストを挿入すると、
{{{
#!graphviz
digraph G {
a -> b;
b -> c;
c -> a;
}
}}}
その部分がグラフ画像に変換されます。
ダウンロード
インストールする環境に次のファイルをダウンロードしてください。
ダウンロードおよびインストールをしてmt_graphvizプラグインを利用する前に、利用規約を必ずお読みください。インストールして利用を開始した際は利用規約に同意したものとみなされます。
インストール
- ダウンロードしたファイルを解凍してください。
- 必要に応じて「プラグインのカスタマイズ」を参照し、Graphviz.plの設定を書き換えてください※
- Graphviz.plをMovable Typeのpluginsディレクトリ(mt/plugins/)にコピーしてください。
- 書き込み可能な画像用ディレクトリを用意してください。デフォルトでは /usr/local/apache2/htdocs/images です。
注意事項
- もちろんGraphvizがインストールされている必要があります
- Windowsプラットフォームまたは共有型レンタルサーバにインストールする場合はキャッシュディレクトリのパスを書き換える必要があります
使い方
- 上記記述例および「タグ・リファレンス」を参考にしてテンプレートにMTGraphvizタグを記述してください。
- 対象となるエントリーおよびテンプレートを構築してください。
タグリファレンス
MTGraphvizコンテナタグ
<MTGraphviz
cache_dir="/usr/local/apache2/htdocs/graphviz"
prefix_url="/graphviz"
block_id="entry"
default_node_fontname
= "/usr/share/fonts/ja/TrueType/gothic.ttf"
default_graph_fontname
= "/usr/share/fonts/ja/TrueType/gothic.ttf"
default_edge_fontname
= "/usr/share/fonts/ja/TrueType/gothic.ttf">
<$MTEntryBody$>
</MTGraphviz>
- cache_dir属性
- 画像ファイルを生成するディレクトリのパス。
- cmd_path属性
- Graphvizコマンドがあるディレクトリのパス。
- prefix_url属性
- 生成した画像ファイルがあるディレクトリのURL。
- processor属性
- Graphvizコマンド。dot、neato、twopi、cicrt、fdpなどから選択可能。
- out_format属性
- 生成する画像のフォーマット。png、jpg、gif、svg、svgzなどから選択可能。
- default_graph_*属性
- Graphに対してデフォルトで設定する属性。
- default_node_*属性
- Nodeに対してデフォルトで設定する属性。
- default_edge_*属性
- Edgeに対してデフォルトで設定する属性。
- block_id属性
- 生成するファイルのグループを識別するID。
- dot_header属性
- dotスクリプト部分を判別するヘッダパターン。
- dot_footer属性
- dotスクリプト部分を判別するフッタパターン。
- filename_template属性
- 生成する画像ファイルのパターンテンプレート。パラメータは一つめから、エントリーのファイル名、block_id属性の値、同一タグ内での画像のインデックスが渡される。
プラグインのカスタマイズ
設定用の変数
- $IMG_PREFIX
- 生成した画像を表示するためのHTMLフラグメントの前半部分。
- $IMG_POSTFIX
- 生成した画像を表示するためのHTMLフラグメントの後半部分。
- $ERR_PREFIX
- Graphvizエラー発生時のHTMLフラグメントの前半部分。
- $ERR_POSTFIX
- Graphvizエラー発生時のHTMLフラグメントの後半部分。
- $DEFAULT_CMD_PATH
- デフォルトのGraphvizコマンドディレクトリ。
- $DEFAULT_PROCESSOR
- デフォルトのGraphvizコマンド。
- $DEFAULT_OUT_FORMAT
- デフォルトの画像出力フォーマット。
- $DEFAULT_CACHE_DIR
- デフォルトの画像出力ディレクトリ。
- $DEFAULT_BLOCK_ID
- デフォルトのブロックID。
- $DEFAULT_DOT_HEADER
- デフォルトのdot部分識別ヘッダパターン。
- $DEFAULT_DOT_FOOTER
- デフォルトのdot部分識別フッタパターン。
- $DEFAULT_FILENAME_TEMPLATE
- デフォルトの画像ファイル名テンプレート。
利用規約
ソフトウェアを利用する前にアイデアマンズ株式会社のソフトウェア利用規約をお読みください。利用規約に同意した上でご利用ください。
このソフトウェアに関してはソースコードは改変してご自由にお使い下さい。改変後のソースを公開する場合はご相談ください。
