Wiki 語法

狼之樂園協作平台使用一些簡單語法，試著讓資料檔案盡可能的可讀。這個頁面包含所有你可以在編輯頁面時使用的語法。點選在頁面頂端或底端的「編修本頁」按鈕來觀看這一頁的原始檔。如果你想要嘗試，請使用新手試煉場。你也可以使用編輯按鈕取用更簡單的語法。

（譯者註：接下來就讓我們花點時間看一下吧，不一定要全懂，建議挑有興趣的先學，有其他問題或想學多點再來看這也可以。）

或者你可以參考快速編輯指引

DokuWiki 使用空行來區分段落¹⁾。例如：

Paragraphs are created from blank lines. 

If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.

實際顯示的結果為：

Paragraphs are created from blank lines.

If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.

如果你想要 強制斷行²⁾ 的話而不是變成另一段落，那麼就在要斷尾處加2個連續的倒斜線 \\ 以及1個空白或位於這行的結尾。

你應該只在真正需要使用強制斷行的地方才用強制斷行。

DokuWiki 支援以下基本語法，並且可以 組合 各種效果。

DokuWiki 可使用多種型態的連結，以下介紹各式連結用法：

若使用標準 URL Scheme （如 http://www.google.com），或只是 FQDN （如 www.google.com）都會被自動判斷為外部連結。 此外，可以透過設定連結名稱(Linknames) 來設定連結的顯示，比如：這會連到 Google 或者 email也可以用 andi@splitbrain.org 或 andi 來表示。

若使用標準 URL Scheme （如 http://www.google.com），
或只是 FQDN （如 www.google.com）都會被自動判斷為外部連結。
此外，可以透過設定連結名稱(Linknames) 來設定連結的顯示，
比如：[[http://www.google.com|這會連到 Google]] 
或者 email也可以用 <andi@splitbrain.org> 或 [[andi@splitbrain.org|andi]] 來表示。

內部連結是用2個中括號包裹要連結的頁面名稱來產生。 可以直接用 pagename 或加上該連結的說明 說明文字。 頁面名稱會被自動轉換成小寫英文字，並且不支援特殊符號。 （中文頁面名稱雖然支援，但在某些部份並不完善，仍建議盡量使用英文頁面名稱 — Reder 2008/06/05 04:58）

內部連結是用2個中括號包裹要連結的頁面名稱來產生。
可以直接用 [[pagename]] 或加上該連結的說明 [[pagename|說明文字]]。 
頁面名稱會被自動轉換成小寫英文字，並且不支援特殊符號。
（中文頁面名稱雖然支援，但在某些部份並不完善，仍建議盡量使用英文頁面名稱）

也可以加上冒號「:」(colon)用來做 namespaces 的區分而互相連結。

也可以加上冒號「:」(colon)用來做 [[namespaces]] 的區分而互相連結。

提到「namespaces」，它可用來對整體 Wiki 頁面架構作更好的規劃。 每一個 namespace 本身就是「目錄」，因此若某頁名稱為「wact:tags:list」， 那麼就會對應為「wact/tags/list.txt」的結構，也就是 wact目錄 → tags目錄 → list.txt， 所以拿這招來規劃 WIKI 結構是相當好用的。如果在某個 namespace 之下的頁面，創立內部連結，[[pagename]]， 此頁面也會擁有相同的 namespace。 若想更深入瞭解，那麼請看 namespaces。

若要連到某頁的某章節段落，也可以。 就像 HTML 的 bookmark 一樣，只要在該頁後面加上 #某章節 就可以囉。 比如

這會連到 這一節(internal)。

這會連到 [[syntax#internal|這一節(internal)]]。

請注意:

• 連到 已存在的頁面 跟 不存在的頁 會以不同的方式呈現(看您的 style.css 中的 CSS 設定如何而定)。
• 符合 CamelCase 的詞彙通常在 Wiki 環境內會自動轉換為連結，而 DokuWiki 預設是關閉，如有需要可在 dokuwiki.php 檔內設定開啟。
  1. CamelCase簡單講就是「幾個英文單字之間緊接著而沒有空格」所組成的詞彙，但每個單字的首字大寫，狀如駝峰(Camel)，故名為 CamelCase。
  2. 如果有在 dokuwiki.php 內開啟 CamelCase 功能的話，那麼只要在文章內打出 DokuWiki 這字就會自動成為連結了。
• 如果章節的標題改變的話，那麼相對應的 bookmark 連結也會跟著改變。因為 Wiki 本身性質是「變」，使用者很容易改來改去的，所以請別太依賴(過度使用)章節連結功能。
• 此外可參考 DokuWiki網站有關 pagename 的說明 。

DokuWiki 可用 interwiki 來快速連到其他 Wikis。

比如：這會連到 Wikipedia(維基百科)的 Wiki 頁Wiki。

此外還可運用：

備註：此外，還有多種變化，請自行參見下列有關 conf/interwiki.conf 的說明。

InterWiki 可透過 conf/interwiki.conf 檔來設定。DokuWiki內建包含了 http://usemod.com/intermap.txt 所列的每項 InterWiki，格式如下

若不想用預設的圖示，那麼可在 interwiki 目錄內放跟捷徑名稱相同的圖檔。比如捷徑名稱為「wp」，那麼圖檔名稱應為「wp.gif」或「wp.png」才行。 而這些圖檔必須是 16×16 像素(pixels) 的 PNG 或 GIF 格式。

MS Windows 主機使用 SMB⁵⁾協定，或稱為 CIFS⁶⁾的協定，可讓 MS Windows 主機可以將另一 MS Windows 主機目錄檔案當成是本機上的目錄檔案一般地使用，即所謂的網路芳鄰分享。而這個協定亦可以用於 Internet ，即位於不同網段的 Windows 主機也可使用此協定進行目錄檔案的分享(假如傳送過程中未有其他的網路設備阻擋時)。而其他 OS 像是 FreeBSD, Linux 也有相關 Samba 軟體來使用這項功能。

網芳資源可用 這樣子 來進行連結。另外可參考Intranet。

網芳資源可用 [[\\server\share|這樣子]] 來進行連結。

千萬要注意:

• 為了系統安全，直接瀏覽「網路芳鄰」功能只限於 Microsoft Internet Explorer 。
• 請注意相關安全問題：鑒於 SMB 協定具有相當的便利性，但設定不夠完善的 Windows 主機(如密碼設定不夠安全或是未設定密碼)常讓外界使用者經此網路芳鄰分享，洩漏區域網路內相關檔案或系統上的機密資訊，甚至讓網路駭客完全控制該部主機。譬如 2001 年中的 Nimda 病毒就是經由網路芳鄰的方式散佈病毒至另一台保護不週的 Windows 主機上，以致造成感染病毒的速度加快。所以經由開放網路芳鄰分享於外界使用者，來增加與其他單位(如所屬機關、外部辦公室或駐外機構)的聯繫方便，同時亦可能形成安全上的漏洞，尤其是對保護不週的 Windows 主機而言。

也可透過使用圖片來連到wiki內部的頁面，或者其他的 URL ，比如:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

請記得: 在 [[URL|連結名稱]] 的「連結名稱」處若用 {{}} 的話，只能用圖檔檔名喔。

您可以任意增加註解 ⁷⁾ ，怎麼用呢？ 把要註解的文字用 2 個括號類似包水餃一樣包起來就好囉。 而註解的編號管理，請別擔心，DokuWiki 會自動幫您弄好。

您可以任意增加註解 ((這是示範註解)) ，怎麼用呢？
把要註解的文字用 2 個括號類似包水餃一樣包起來就好囉。

一個層次分明的內容，加上有條不絮的說明文字，似乎總是最能令人消化吸收的。

我們可以透過設定最多至五種不同層次的標題，來完成目錄表的自動建構。 若該頁內有至少三個層次的標題，那麼 DOKUWIKI 就會自動產生相對應的目錄表(TOC)。 不過若不想要「目錄表」的話，那麼只要在文章開頭打入~~NOTOC~~即可。

標題是在左右各以等號 = 標示， 從 == 到 ====== 每多1個 = 則分別代表更高層次的標題

====== 有六個 = 則為「標題層次第1級」， 而本節目前是 ===== Sectioning 目錄的節次結構 ===== 也就是「標題層次第2級」

==== 標題層次第 3 級 ====
=== 標題層次第 4 級 ===
== 標題層次第 5 級 ==

而連續四個短折號「-」(dash)所組成的 ---- 即可產生水平線。 舉例： 　　　　↓

可以用2個重疊的 {{}} 括號(curly brackets)來貼圖或檔案，詳情請見 images。 也可以在編輯時用工具列的按鈕來完成。

此外，還可指定圖檔的顯示大小。

實際大小:

縮放為自訂的寬度(50 pixel):

縮放為自訂的大小(200×50):

縮放以URL連結的影像(100×100):

實際大小:             {{wiki:dokuwiki-128.png}}
縮放為自訂的寬度(50 pixel): {{wiki:dokuwiki-128.png?50}}
縮放為自訂的大小(200x50):  {{wiki:dokuwiki-128.png?200x50}}
縮放以URL連結的影像(100x100): {{http://de3.php.net/images/php.gif?100x100}}

也可運用 {{圖檔檔名}} 在括號與檔名之間插入空白的變化，來指定要放左、右或中間。

{{ wiki:dokuwiki-128.png}}
這張會出現在右邊，注意到了嗎？
檔名跟左邊的括號隔了一個空白唷~代表靠右放

{{wiki:dokuwiki-128.png }}
這張會出現在左邊，注意到了嗎？
檔名跟右邊的括號隔了一個空白唷~代表靠左放

{{ wiki:dokuwiki-128.png }}
這張會出現在中間，注意到了嗎？
檔名跟左右兩邊的括號都隔了一個空白唷~代表往中間放

當然還可在圖片上加上「說明文字(title)」(在多數的瀏覽器上，滑鼠移到該圖上則會顯示)。

{{ wiki:dokuwiki-128.png |這是該圖的說明}}

若您所指定的檔案(無論是內部連結或外部URL)並不是圖檔(gif,jpeg,png這三種圖檔類型)，那麼「這是該圖的說明」那段文字會被顯示出來而當作連結，效果等同 HTML 中的 <img alt=“這是該圖的說明” >。

DokuWiki 可使用項目表有兩種型態：數字及符號表。 要建立項目表的話，在該行前面先空出兩格，然後加上 * 即可產生符號項目表， 或者改用 - 的話則會產生數字項目表。

• 這是項目表
• 然而
  • 也可以用不同層次的項目表來表達
• 其他

1. 這也一樣是項目表，不過前面會加上編號
2. 第二項
   1. 只要在 - 或 * 前面多加空白，就會內縮為更深(細微)的層次了。
3. 第三項

1. 空行，則會結束列表，重新起算編號。

  * 這是項目表
  * 然而
    * 也可以用不同層次的項目表來表達
  * 其他

  - 這也一樣是項目表，不過前面會加上編號
  - 第二項
    - 只要在 ''-'' 或 ''*'' 前面多加空白，就會內縮為更深(細微)的層次了。
  - 第三項
  
  - 空行，則會結束列表，重新起算編號。

DokuWiki 支援 emoticon 普遍常用的表情符號。表情符號圖檔都被放在 smiley 目錄內， 並且可以用 conf 目錄下的 smileys.conf 檔案來做更多的設定， 以下是目前 DokuWiki 所內建的表情符號表。

原始寫法	表情符號
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
:?:
:!:
LOL
FIXME
DELETEME

^_^

注意: 若您不想要這項功能的話，可以在 dokuwiki.php 檔中設定關閉。

有時候你想要將某些文字標為引述，你可以使用下列的語法：

我想我們應該這麼做

> 不，我們不該。

>> 嗯，我想我們應該。

> 真的嗎？

>> 當然！

>>> 那就做吧！

我想我們應該這麼做

不，我們不該。

嗯，我想我們應該。

真的嗎？

當然！

那就做吧！

DokuWiki 建立表格的方式很簡單：

以 | 開始與結束的是「普通欄位」，而 ^ 則是「標題欄」(通常 CSS 預設為藍底粗黑字)， 同時也以 | 或 ^ 分欄。 當然，只要您高興，也可以全部「只用 ^ 」都是標題或「只用 | 」都沒標題。

^ 標題一        ^ 標題二       ^ 標題三                 ^
| 第1行，第1列  | 第1行，第2列  | 第1行，第3列           |
| 第2行，第1列  | 合併兩欄(注意後面有兩個 | 豎號喔)      ||
| 第3行，第1列  | 第3行，第2列  | 第3行，第3列           |

上面「合併兩欄(注意後面有兩個 | 豎號喔)」，
只須將欲合併的欄位直接接上 | 或 ^ 即可合併多欄位。
但要注意的是每行的欄位數(不管是哪一種分隔線)都要一致。

而標題也可以「垂直」欄位來表示。

上面例子所看到的，就是直接在「標題三、四、五」前面加上 ^ 即可。

|          ^ 標題一            ^ 標題二             ^
^ 標題三    | 第1行，第2列      | 第1行，第3列        |
^ 標題四    | 這次不使用合併    |                    |
^ 標題五    | 第3行，第2列      | 第3行，第3列        |

請注意: 垂直方向的欄位(rowspan)並無法合併，但可斷行。 　　　　若有需要，可改用最後面介紹的 HTML 方式來使用。

You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.

This is how it looks in the source:

^           Table with alignment           ^^^
|         right|    center    |left          |
|left          |         right|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

在一段文字的最前面加上 2 個空白，來直接作為「文字方塊」不對它做加工處理(就像前面那些說明一樣)。或者也可以用 <code> 或 <file> 這兩個標籤(tag)都可以達到類似效果。

這段是用 <code> 產生的，所有空格及所有原始格式都會照樣顯示，還其本色。
 就像       <-這個

或者
    方與圓  似剛與柔
    圓契合於方
    方契合於圓
    兩心同一點

這段跟上段很像，但是改用 <file> ，可以把它用在「引述名言(Quote)」效果上。  
  
        remember, information is not knowledge,
                  knowledge is not wisdom
                  wisdom is not truth
                  truth is not beauty
                  beauty is not love
                  love is not music
                  music is the best
  
                                                -- frank zappa

若要略過某段內含 WIKI 語法，不對該段文字作任何處理， 可以使用 <nowiki> 標籤或更簡單一點用 2 個 %% 放在該段文字的前後，請參考下面例子：

<nowiki>這段字不要用 [[WIKI]] 語法</nowiki> 或是%%這段字不要用 [[WIKI]] 語法%%

這一段包含一些原本會在 WIKI 內有特殊處理，像是 http://www.splitbrain.org 及 **強調語氣的文字** ，但是正如所看到的，這裡什麼都不做任何處理。

您可以看本頁的原始寫法來察看這一段是怎麼寫的。

DokuWiki 可把原始碼語法來做高亮度顯示(Syntax Highlighting)，來更加具可讀性。 它採用的是 GeSHi Generic Syntax Highlighter —— 所以只要 GeSHi 有支援的，DokuWiki 亦可。

用法就類似前例的 <code> ，但要在標籤(tag)內指定該原始碼所使用的語言。比如 <code java> 舉例：

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

目前支援的語言有: actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml