http://www.openfoundry.org/tw/foss-programs/8820-graphviz-
notes:
----------
Graphviz - 用指令來畫關係圖吧！
簡介
Graphviz 是一個運用廣泛的命令行繪圖軟體，不過說是繪圖軟體，它能繪的圖並不是一般人想像中的漫畫或 logo，而是數學意義上的 "graph"，比較通俗的說法就是「關係圖」。
舉例來說，像是下面這種圖：
▲ 圖1：Unix 家族。Graphviz 官網的示範圖片之一。
用手畫會很痛苦，而 Graphviz 可以替使用者搞定它。Graphviz 提供一套語言，讓您能直接陳述圖片上的節點、邊、方向等性質。之後，由它來為您產生整張圖片。
Graphviz 能畫的圖片有許多種，您可在官網挖到更多範例。
安裝
Graphviz 支援 Windows、Mac OS X、FreeBSD、Solaris、Linux 等多種作業系統。
若您是 Linux 使用者，基於這款軟體的名氣，您的套件管理器中幾乎一定會有，從套件庫中安裝吧！倘若真找不到，請看官網下載頁面，試試原始碼。
若您是 Windows 用戶，請前往這裡下載安裝檔：http://www.graphviz.org/Download_windows.php
Mac OS X 的使用者請往這邊走：http://www.graphviz.org/Download_macos.php
Graphviz 的使用
1 # Graphviz 2 ＞＜cmd＞ ＜inputfile＞ -T ＜format＞ -o ＜outputfile＞ 3 4 # 舉例：輸出 png 5 ＞ dot input.dot -T png -o output.png 6 # 舉例：一樣是輸出 png，只不過檔名是 txt 7 ＞ dot input.dot -T png -o output.txt
首先，我們看看上面的 ＜cmd＞ 部份。
Graphviz 的 ＜cmd＞ 有好幾種，每種使用方法都完全相同，差別只在於渲染出來的圖片效果不一樣。man 中的簡介是這樣寫的......
dot
渲染的圖具有明確方向性。
neato
渲染的圖缺乏方向性。
twopi
渲染的圖採用放射性佈局。
circo
渲染的圖採用環型佈局。
fdp
渲染的圖缺乏方向性。
sfdp
渲染大型的圖，圖片缺乏方向性。
您可以透過 man ＜cmd＞ 取得進一步說明。但還是親自用用比較容易理解。在本文中，凡沒有說明的圖，預設都是 以 dot 渲染出來的。
繼續往下看。在 Graphviz 中，若您不指定 -T 參數，Graphviz 並不會自動猜測您想要產生什麼格式，只會以預設格式渲染。可選格式相當多，包括（但不限於）jpg、png、svg 等，全部列表可見官網說明頁的最下方。
-o 可讓您指定儲存檔案的檔名。如果您不用 -o 選項指定輸出檔名，Graphviz 則會將結果輸出到標準輸出上。
除非用法很特殊，否則這兩個參數，每次都要記得下達才行。
dot 語言說明
指揮 Graphviz 繪圖時，所使用的語言叫作 "dot"。下邊就來介紹如何使用它。
有向圖與無向圖
使用 dot 語言，第一步就是決定要畫哪種圖。
圖分兩種：有向圖與無向圖。
▲ 圖2：有向圖
▲ 圖3：無向圖
有向圖以 digraph 宣告圖片，節點間的關係寫為 "->"。
1 /*demo1。順便一提，在 dot 語言中可使用 C++ 中允許的註解。本行為 C 風格註解*/
2 digraph demo1{ //這也是註解，C++ 風格的。
3 a -> b -> c;
4 c -> a;
5 }
無向圖以 graph 宣告圖片，節點間的關係可以寫為 "--"。
1 //demo2
2 graph demo2{
3 a -- b -- c;
4 c -- a;
5 }
其中 demo1 與 demo2 是圖片的名稱，一般使用時常常留白不打。
使用引號
上文中的 a, b, c 除了作為程式內的識別字以外，也會成為節點的顯示名稱 (label)。不過如果這名稱中混了中文或夾了空格，Graphviz 就有可能搞錯你的意思。
為防不必要的誤解，所以平常最好都用英文引號括住。就像下面這樣：
1 //demo3
2 digraph {
3 "總 攻" -> "受";
4 "強 攻" -> "受";
5 "健氣攻" -> "受";
6 }
▲ 圖4：混合了空白的示範，採用 fdp 渲染。
這樣就沒問題了！
子圖與簡化技巧
來看個複雜一點的例子，這是一份地中海海域的大略連接圖：
1 graph G{
2 "黑海" -- "亞速海";
3 "黑海" -- "博斯普魯斯海峽"
4 "達達尼爾海峽" -- "愛琴海"
5 subgraph cluster_T{ // 新東西
6 label = "黑海海峽"; // 新東西
7 "達達尼爾海峽" -- "馬爾馬拉海" -- "博斯普魯斯海峽";
8 }
9 subgraph cluster_M{
10 label = "地中海海域";
11 "中部地中海" -- {"愛琴海" "愛奧尼亞海" "西西里海峽"}; // 也是新東西
12 "西部地中海" -- {"西西里海峽" "第勒尼安海" "利古里亞海" "伊比利海" "阿爾沃蘭海"};
13 "愛奧尼亞海" -- "亞得裡亞海";
14 "阿爾沃蘭海" -- "直布羅陀海峽";
15 }
16 }
▲ 圖5：地中海海域連接圖，使用 fdp 渲染，種子為 8 (-Gstart=8)。
這張圖有些新東西可以看。
第一個是 subgraph 關鍵字。一如名字所示，他是用來定義「次級圖片」用的。
次級圖片在 dot 的官方文件中常被叫作 cluster subgraph，特指圖示中被方框包裹起來的那兩塊，其定義方式和一般的 graph 非常相似，不過使用上有兩件事需要留意：
- 他的命名得以 cluster 前綴開頭，否則語法雖然能過關，但生不出圖面上您預期的效果。
- 如果父圖是無向圖，他本身也得是無向圖；反之如果父圖是有向圖，這邊也得乖乖照著來。
第二個重點是下面這段：
1 "中部地中海" -- {"愛琴海" "愛奧尼亞海" "西西里海峽"};
用大括號括起，用空格分開－這是一口氣將好幾個節點群組起來同時操作的方法，其等效於：
1 "中部地中海" -- "愛琴海"; 2 "中部地中海" -- "愛奧尼亞海"; 3 "中部地中海" -- "西西里海峽";
您甚至可以用以下程式碼畫出圖6：
1 digraph G{
2 {a b c} -> {d e f}
3 }
▲ 圖6：大括號效果示意圖
這語法糖很方便好吃，可以靈活運用。
第三個不同處在於 label = XXX 這行。這是「屬性」的指定方式。
關於屬性，我們下章再講。
屬性
有了前面介紹過的技巧，所有圖面關係都可以順利地繪製出來。
然而，通常我們畫圖的時候，還會對圖片做一些特別的處理。好比說把字加粗、把圖變色、把標籤或連接線的外型 改變、把某些節點水平對齊......諸如此類。
要控制這些東西，就要用到屬性。
屬性有四種：
- 用在節點上 (Node, N)
- 用在線段上 (Edge, E)
- 用在根圖片上 (Graph, G)
- 用在子圖片上 (Cluster subgraph, C)
您可以閱讀手冊中的表，判斷哪些屬性能用在哪些地方。
那麼，屬性要怎麼用呢？
屬性的套用
如果要設定根圖片或子圖片的屬性，得像前面範例中所示的那樣，在圖片的大括號範圍內指定......
屬性名稱=值;
這樣就行了。
對於節點 (node) 的屬性，有以下幾種指定法：
1 節點名 [節點屬性名=值]; 2 節點名 [節點屬性名=值, 節點屬性名=值]; 3 node [節點屬性名=值，節點屬性名=值];
屬性指定的語句必須要被中括號括起。當一次指定多值時，需用英文逗點隔開。
第三行中的 node 是個關鍵字，用來代稱「圖片範圍內」所有「還沒創建」的節點，或者您也可將它理解為：在當前大括號的範圍內，所有尚未創建節點的屬性預設值，會被這個語句給變更。
線段 (edge) 的屬性指定，與節點屬性指定方式很類似：
1 節點名 -> 節點名 [線段屬性名=值]; 2 節點名 -- 節點名 [線段屬性名=值, 線段屬性名=值]; 3 edge [線段屬性名=值，線段屬性名=值];
其中 edge 是關鍵字。
這邊順便補充一個關於線段的觀念：有些線段相關的屬性，具有 head 值與 tail 值。而這邊說的 head 與 tail，得將它想 像成一個「箭頭」的形狀（就像是「a -> b」這樣）。
對於線段來說，這個箭頭的頭部才是 head。所以囉，這可能和您最初想像的不一樣，因為這邊說的「Head」其實是 兩個節點中，後面的那一個。
屬性範例
把先前的看過的例子加上一些屬性試試。
1 graph G{
2 "黑海" [shape = circle, color = blueviolet, fontcolor = blueviolet, fontsize = 20];
3 "黑海" -- "亞速海" [label = "刻赤海峽"];
4
5 subgraph cluster_T{
6 label = "黑海海峽";
7 fontsize = 24;
8 fillcolor = darkslategray;
9 style = filled;
10 fontcolor = white;
11 node [fontcolor = white, color = white];
12 "博斯普魯斯海峽" -- "馬爾馬拉海" -- "達達尼爾海峽" [color = white];
13 "博斯普魯斯海峽" [shape = parallelogram];
14 "達達尼爾海峽" [shape = parallelogram];
15 }
16
17 "黑海" -- "博斯普魯斯海峽" [color = red ,penwidth = 2];
18 "達達尼爾海峽" -- "愛琴海" [color = red ,penwidth = 2];
19
20 subgraph cluster_M{
21 label = "地中海海域";
22 fontsize = 24;
23 "西部地中海" [shape = Mcircle, style = filled, color = grey, fillcolor = aquamarine, fontsize = 20];
24 "中部地中海" [shape = Mcircle, style = filled, color = grey, fillcolor = aquamarine, fontsize = 20];
25 "直布羅陀海峽" [shape = parallelogram, fontcolor = red];
26 "西西里海峽" [shape = parallelogram];
27 "中部地中海" -- {"愛琴海" "愛奧尼亞海" "西西里海峽"};
28 "西部地中海" -- {"西西里海峽" "第勒尼安海" "利古里亞海" "伊比利海" "阿爾沃蘭海"};
29 "愛奧尼亞海" -- "亞得裡亞海";
30 "阿爾沃蘭海" -- "直布羅陀海峽";
31 }
32 }
▲ 圖7：地中海海域連接圖（加入屬性）。使用 fdp 渲染，種子為 3 (-Gstart=3)。
諸多屬性中，最常用的大概是 label 了。
label 可以決定節點、線段或子圖片上要顯示些什麼。如果您的節點名很長的話，可以在程式內部取個簡短的名稱， 之後透過短名稱操作它，另外透過 label 指定它的顯示內容。
color、fillcolor、fontcolor 這些屬性都是控制顏色用的，不過 fillcolor 只有在 style 被指定為 "filled" 時才會生效。
shape 可以指定節點的形狀，形狀列表官網這邊有一份資料可參考。
線段屬性方面。有向圖中的箭頭可透過 arrowhead 與 arrowtail 屬性來指定頭尾樣式。至於線段本身，則可透過 style 屬 性，指定不同類型的虛線與短截線。使用者還可以用 dir 屬性讓箭頭方向反過來。
另外還有一個 image 屬性，可以指定讓 node 顯示圖片，需要時也可參考看看。
......屬性實在太多，無法一一介紹，請查官網手冊獲得全面訊息。
rank
dot 語言中有一個叫作 rank 的概念。
所謂的 rank，在 dot 語言中，含意比較接近於「等級」。他主要用在 dot 渲染器中。
請看以下的圖：
▲ 圖8：rank 示例。
很明顯可以看出來，圖片被從上到下分為四層－這就是 rank。
下方是與上圖對應的 dot 陳述......
1 digraph demo{
2 a -> b -> c -> d;
3 b -> {e f};
4 }
觀察程式碼，可看出 rank 是如何被指定的。
其基本規則在於：每個線段的頭端，都會比尾端多出一個等級（在圖上面就是往下面一層）。
但等等，如果等級指定的語句彼此矛盾呢？
修改以上程式碼為......
1 digraph demo{
2 a -> b -> c -> d [label = "rank 增加"];
3 b -> {e f} [label = "rank 增加"];
4 f -> a [label = "不影響 rank"];
5 }
▲ 圖9：rank 示例。
看上面的結果，顯然 rank 的指定是「先說先贏」的。
除了基本規則外，rank 也可以透過屬性來加以調節，有必要時就把手冊抓出來查查看。
參考資料
- 官網屬性手冊，要查屬性就來這看：
http://www.graphviz.org/content/attrs。 - 官網純文字版 Graphviz 使用說明兼 dot 語言手冊：
http://www.graphviz.org/doc/Dot.ref。 - 如果您偏好 pdf 版本的說明書，請到這邊下載：
http://www.graphviz.org/doc/dotguide.pdf。
評論
我下載這個程式來玩了.
但無法顯示中文, 請問您是如何做出來的呢?
註：我在 opensuse 11.1、fedora 18、debian Jessie 上都測試過。不管哪個平台都沒有 特別調過設定，裝下去就能用了， 暫時不太確定問題出在哪裡。