英文原版說明請見 [[:wiki:syntax_en]]。

====== Wiki 語法 ======

[[DokuWiki]] 支援一些簡單的語法，務求使文檔更易讀。本頁包含了您在編輯頁面時可以使用的語法。點選在頁面頂端或底端的「編修本頁」按鈕，可觀看這一頁的原始檔。如要實驗，請移玉步至[[playground:playground]]。您可以使用[[doku>toolbar|編輯按鈕]]，讓編輯過程更方便。

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


===== 基本文字格式 =====

DokuWiki 使用**空行**來區分段落((也就是 XHTML 語法中的 <p></p>))。例如：

  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.

若您想 **強制斷行**((也就是 XHTML 語法中的 <br/>)) 的話而不是變成另一段落，那麼就在要斷尾處加兩個連續的倒斜線 %%\\%% 以及1個空白或位於這行的結尾。請看示範：

這是一些有換行標記的文字。\\ 請注意：
兩個倒斜線只在Enter之前\\
或者接在\\ 一個空格之前，才會有效。\\而這樣就並不起作用。

  這是一些有換行標記的文字。\\ 請注意：
  兩個倒斜線只在Enter之前\\
  或者接在\\ 一個空格之前，才會有效。\\而這樣就並不起作用。

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

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

|說明^原始寫法^輸出效果^
^粗體|%%**粗體**%%|**粗體**|
^斜體|%%//斜體//%%|//斜體//|
^底線|%%__底線__%%|__底線__|
^定距字體，或稱「等寬」字體((monospaced font))|%%''定距''%%|''定距''|
^下標字|%%H<sub>2</sub>O%%|H<sub>2</sub>O|
^上標字|%%y = x<sup>2</sup> + 1%%|y = x<sup>2</sup> + 1|
^刪除線|%%<del>刪除線</del>%%|<del>刪除線</del>|

===== 連結 =====

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

==== 外部連結 ====

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

==== 內部連結 ====

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

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


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

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

若想深入瞭解分類名稱（namespaces，或稱命名空間）空間請見 [[:zh-tw:namespaces|這裏]]。

您也可以直接連結某個頁面的某章節段落。就像 HTML 一樣，只要在該頁後面加上 #某章節 就可以囉。比如：

這會連到 [[:zh-tw:syntax#內部連結|這一節(internal)]]。

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

請注意:

  * 連到 [[:zh-tw:syntax|已存在的頁面]] 跟 [[nonexisting|不存在的頁面]] 會以不同的方式呈現(看您的 style.css 中的 CSS 設定如何而定)。
  * 符合 [[wp>CamelCase|駝峰文字]] 的詞彙通常在 Wiki 環境內會自動轉換為連結，而 DokuWiki 預設是關閉，如有需要可在[[:zh-tw:config|設定選項]]中開啟。
    - 駝峰文字（CamelCase）簡言之就是「幾個英文單字之間緊接著而沒有空格」所組成的詞彙，但每個單字的首字大寫，狀如駝峰([[dict>Camel]])，故名為 CamelCase。
    - 如果在[[:zh-tw:config|設定選項]]中開啟駝峰文字功能的話，那麼在文章內打出駝峰文字（如：DokuWiki）就會自動成為連結了。
  * 若章節所在的頁面標題改變了，那麼其連結也會跟着改變。因此請別過度依賴章節連結功能。
  * 此外可參考 [[:zh-tw:pagename|DokuWiki網站有關 pagename 的說明]] 。
==== Wiki間的互連 ====

DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。
  DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如
  要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。

此外還可運用：

^原始寫法^出現的結果^說明^
|%%[[%%google>Wiki%%]]%%|[[google>yahoo]] |請 Google 搜尋大神幫您找有關 Wiki 的網頁|
|%%[[%%wp>Wiki%%]]%%|[[wp>Wiki]] |連到 Wikipedia(維基百科)的 Wiki 頁|
|%%[[Meatball>MeatballWiki]]%%|[[Meatball>MeatballWiki]] |連到 MeatBall Wiki 的 MeatballWiki 頁|
|%%[[phpfn>phpinfo]]%%|[[phpfn>phpinfo]] |到 php 官網看 phpinfo function 的手冊說明|
|%%[[JspWiki>System.out.println]]%%|[[JspWiki>System.out.println]] |從 JSP Wiki 找 System.out.println 說明|
|%%[[FreeBSDman>uname]]%%|[[FreeBSDman>uname]] |到 FreeBSD 官網找 uname 的線上說明|
|%%[[man>passwd]]%%|[[man>passwd]] |到 Linux Qustion 查 passwd 的用法|
|%%[[rfc>2010]]%%|[[rfc>2010]] |找 RFC #2010 文件|
|%%[[amazon>Bible]]%%|[[amazon>Bible]] | 到亞馬遜書局找有關聖經(Bible)的書|
|%%[[dict>apple]]%%|[[dict>apple]] |從雅虎奇摩字典查 apple 單字|
|%%[[imdb>Titanic]]%%|[[imdb>Titanic]] |從 IMDB((IMDB->Internet Movie Database))電影資料庫尋找有關 鐵達尼(Titanic) 的資料 |
|%%[[GoogleGroups>FireBird BBS]]%%|[[GoogleGroups>FireBird BBS]] |用Google Newsgroup內找 FireBird BBS 文章(tw.bbs.*轉信文章亦可)|
|%%[[bug>4]]%%|[[bug>4]] | 察看 DOKUWIKI 編號 4 的 bug 回報|
備註：此外，還有多種變化，請自行參見下列有關 ''conf/interwiki.conf'' 的說明。

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

^捷徑名稱{NAME}^網址{URL}^
|wp        |http://en.wikipedia.org/wiki/|
|wpzh      |http://zh.wikipedia.org/wiki/|
|wpjp      |http://jp.wikipedia.org/wiki/|
|wpde      |http://de.wikipedia.org/wiki/|

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

==== 網路芳鄰分享的連結 ====

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

網芳資源可用 [[\\server\share|這樣子]] 來進行連結。另外可參考[[wp>Intranet]]。

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

千萬要注意:

  * 為了系統安全，直接瀏覽「網路芳鄰」功能只限於 Microsoft Internet Explorer 。
  * 請注意相關安全問題：鑒於 SMB 協定具有相當的便利性，但設定不夠完善的 Windows 主機(如密碼設定不夠安全或是未設定密碼)常讓外界使用者經此網路芳鄰分享，洩漏區域網路內相關檔案或系統上的機密資訊，甚至讓網路駭客完全控制該部主機。譬如 2001 年中的 Nimda 病毒就是經由網路芳鄰的方式散佈病毒至另一台保護不週的 Windows 主機上，以致造成感染病毒的速度加快。所以經由開放網路芳鄰分享於外界使用者，來增加與其他單位(如所屬機關、外部辦公室或駐外機構)的聯繫方便，同時亦可能形成安全上的漏洞，尤其是對保護不週的 Windows 主機而言。
  * Mozilla和Firefox的使用者，可採用[[http://kb.mozillazine.org/Firefox_:_Issues_:_Links_to_Local_Pages_Don%27t_Work|Mozilla知識庫]]裏提及的不同解決方法，啟用此功能。唯在開啟網路芳鄰時，仍會彈出JavaScript警告。若要為所有使用者去除這個警告，請把下列文字增加至”conf/userscript.js”中：

  $lang['js']['nosmblinks'] = '';

==== 圖片連結 ====

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

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

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

注意：在%%[[%%網址%%|%%連結名稱%%]]%%的「連結名稱」處，若用「%%{{%%%%}}%%」的話，則只能輸入圖檔名稱。

DokuWiki支援完整的圖像和連結語法，包括圖像大小調整、內部和外部的圖像與連結，以及wiki內連結。

===== 註解 =====

您可以任意增加註解 ((這是示範註解)) ，怎麼用呢？
把要註解的文字用兩組括號類似包水餃一樣包起來就好囉。
而註解的編號管理，請別擔心，DokuWiki 會自動幫您弄好。:-)

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

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

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

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

「%%======%%」有六個等號，是「第一級標題層次」，
而本節目前是「%%===== 目錄的節次結構 =====%%」，也就是「第二級標題層次」


==== 第三級標題層次 ====
=== 第四級標題層次 ===
== 第五級標題層次 ==

  ==== 第三級標題層次 ====
  === 第四級標題層次 ===
  == 第五級標題層次 ==

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

===== 各種貼圖方式 =====

=== 貼圖語法 ===
可以用兩組重疊的 %%{{}}%% 花括號來貼圖或檔案，詳情請見 [[doku>images]]。
也可以在編輯時用工具列的按鈕來完成。

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

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

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

== 圖檔變化說明舉例 1 ==
{{ wiki:dokuwiki-128.png}}

  {{ wiki:dokuwiki-128.png}}
  這張會出現在右邊，注意到了嗎？
  檔名跟左邊的括號隔了一個空白唷~
  這代表靠右放
  換言之，
  很簡單就可以把圖片靠右放置，對吧？

== 圖檔變化說明舉例 2 ==
{{wiki:dokuwiki-128.png }}

  {{wiki:dokuwiki-128.png }}
  這張會出現在左邊，注意到了嗎？
  檔名跟右邊的括號隔了一個空白唷~
  這代表靠左放
  換言之，
  很簡單就可以把圖片靠左放置，對吧？

== 圖檔變化說明舉例 3 ==
{{ wiki:dokuwiki-128.png }}

  {{ wiki:dokuwiki-128.png }}
  這張會出現在中間，注意到了嗎？
  檔名跟左右兩邊的括號都隔了一個空白唷~
  這代表往中間放
  換言之，
  很簡單就可以把圖片居中放置，對吧？

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

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

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

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

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

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

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

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

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

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

  - 空行，則會結束列表，重新起算編號。
</code>
===== 文本轉換 =====

DokuWiki可以將預定義的字符或者字符串轉換成圖片、其他文本或HTML。

文本到圖片的轉換，主要用作表情符號。文本到HTML的轉換，多用於顯示符號替換，但也可以配置為使用其他HTML。

==== 表情符號 ====

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|
好用嗎？多介紹一個：「%%^_^%%」，它是很熟悉的笑臉：^_^。

==== 顯示符號 ====

^原始寫法^輸出的顯示符號(或結果)^
|%%->%%|->|
|%%<-%%|<-|
|%%<->%%|<->|
|%%=>%%|=>|
|%%<=%%|<=|
|%%<=>%%|<=>|
|%%>>%%|>>|
|%%<<%%|<<|
|%%--%%|--|
|%%---%%|---|
|%%640x480%%|640x480|
|%%(c)%%|(c)|
|%%(tm)%%|(tm)|
|%%(r)%%|(r)|
|%%"He thought 'It's a man's world'..."%%|"He thought 'It's a man's world'..."|

注意: 若您不想要這項功能的話，可以在[[config|設定選項]]中關閉。

您可以到[[doku>entities|模式文件]]裏添加顯示符號之轉換。

然而，上述例子中，有三個符號並非來自模式文件。它們是：乘號(640×480)、單引號( 'Miku' )和雙引號( ”Miku” )。您可到[[doku>config:typography|設定選項]]裏關閉之。

===== 層次標示 =====

有時候（特別是討論時）您想把某些文字（尤為各次的回覆）標示作不同的層次，您可以使用下列的語法：

  我想我們應該這麼做
  
  > 不，我們不該。
  
  >> 嗯，我想我們應該。
  
  > 真的嗎？
  
  >> 當然！
  
  >>> 那就做吧！

我想我們應該這麼做

> 不，我們不該。

>> 嗯，我想我們應該。

> 真的嗎？

>> 當然！

>>> 那就做吧！

===== 表格 =====

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

^ 標題1        ^ 標題2         ^ 標題3        ^
| (1,1)        | (1,2)         | (1,3)        |
| (2,1)        | 水平合併示範（注意兩條豎線）||
| (3,1)        | (3,2)         | (3,3)        |

以「<nowiki>|</nowiki>」開始與結束的是「普通欄位」，而「<nowiki>^</nowiki>」則是「標題欄位」。

  ^ 標題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)          |

方法就是直接在「標題3、4、5」前面加上「<nowiki>^</nowiki>」即可。

  |          ^ 標題1          ^ 標題2          ^
  ^ 標題3    | (1,2)          | (1,3)          |
  ^ 標題4    | 這次不再合併了 |                |
  ^ 標題5    | (2,2)          | (2,3)          |

您也可以垂直合併兩格或多格。只要在下面的格內輸入「<nowiki>:::</nowiki>」即可。

^ 標題1 ^ 標題2             ^ 標題3 ^
|(1,1)| 這次示範垂直合併    |(1,3)|
|(2,1)| :::                 |(2,3)|
|(3,1)| :::                 |(2,3)|

除跨行合併語法「<nowiki>:::</nowiki>」外，單元格中不能包含其他內容。

  ^ 標題1 ^ 標題2             ^ 標題3 ^
  |(1,1)| 這次示範垂直合併    |(1,3)|
  |(2,1)| :::                 |(2,3)|
  |(3,1)| :::                 |(2,3)|

您還可以對齊表格的文字。只要在文本的相反方向添加至少兩個半型空格：如果要靠右對齊，在左邊添加兩個半型空格；反之，則在右邊添加。在兩邊均添加空格，即可以居中對齊。

^           對齊了的表格                   ^^^
|      靠右對齊|   居中對齊   |靠左對齊      |
|靠左對齊      |      靠右對齊|   居中對齊   |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

下面是源文件中的樣子：

  ^           對齊了的表格                   ^^^
  |      靠右對齊|   居中對齊   |靠左對齊      |
  |靠左對齊      |      靠右對齊|   居中對齊   |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

注意：不支援垂直對齊。

===== 無格式化 =====

若有一段文字，您不要它作格式化處理，要顯示作原來的樣子，請用「%%<nowiki></nowiki>%%」標籤包圍這個區域。您也可以使用兩個百分號「<nowiki>%%</nowiki>」。

<nowiki>正如本段示範裏，本來包含了網址：http://www.splitbrain.org，以及**加上格式的文字**，但它沒有給格式化。連表情符號;-)的轉換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki>

  <nowiki>正如本段示範裏，本來包含了網址：http://www.splitbrain.org，
  以及**加上格式的文字**，但它沒有給格式化。
  連表情符號;-)的轉換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki>

===== 代碼區塊 =====

在文字每一行的前方加上兩個半型空格，可使該段文字以「文字方塊」方式顯示出來。在文字方塊裏，所有文字都會無格式化。您也可以用 「%%<code></code>%%」或「%%<file></file>%%」這兩個標籤去做到相同效果。

  這是前方加上了兩個半型空格的文字。
  即使有**甚麼格式**標示了，它都不會[[格式化]]。

<code>
這是沒有格式化的代碼，所有空格都保留下來。就像              <-這樣
</code>

<file>
這段也非常相似，但
您可以用它來表明
     您正在引述(Quote)別人的言論。
</file>

這些區塊由下面的源碼產生出來：

    這是前方加上了兩個半型空格的文字。
    即使有**甚麼格式**標示了，它都不會[[格式化]]。

  <code>
  這是沒有格式化的代碼，所有空格都保留下來。就像              <-這樣
  </code>

  <file>
  這段也非常相似，但
  您可以用它來表明
       您正在引述(Quote)別人的言論。
  </file>

===== 語法的高亮顯示 =====

DokuWiki可把原始碼語法以高亮模式顯示，使它更易閱讀。它使用GeSHi通用語法高亮器，只要是GeSHi支援的，DokuWiki也支援。用法就類似前例的「%%<code>%%」標籤，不過您要在標籤內指定該原始碼所使用的語言。例如是「%%<code java>%%」或「%%<file java>%%」。示範如下：

<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>

目前支援的語言有： //4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80//

==== 可下載的代碼區塊 ====

若您使用上述的「%%<code>%%」或「%%<file>%%」語法，您或許希望讓瀏覽者直接下載該段代碼。您可以在語言代碼後方指定一個文件名，方便瀏覽者下載：

<code>
<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
</code>

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>

若您不想把語法高亮顯示出，但想方便瀏覽者下載，您可以用破折號「-」作語言代碼。例如：「%%<code - myfile.foo>%%」。


===== 在內容中嵌入 HTML 或 PHP 語法 =====

可以在文件裏透過加入 ''%%<%%html%%>%%'' or ''%%<%%php%%>%%'' 標籤來使用 HTML 或 PHP，比如:

<html>
這是一段用 <font color="red" size="+1">HTML 寫的紅色字(size=+1)</font>
</html>

<code>
<html>
這是一段用 <font color="red" size="+1">HTML 寫的紅色字(size=+1)</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>
</code>



**請特別注意**: HTML 及 PHP 語法可以在[[config|設定選項]]中決定支援與否。若您的 DOKUWIKI 設定不打開這兩項功能(可單獨打開兩者之一功能)那麼上面的例子就不會被執行，而是直接顯示出來原始寫法。

**譯者建議**: HTML支援可以開啟，但不要開 PHP 支援，這會使有心人對您的 WIKI 系統甚至主機造成危險。
--- 譯者：//[[chinsan@FreeBSD.org|淡]] 2004/12/18 06:03//

===== RSS/ATOM Feed聚合 =====

DokuWiki能從外部XML feed中聚合數據。為分析這些XML feed，DokuWiki使用了[[http://simplepie.org/|SimplePie]]。凡是SimplePie能理解的格式，都可用於DokuWiki中。您可以更改不同的參數，以改變其渲染。參數之間請用空格隔開：

^ 參數  ^ 描述 ^
| any number | 最多顯示多少項內容；預設值是8。 |
| reverse    | 將最新條目顯示在前面。 |
| author     | 顯示條目的作者名字。 |
| date       | 顯示條目數據。 |
| description| 顯示條目的描述；如果[[doku>config:htmlok|HTML]]被禁用，所有標籤將被過濾掉 |
| //n//[dhm] | 刷新周期，其中，d=日數，h=小時數，m=分。例如，12h=12小時。 |

預設的刷新周期是4小時。小於10分鐘者亦視為10分鐘。DokuWiki通常會提供頁面的暫存版，但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴DokuWiki：若對上一次渲染時間已經過了//刷新周期//，就要重新渲染頁面。

**範例:**

  {{rss>http://slashdot.org/index.rss 5 author date 1h }}

{{rss>http://slashdot.org/index.rss 5 author date 1h }}


===== 控制巨集 =====

有些語法會影響DokuWiki對頁面的渲染，而自身不輸出任何內容。可用的控制巨集如下：

^ 巨集           ^ 描述|
| %%~~NOTOC~~%%   | 如果頁面出現該控制巨集，將不會創建目錄。 |
| %%~~NOCACHE~~%% | DokuWiki預設會緩存所有的輸出。有時您並不希望這樣（例如您使用了上述的%%<php>%%語法），便可使用這控制巨集，強制DokuWiki在每次訪問時都重新渲染頁面。 |

===== 語法附加元件 =====

運用[[doku>plugins|附加元件]]，可以擴充DokuWiki的語法。附加元件的安裝方法，請見其他相應頁面中說明。

~~INFO:syntaxplugins~~