====== Wiki 語法說明 ======
[[wiki:DokuWiki]] 支持一些簡單的標記語言。本頁面包含了你在編輯頁面時所有可能用到的語法的說明。如果需要查看本頁源碼，只需要點擊頁面頂部或者底部的//編輯本頁// (或者//顯示源碼//)即可。\\
如果您是初次使用DokuWiki或是現在想嘗試一下，可以進入[[playground:playground|測試頁面]]隨意發揮。\\
===== 阿含經集印專用格式 =====
-[1]- 校勘的編號在經文中的呈現（縮小）
<code>-[1]- 校勘的編號在經文中的呈現（縮小）</code>
[1] 校勘的編號在校勘區的呈現（不縮小）
<code>[1] 校勘的編號在校勘區的呈現（不縮小）</code>
-[一]- 註解的編號在經文中的呈現（縮小）
<code>-[一]- 註解的編號在經文中的呈現（縮小）</code>
[一] 註解的編號在註解區的呈現（不縮小）
<code>[一] 註解的編號在註解區的呈現（不縮小）</code>
註解可自動編號，因此在經文中標示 - [ ] -，在註解區標示 [ ] 即可，括弧中間不一定要標數字。
\\
[＊] 校勘已有出現時的呈現（縮小）
<code>[＊] 校勘已有出現時的呈現（縮小）</code>
\\
-{摘句的標題}-
<code>-{摘句的標題}-</code>
-<摘句（佳句）的內容>-
<code>-<摘句（佳句）的內容>-</code>
<box 100%>
框起內容</box>
<code><box 100%>框起內容</box></code>
<code>引用經文</code>
<code><code>引用經文</ code></code>
強制\\
建立新行
<code>強制\\
建立新行</code>
以下其餘的功能中，「標題段落」、「圖像和其他文件」、「列表」及「表格」可參考，其餘的請盡量使用阿含經集印專用格式。
===== 基本文本格式 =====
DokuWiki支持 **粗體**， //斜體//， __下劃線__ 以及 ''等寬體'' 等格式。當然，您也可以 **__//''混合使用''//__** 所有這些格式。
DokuWiki支持 **粗體**， //斜體//， __下劃線__ and ''等寬體'' 等格式。
當然，您也可以 **__//''混合使用''//__** 所有這些格式。
可以使用 <sub>下標</sub> 和 <sup>上標</sup>。
可以使用 <sub>下標</sub> 和 <sup>上標</sup>。
您也可以使用 <del>刪除線</del> 標記某些信息。
您也可以使用 <del>刪除線</del> 標記某些信息。
本站並支援 !!螢光筆!!， <color green>文字變色</color>這些格式。\\
請注意，不要用此功能來標示阿含的摘句！阿含的摘句請仍用 -<這樣>-
本站並支援 !!螢光筆!!， <color green>文字變色</color>這些格式。
請注意，不要用此功能來標示阿含的摘句！阿含的摘句請仍用 -<這樣>-
您也可加上 <note>便條紙</note>，這功能還有 important, tip, warning 三種額外的參數可指定。
您也可加上 <note>便條紙</note>。
**段落** 是由空行所建立的。如果您想 **強制建立新行** 而不建立段落，您可以使用兩個連續的反斜杠+空格或是回車作為標記。請看樣例：
這是一些有著換行標記的文字。\\ 請注意
反斜杠只在回車符之前\\
或者在\\ 一個空格之前的時候才有效。 \\而這樣就並不起作用。
這是一些有著換行標記的文字。\\ 請注意
反斜杠只在回車符之前\\
或者在\\ 一個空格之前的時候才有效。 \\而這樣就並不起作用。
請只在必須的時候才使用強制的換行標記。
===== 鏈接 =====
DokuWiki支持多種形式的鏈接。
==== 外部鏈接 ====
外部鏈接會被自動地識別： http://www.google.com 或者簡單地寫作 www.google.com - 當然您也可以為鏈接設置名字： [[http://www.google.com|鏈接到google]]. 類似這樣的電子郵件地址： <andi@splitbrain.org> 也可以被識別。
DokuWiki支持多種形式的鏈接。外部鏈接會被自動地識別：
http://www.google.com 或者簡單地寫作 www.google.com
- 當然您也可以為鏈接設置名字： [[http://www.google.com|鏈接到google]]。
類似這樣的電子郵件地址： <andi@splitbrain.org> 也可以被識別。
==== 內部鏈接 ====
內部鏈接可以用方括號創建。您可以只給出鏈接的地址：[[doku>wiki:pagename]]，也可以附加上鏈接的名字：[[doku>wiki:pagename|我的鏈接]]。Wiki的頁面名字將會被自動地識別為小寫字母，並且不允許使用特殊字符。
內部鏈接可以用方括號創建。您可以只給出鏈接的地址：[[pagename]]，
也可以附加上鏈接的名字：[[pagename|我的鏈接]]。
Wiki的頁面名字將會被自動地識別為小寫字母，並且不允許使用特殊字符。
您可以通過在頁面名中使用冒號的方式來使用 [[wiki:namespaces|命名空間]]。
您可以通過在頁面名中使用冒號的方式來使用 [[wiki:namespaces|命名空間]]。
如果您需要關于**命名空間(namespaces)**的更詳細的信息，請參見 [[doku>wiki:namespaces]]。
您也可以鏈接到一個網頁內部的某一節，只需要將該節書簽的名稱以一個#號分隔加在網頁的地址後面即可。這是一個連向 [[syntax#internal|本節]] 的鏈接。
這是一個連向 [[syntax#internal|本節]] 的鏈接。
注：
* 到 [[wiki:syntax|已存在頁面]] 的鏈接和到 [[wiki:nonexisting|未存在頁面]] 的鏈接，其外觀是不同的。
* 默認情況下，DokuWiki不使用 [[wp>CamelCase]] 來自動建立鏈接，（CamelCase類似于PmWiki中的WikiWord）。但是也可以在 [[doku>config|設置文件]] 中啟用它。 Hint: If DokuWiki is a link, then it's enabled.
* 當一節的標題改變時，該節的書簽也會改變，因此，請不要太依靠網頁內的鏈接。
==== Wiki間鏈接 ====
DokuWiki支持 [[doku>wiki:interwiki|Wiki間鏈接]] ，即到其他wiki的鏈接。例如，這是一個到Wikipedia上關于Wiki的一個頁面的的鏈接： [[wp>Wiki]]
DokuWiki支持 [[interwiki|Wiki間鏈接]] ，即到其他wiki的鏈接。
例如，這是一個到Wikipedia上關于Wiki的一個頁面的的鏈接： [[wp>Wiki]]
==== Windows共享文件夾 ====
Windows共享文件夾，例如 [[\\server\share|this]] 也可以被識別。請注意，這只在內部 [[wp>Intranet|局域網]] 等環境中才可能被成功訪問。
Windows共享文件夾，例如 [[\\server\share|this]] 也可以被識別。
注：
* 出于安全原因，只有在微軟IE瀏覽器上才能夠直接訪問Windows共享文件夾。
==== 圖像鏈接 ====
您也可以用圖像來作為一個內部或者外部的鏈接，只需同時使用鏈接和圖像的語法，如下所示：
[[http://www.php.net|{{wiki:php-powered.png}}]]
[[http://www.php.net|{{wiki:php-powered.png}}]]
請注意：在鏈接名中使用語法，只有顯示圖像的語法會被識別，請不要使用其它語法。
===== 腳注 =====
您可以使用兩個連續小括號來添加腳注((看這里，這是一個腳注))。
您可以使用兩個連續小括號來添加腳注((看這里，這是一個腳注))。
===== 標題段落 =====
您可以使用最多達5層的標題來使您的頁面更富結構性。如果您使用了三個以上的標題，那麼DokuWiki會自動在頁面上生成一個名為“本頁目錄”的標題列表。當然，您也可以關閉這項特性，只需在編輯時在頁面里加入 ''<nowiki>~~NOTOC~~</nowiki>'' 字樣即可。
==== H3標題 ====
=== H4標題 ===
== H5標題 ==
==== H3標題 ====
=== H4標題 ===
== H5標題 ==
您可以通過連續的4個以上“-”號來創建一條水平分割線：
----
===== 圖像和其它文件 =====
您可以使用雙大括號來在頁面中加入 [[doku>images|圖像]] 。您還可以選擇是否指定圖像的顯示大小。
原始大小： {{wiki:php-powered.png}}
指定寬度： {{wiki:php-powered.png?100}}
指定寬度和高度： {{wiki:php-powered.png?100x100}}
重新指定寬度和高度的外部圖像： {{http://de3.php.net/images/php.gif?100x100}}
原始大小： {{wiki:php-powered.png}}
指定寬度： {{wiki:php-powered.png?100}}
指定寬度和高度： {{wiki:php-powered.png?100x100}}
重新指定寬度和高度的外部圖像： {{http://de3.php.net/images/php.gif?100x100}}
使用左方或者右方的空格，您可以選擇對齊方式：
{{ wiki:php-powered.png}}
{{wiki:php-powered.png }}
{{ wiki:php-powered.png }}
{{ wiki:php-powered.png}}
{{wiki:php-powered.png }}
{{ wiki:php-powered.png }}
當然，您也可以指定一個圖像的名字，將鼠標移到圖像上可以看到效果。
{{ wiki:php-powered.png |這是圖像的名字}}
{{ wiki:php-powered.png |這是圖像的名字}}
如果您指定的文件名（無論是外部的還是內部的）不是一個圖像（''gif,jpeg,png''），那麼它將被顯示為一個鏈接。
===== 列表 =====
Dokuwiki支持帶編號或不帶編號的列表。要使用列表，在文字前加入兩個空格，然後使用''*''標志不帶編號的列表，用''-''標志帶編號的列表。
* 列表
* 第二項
* 下一層
* 第三項
- 帶編號的列表
- 第二項
- 用縮進表示更深的層
- 完了
<code>
* 列表
* 第二項
* 下一層
* 第三項
- 帶編號的列表
- 第二項
- 用縮進表示更深的層
- 完了
</code>
===== 表情符號 =====
DokuWiki會將一些常用的 [[wp>emoticon|表情符號]] 轉換為圖像。除了默認的表情符號以外，您也可以在 ''smiley'' 文件夾中放入更多的表情圖，然後在 ''conf/smileys.conf'' 中設置它們即可。下面是Dokuwiki包含了的表情圖像：
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
===== 印刷樣式 =====
[[DokuWiki]]可以將特定字符轉換為印刷時所用的樣式。下面是可以識別的這類字符的列表：
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
</code>
請注意：在配置文件中可以禁用這類自動轉換。
===== 表格 =====
DokuWiki可以用簡單的語法創建表格。
^ 標題1 ^ 標題2 ^ 標題3 ^
| (1,1) | (1,2) | (1,3) |
| (2,1) | 展寬的單元格 ||
| (3,1) | (3,2) | (3,3) |
表格的每一行都以分隔符 ''|'' （普通行）或者 ''^'' （標題行）作為開頭和結束。
^ 標題1 ^ 標題2 ^ 標題3 ^
| (1,1) | (1,2) | (1,3) |
| (2,1) | 展寬的單元格 ||
| (3,1) | (3,2) | (3,3) |
要水平合並單元格，只需要將後一個單元格設置為空即可，如上面演示的一樣。請確保每一行有相同數量的單元格分隔符！
豎直的標題列也是可以實現的：
| ^ 標題1 ^ 標題2 ^
^ 標題3 | (1,2) | (1,3) |
^ 標題4 | 不再合並單元格 | |
^ 標題5 | (2,2) | (2,3) |
可以看到，單元格前面的分隔符決定了單元格的格式。
| ^ 標題1 ^ 標題2 ^
^ 標題3 | (1,2) | (1,3) |
^ 標題4 | 不再合並單元格 | |
^ 標題5 | (2,2) | (2,3) |
注：垂直合並單元格尚未實現。
您可以對齊表格的文字。只需要添加多余兩個的空格在您需要對齊的方向的反向即可：如果需要右對齊，在左邊添加兩個空格；反之，則在右邊添加。在兩邊均添加空格可以實現中間對齊。
^ 有對齊的表格 ^^^
| 右對齊| 居中 |左對齊 |
|左對齊 | 右對齊| 居中 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
下面是源文件中的格式：
^ 有對齊的表格 ^^^
| 右對齊| 居中 |左對齊 |
|左對齊 | 右對齊| 居中 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
我們也安裝了 tablewidth plug-in，因此可指定表格的欄位寬度：
在表格前一行註明，第一個數字是表格總寬度，後面的數字是各欄位寬度（可用任何HTML長度單位），不設定寬度的則用 - 即可。
|< 100% 50px - 5em 10em 10% >|
^ A ^ B ^ C ^ D ^ E ^
| 1 | 2 | 3 | 4 | 5 |
下面是源文件中的格式：
<code>
|< 100% 50px - 5em 10em 10% >|
^ A ^ B ^ C ^ D ^ E ^
| 1 | 2 | 3 | 4 | 5 |
</code>
===== 無格式區塊 =====
您可以在文章中插入無格式區塊，在這些區塊中Wiki語法將不起作用。可以有三種方法：在行前加兩個以上的空格（前面做樣例時用的方法），或者可以使用 ''Code'' 或 ''file'' 標記。
<code>
這是一段被code包圍的區塊，其中的空格都被保留了：像 <-這樣
</code>
<file>
和code是類似的。不過您可以用這個來表示您引用了一個文件的內容。
</file>
要讓Wiki語法解釋完全失效，可以用 ''nowiki'' 標簽包圍整個區塊，或者也可以簡單地使用雙百分號標記 ''<nowiki>%%</nowiki>''。
<nowiki>
這是一段完全沒有Wiki語法解釋的文字，例如：http://www.splitbrain.org ， **粗體**，雖然按照語法書寫，但是它們並沒有被解釋。
</nowiki>
如何使用這些標記，請查看這一段的源文件。
===== 語法高亮 =====
[[DokuWiki]] 可以將源代碼作語法高亮以增加可讀性。它使用稱作 [[http://qbnz.com/highlighter/|GeSHi]] 的通用語法高亮工具（Generic Syntax Highlighter）――所有被GeSHi支持的語言都可以在DokuWiki中得到高亮。使用code標記的方法和上面是類似的，不過需要指定使用的語言，例如： ''<nowiki><code java></nowiki>''。
<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.
}
}
</code>
現在，DokuWiki可以支持的語言有： //actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, objc, oobas, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml//
===== 嵌入HTML和PHP =====
您可以使用 ''html'' 或者 ''php''標記在文檔中嵌入HTML或PHP的代碼。例如：
<code>
<html>
這是 <font color="red" size="+1">HTML</font> 代碼。
</html>
</code>
<html>
這是 <font color="red" size="+1">HTML</font> 代碼。
</html>
<code>
<php>
echo '由PHP生成的logo：';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
</code>
<php>
echo '由PHP生成的logo：';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
**請注意**： HTML和PHP嵌入的功能默認情況下是被禁用的，因此，您可能無法看到上面的代碼運行的結果而只能夠看見源代碼，這取決于DokuWiki站點的設置。
參考資料
* [[http://wiki.splitbrain.org/wiki:syntax|DokuWiki syntax page]]
* [[http://xoopsforge.com/modules/dokuwiki/doku.php?id=wiki:syntax|XFwiki syntax]]
* [[http://bbs.ilc.edu.tw/wiki/doku.php?id=wiki:syntax|ILC BBS DokuWiki syntax (繁體中文)]]
\\
注：本文檔中文原始版由 <jiayq84@gmail.com> 根據DokuWiki 2005.2.6版本的語法說明翻譯，轉載請保留本行信息。\\
\\
===== 語法插件 =====
DokuWiki 的語法可以通過 [[doku>wiki:plugins|插件]] 的方式進行擴展. 在相應插件的頁面有安裝說明。下列語法插件適用于當前版本中:
~~INFO:syntaxplugins~~