您在这里: Typecho文档站点 » wiki » DokuWiki格式语法说明

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
wiki:syntax [2014/01/02 02:50] – ShingChiwiki:syntax [2024/06/12 10:10] (当前版本) – 外部编辑 127.0.0.1
行 1: 行 1:
 ====== DokuWiki格式语法说明 ====== ====== DokuWiki格式语法说明 ======
  
-[[DokuWiki]]支援簡單的語法，使文檔容易閱讀。本頁包含了您在編輯頁面時可以使用的語法。點選在頁面頂端或底端的「編輯本頁」按鈕，可觀看這一頁的原始檔。如要實驗，請移玉步至[[playground:playground|遊樂場頁面]]。您可以用[[doku>zh-tw:toolbar|編輯按鈕]]，讓編輯過程更方便。 +[[wiki:DokuWiki]] 支持一些简单的标记语言, 以尽最大可能使文档看上去更友好。本页面包含了所有你在编辑页面时可能用到的语法的说明。如果需要查看本页源码，只需要点击页面顶部或者底部的 //编辑本页// 按钮即可。\\ 
-歡迎各位中文用戶把本頁的原始碼抄下，並貼至您wiki系統裏的[[wiki:syntax]]頁面上，取代其英文說明。+如果您是初尝Wiki，那么可以使用 [[playground:playground|Wiki砂箱]] 来尽情挥洒。\\ 
 +通过[[doku>quickbuttons|快捷按钮]]，您可以更方便地使用这些标记。
  
-===== 基本文字格式 =====+===== 基本文本格式 =====
  
-DokuWiki支援**粗體**、//斜體//、__底線__、''英文等寬體（monospaced）''，並且可以**__//''混合（combine）使用''//__**。此外，DokuWiki亦支援<sup>上標</sup>、<sub>下標</sub>和<del>刪除線</del>。語法如下：+DokuWiki支持 **粗体**， //斜体//， __下划线__ 以及 ''等宽体'' 等格式。当然，您也可以 **__//''混合使用''//__** 所有这些格式。
  
-^文字格式^原始寫法^輸出效果^ +  DokuWiki支持 **粗体**， //斜体//， __下划线__ and ''等宽体'' 等格式。 
-|粗體|%%**粗體bold**%%|**粗體bold**| +  当然，您也可以 **__//''混合使用''//__** 所有这些格式。
-|斜體|%%//斜體italic//%%|//斜體italic//| +
-|底線|%%__底線underlined__%%|__底線underlined__| +
-|英文等寬體|%%''monospaced''%%|''monospaced''| +
-|上標|%%y = x<sup>2</sup> + 1%%|y = x<sup>2</sup> + 1| +
-|下標|%%H<sub>2</sub>O%%|H<sub>2</sub>O| +
-|刪除線|%%<del>刪除線</del>%%|<del>刪除線</del>|+
  
-DokuWiki使用**空行**來區分**段落**，段落與段落間會有明顯的空間以作分隔。+可以使用 <sub>下标</sub> 和 <sup>上标</sup>。
  
-若您要**強制換行**而不開新段落，您可以使用兩個倒斜線，加一個空格或Enter作爲標記。請看示範：+  可以使用 <sub>下标</sub> 和 <sup>上标</sup>。
  
-這是一些有換行標記的文字。\\ 請注意： +您也可以使用 <del>删除线</del> 标记某些信息。
-兩個倒斜線只在Enter之前\\ +
-或者接在\\ 一個空格之前，才會有效。\\而這樣就並不起作用。+
  
-  這是一些有換行標記的文字。\\ 請注意： +  您也可以使用 <del>删除线</del> 标记某些信息。
-  兩個倒斜線只在Enter之前\\ +
-  或者接在\\ 一個空格之前，才會有效。\\而這樣就並不起作用。+
  
-===== 連結 =====+**段落** 是由空行所建立的。如果您想 **强制建立新行** 而不建立段落，您可以使用两个连续的反斜杠+空格或是回车作为标记。请看样例：
  
-DokuWiki可使用多種型態的連結。介紹如下：+这是一些有着换行标记的文字。\\ 请注意 
 +反斜杠只在回车符之前\\ 
 +或者在\\ 一个空格之前的时候才有效。 \\而这样就并不起作用。
  
-==== 外部連結 ====+  这是一些有着换行标记的文字。\\ 请注意 
 +  反斜杠只在回车符之前\\ 
 +  或者在\\ 一个空格之前的时候才有效。 \\而这样就并不起作用。
  
-DokuWiki會自動標別外部連結，例如http://www.google.com或簡化式www.google.com。您也可把文本設定成連結：[[http://www.google.com|例如這樣會連到Google]]。連電郵也可以用<[email protected]>或[[[email protected]|andi]]來表示。+请只在必须的时候才使用强制的换行标记。
  
-  DokuWiki會自動標別外部連結，例如http://www.google.com或簡化式www.google.com。 +===== 链接 =====
-  您也可把文本設定成連結：[[http://www.google.com|例如這樣會連到Google]]。 +
-  連電郵也可以用<[email protected]>或[[[email protected]|andi]]來表示。+
  
-==== 內部連結 ====+DokuWiki支持多种形式的链接。
  
-您可以用兩組方括號包裹要連結的頁面名稱，產生內部連結。可以直接括起[[頁面名稱]]，或改爲顯示該連結的[[頁面名稱|說明文字]]。+==== 外部链接 ====
  
-  您可以用兩個方括號包裹要連結的頁面名稱，產生內部連結。 +外部链接会被自动地识别： http://www.google.com 或者简单地写作 www.google.com - 当然您也可以为链接设置名字： [[http://www.google.com|链接到google]]. 类似这样的电子邮件地址： <[email protected]> 也可以被识别。
-  可以直接括起[[頁面名稱]]，或改爲顯示該連結的[[頁面名稱|說明文字]]。+
  
-頁面名稱裏的大寫英文字母會自動變成小寫字母，並且不支援特殊符號。+  DokuWiki支持多种形式的链接。外部链接会被自动地识别： 
 +  http://www.google.com 或者简单地写作 www.google.com 
 +  - 当然您也可以为链接设置名字： [[http://www.google.com|链接到google]]。 
 +  类似这样的电子邮件地址： <[email protected]> 也可以被识别。
  
-您也可以使用半形冒號「:」產生分類名稱，替頁面歸類。例如[[wiki:syntax]]。+==== 内部链接 ====
  
-  您也可以使用半形冒號「:」產生分類名稱，替頁面歸類。例如[[wiki:syntax]]。+内部链接可以用方括号创建。您可以只给出链接的地址：[[doku>wiki:pagename]]，也可以附加上链接的名字：[[doku>wiki:pagename|我的链接]]。Wiki的页面名字将会被自动地识别为小写字母，并且不允许使用特殊字符。
  
-若想深入了解分類名稱（namespaces，或稱命名空間），請見[[doku>zh-tw:namespaces|這裏]]。+  内部链接可以用方括号创建。您可以只给出链接的地址：[[pagename]]， 
 +  也可以附加上链接的名字：[[pagename|我的链接]]。 
 +  Wiki的页面名字将会被自动地识别为小写字母，并且不允许使用特殊字符。
  
-您也可以直接連結某個頁面的某章節段落。就像HTML一樣，只要在該頁後面加上「#某章節」即可。比如：+您可以通过在页面名中使用冒号的方式来使用 [[wiki:namespaces|命名空间]]。
  
-這會連到[[syntax#內部連結|這一節]]。+  您可以通过在页面名中使用冒号的方式来使用 [[wiki:namespaces|命名空间]]。
  
-  這會連到[[syntax#內部連結|這一節]]。+如果您需要关于**命名空间(namespaces)**的更详细的信息，请参见 [[doku>wiki:namespaces]]。
  
-請注意:+您也可以链接到一个网页内部的某一节，只需要将该节书签的名称以一个#号分隔加在网页的地址后面即可。这是一个连向 [[syntax#internal|本节]] 的链接。
  
-  * [[syntax|已存在的頁面]]與[[不存在的頁面]]會以不同方式呈現。具體呈現方式，則視乎您的style.css裏CSS之設定。 +  这是一个连向 [[syntax#internal|本节]] 的链接。
-  * DokuWiki不會自動替[[wp>CamelCase|駝峰文字]]轉換成連結。若有需要，請在[[doku>zh-tw:config|設定選項]]裏開啟。 +
-    - 駝峰文字（CamelCase）簡言之就是「幾個英文單字之間緊接著而沒有空格」所組成的詞彙，但每個單字的首字大寫，狀如駝峰（[[dict>Camel]]），故得此名。 +
-    - 若在[[doku>zh-tw:config|設定選項]]裏開啟駝峰文字功能，那麼在文章內打出的駝峰文字（如：DokuWiki）就會自動成爲連結。 +
-  * 若章節所在的頁面標題改變了，其連結也會跟着改變。因此請別過度依賴章節連結功能。 +
-  * 此外，可參考[[doku>zh-tw:pagename|DokuWiki網站有關「頁面名稱」的說明]]。+
  
-==== Wiki間的互連 ====+注：
  
-DokuWiki支援[[doku>zh-tw:Interwiki|wiki間的互連]]。例如要連接到英文維基百科的「Wiki」頁，輸入[[wp>Wiki]]即可。+  * 到 [[wiki:syntax|已存在页面]] 的链接和到 [[wiki:nonexisting|未存在页面]] 的链接，其外观是不同的。 
 +  * 默认情况下，DokuWiki不使用 [[wp>CamelCase]] 来自动建立链接，（CamelCase类似于PmWiki中的WikiWord）。但是也可以在 [[doku>config|设置文件]] 中启用它。 Hint: If DokuWiki is a link, then it's enabled. 
 +  * 当一节的标题改变时，该节的书签也会改变，因此，请不要太依靠网页内的链接。
  
-  DokuWiki支援[[doku>zh-tw:Interwiki|wiki間的互連]]。 +==== Wiki间链接 ====
-  例如要連接到英文維基百科的「Wiki」頁，輸入[[wp>Wiki]]即可。+
  
-此外還可運用：+DokuWiki支持 [[doku>wiki:interwiki|Wiki间链接]] ，即到其他wiki的链接。例如，这是一个到Wikipedia上关于Wiki的一个页面的的链接： [[wp>Wiki]]
  
-^原始寫法^出現的結果^說明^ +  DokuWiki支持 [[interwiki|Wiki间链接]] ，即到其他wiki的链接。 
-|%%[[%%google>Wiki%%]]%%|[[google>Wiki]] |請 Google 搜尋大神幫您找有關 Wiki 的網頁| +  例如，这是一个到Wikipedia上关于Wiki的一个页面的的链接： [[wp>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，格式如下：+==== Windows共享文件夹 ====
  
-^捷徑名稱{NAME}^網址{URL}^ +Windows共享文件夹，例如 [[\\server\share|this]] 也可以被识别。请注意，这只在内部 [[wp>Intranet|局域网]] 等环境中才可能被成功访问。
-|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像素的PNG或GIF格式檔案。+  Windows共享文件夹，例如 [[\\server\share|this]] 也可以被识别。
  
-==== 網路芳鄰分享的連結 ====+注：
  
-微軟Windows主機使用SMB((Server Message Block))協定，或稱爲CIFS((CommonInternet File System))的協定。協定可讓Windows主機把另一Windows主機目錄檔案，當成是本機上的目錄檔案般使用。這就是網路芳鄰分享。這協定亦可用於互聯網。位於不同網段的Windows主機，若在傳送過程中未有其他的網路設備阻擋的話，也可使用此協定，進行目錄檔案的分享。其他作業系統，例如FreeBSD、Linux等，也可透過相關的Samba軟件，以使用這項功能。+  * 出于安全原因，只有在微软IE浏览器上才能够直接访问Windows共享文件夹。
  
-網芳資源可用[[\\server\share|這樣子]]來進行連結。 
  
-  網芳資源可用[[\\server\share|這樣子]]來進行連結。+==== 图像链接 ====
  
-另外可參考[[wp>Intranet]]的說明。 +您也可以用图像来作为一个内部或者外部的链接，只需同时使用链接和图像的语法，如下所示：
- +
-千萬要注意: +
- +
-  * 爲了系統安全，直接瀏覽「網路芳鄰」的功能只適用於微軟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}}]]
行 132: 行 95:
 [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
  
-注意：在%%[[%%網址%%|%%連結名稱%%]]%%的「連結名稱」處，若使用「%%{{%%%%}}%%」的話，則只能輸入圖片檔案名稱。+请注意：在链接名中使用语法，只有显示图像的语法会被识别，请不要使用其它语法。
  
-DokuWiki支援完整的圖像和連結語法，包括圖像大小調整、內部和外部的圖像與連結，以及wiki內連結。+===== 脚注 =====
  
-===== 註解 =====+您可以使用两个连续小括号来添加脚注((看这里，这是一个脚注))。
  
-您可以隨意增加註解((這是一個註解。))。只要用兩組圓括號括着註解文字即可。+  您可以使用两个连续小括号来添加脚注((看这里，这是一个脚注))。
  
-  您可以隨意增加註解((這是一個註解。))。只要用兩組圓括號括着註解文字即可。+===== 标题段落 =====
  
-===== 目錄的層次結構 =====+您可以使用最多达5层的标题来使您的页面更富结构性。如果您使用了三个以上的标题，那么DokuWiki会自动在页面上生成一个名为“本页目录”的标题列表。当然，您也可以关闭这项特性，只需在编辑时在页面里加入 ''<nowiki>~~NOTOC~~</nowiki>'' 字样即可。
  
-層次分明的內容、有條不絮的說明文字，總是最能令人消化吸收的。+==== H3标题 ==== 
 +=== H4标题 === 
 +== H5标题 ==
  
-我們可以透過設定最多五種不同層次的標題，來自動建構出目錄表。若該頁內有至少三個層次的標題，DokuWiki就會自動產生相對應的目錄表（table of contents，簡稱TOC）。若不想在該頁面顯示目錄表，只要在文章開頭輸入%%~~NOTOC~~%%即可。+  ==== H3标题 ==== 
 +  === H4标题 === 
 +  == H5标题 ==
  
-標題是在左右各以等號「=」標示，從兩個到六個等號，每增多一個等號，就代表更高層次的標題。有六個等號是「第一級標題層次」，而本節目前是%%===== 目錄的層次結構 =====%%，也就是「第二級標題層次」。請見示範：+您可以通过连续的4个以上“-”号来创建一条水平分割线：
  
-==== 第三級標題層次 ==== +----
-=== 第四級標題層次 === +
-== 第五級標題層次 ==+
  
-  ==== 第三級標題層次 ==== 
-  === 第四級標題層次 === 
-  == 第五級標題層次 == 
  
-另外，使用連續四個短折號「-」，組成「%%----%%」，即可產生水平線。如：+===== 图像和其它文件 =====
  
----- +您可以使用双大括号来在页面中加入 [[doku>images|图像]] 。您还可以选择是否指定图像的显示大小。
- +
-===== 內嵌圖片和其他檔案 ===== +
- +
-您可以用兩組花括號「%%{{%% %%}}%%」，在頁面中加入外部或內部的[[doku>zh-tw:images|圖片]]。您還可以指定它們的大小。+
  
-原始大小:                        {{wiki:dokuwiki-128.png}}+原始大小：                        {{wiki:dokuwiki-128.png}}
  
-縮放爲自訂的寬度(50 pixel):            {{wiki:dokuwiki-128.png?50}}+指定宽度：                        {{wiki:dokuwiki-128.png?50}}
  
-縮放爲自訂的大小(200×50)((若指定的長寬比與圖片本身不一致，在調整圖片大小前，它將被裁剪到新的比例。)): {{wiki:dokuwiki-128.png?200x50}}+指定宽度和高度：                  {{wiki:dokuwiki-128.png?200x50}}
  
-縮放外部連結的影像(100×100):           {{http://de3.php.net/images/php.gif?200x50}}+重新指定宽度和高度的外部图像：    {{http://de3.php.net/images/php.gif?200x50}}
  
-  原始大小:                        {{wiki:dokuwiki-128.png}} +  原始大小：                        {{wiki:dokuwiki-128.png}} 
-  縮放爲自訂的寬度(50 pixel):            {{wiki:dokuwiki-128.png?50}} +  指定宽度：                        {{wiki:dokuwiki-128.png?50}} 
-  縮放爲自訂的大小(200×50): {{wiki:dokuwiki-128.png?200x50}} +  指定宽度和高度：                  {{wiki:dokuwiki-128.png?200*50}} 
-  縮放外部連結的影像(100×100):           {{http://de3.php.net/images/php.gif?200x50}}+  重新指定宽度和高度的外部图像：    {{http://de3.php.net/images/php.gif?200x50}}
  
-使用左空格或右空格，您可以選擇對齊方式。請看示範：+使用左方或者右方的空格，您可以选择对齐方式：
  
 {{ wiki:dokuwiki-128.png}} {{ wiki:dokuwiki-128.png}}
行 191: 行 149:
   {{ wiki:dokuwiki-128.png }}   {{ wiki:dokuwiki-128.png }}
  
-上方的示範中，第一行把圖片置右，第二行把圖片置左，第三行則把圖片置中。+当然，您也可以指定一个图像的名字，将鼠标移到图像上可以看到效果。
  
-還可在圖片上加上說明文字（在多數的瀏覽器上，滑鼠移到該圖上則會顯示）。+{{ wiki:dokuwiki-128.png |这是图像的名字}}
  
-{{ wiki:dokuwiki-128.png |這是該圖的說明}}+  {{ wiki:dokuwiki-128.png |这是图像的名字}}
  
-  {{ wiki:dokuwiki-128.png |這是該圖的說明}}+如果您指定的文件名（无论是外部的还是内部的）不是一个图像（''gif,jpeg,png''），那么它将被显示为一个链接。
  
-若您所指定的檔案（無論是內部或外部連結）並不是圖片（即非GIF、JPEG、PNG這三種格式類型），那麼「這是該圖的說明」那段文字會被當作連結顯示出來，效果等同HTML中的%%<img alt=“這是該圖的說明”>%%。+===== 列表 =====
  
-要把圖片連至其他頁面，參看上方[[syntax#圖片連結|圖片連結]]段落。+Dokuwiki支持带编号或不带编号的列表。要使用列表，在文字前加入两个空格，然后使用''*''标志不带编号的列表，用''-''标志带编号的列表。
  
-===== 項目表 =====+  * 列表 
 +  * 第二项 
 +    * 下一层 
 +  * 第三项
  
-DokuWiki可使用項目表有兩種型態：數字及符號表。要建立項目表的話，在該行前面先空出兩格，然後加上「%%*%%」即可產生符號項目表。若用「%%-%%」則會產生數字項目表。 +  - 带编号的列表 
- +  - 第二项 
-  *這是項目表 +    - 用缩进表示更深的层 
-    * 然而 +  - 完了
-      * 也可以用不同層次的項目表來表達 +
-        * 其他 +
- +
-  - 這也一樣是項目表，不過前面會加上編號 +
-    - 第二項 +
-      - 只要在 ''-'' 或 ''*'' 前面多加空白，就會內縮爲更深（細微）的層次了。 +
-        - 第三項 +
- +
-  - 空行，則會結束列表，重新起算編號。+
  
 <code> <code>
-  *這是項目表 +  * 列表 
-    * 然而 +  * 第二项 
-      * 也可以用不同層次的項目表來表達 +    * 下一层 
-        * 其他 +  * 第三项
- +
-  - 這也一樣是項目表，不過前面會加上編號 +
-    - 第二項 +
-      - 只要在 ''-'' 或 ''*'' 前面多加空白，就會內縮爲更深（細微）的層次了。 +
-        - 第三項+
  
-  - 空行，則會結束列表，重新起算編號。+  - 带编号的列表 
 +  - 第二项 
 +    - 用缩进表示更深的层 
 +  - 完了
 </code> </code>
  
-更詳盡的說明，請看[[doku>faq:lists|DokuWiki上的FAQ on list items]]。+===== 表情符号 =====
  
-===== 文本轉換 =====+DokuWiki会将一些常用的  [[wp>emoticon|表情符号]] 转换为图像。除了默认的表情符号以外，您也可以在 ''smiley'' 文件夹中放入更多的表情图，然后在 ''conf/smileys.conf'' 中设置它们即可。下面是Dokuwiki包含了的表情图像：
  
-DokuWiki可以將預定義的字符或者字符串轉換成圖片、其他文本或HTML。+  * 8-) %%  8-)  %% 
 +  * 8-O %%  8-O  %% 
 +  * :-( %%  :-(  %% 
 +  * :-) %%  :-)  %% 
 +  * =)  %%  =)   %% 
 +  * :-/ %%  :-/  %% 
 +  * :-\ %%  :-\  %% 
 +  * :-? %%  :-?  %% 
 +  * :-D %%  :-D  %% 
 +  * :-P %%  :-P  %% 
 +  * :-O %%  :-O  %% 
 +  * :-X %%  :-X  %% 
 +  * :-| %%  :-|  %% 
 +  * ;-) %%  ;-)  %% 
 +  * ^_^ %%  ^_^  %% 
 +  * :?: %%  :?:  %% 
 +  * :!: %%  :!:  %% 
 +  * LOL %%  LOL  %% 
 +  * FIXME %%  FIXME %% 
 +  * DELETEME %% DELETEME %%
  
-文本到圖片的轉換，主要用作表情符號。文本到HTML的轉換，多用於顯示符號替換，但也可以配置爲使用其他HTML。+===== 印刷样式 =====
  
-==== 文本到圖片的轉換 ====+[[DokuWiki]]可以将特定字符转换为印刷时所用的样式。下面是可以识别的这类字符的列表：
  
-DokuWiki支援一些[[doku>zh-tw:Smileys|表情符號]]。表情符號圖片，都收錄於smiley目錄內。您可透過conf目錄下的smileys.conf檔案，來做更多的設定。+-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
 +"He thought 'It's a man's world'..."
  
-Dokuwiki已內建了一些表情符號，例如輸入「%%^_^%%」，就會顯示出大家很熟悉的笑臉：^_^。以下是目前DokuWiki其他內建的表情符號列表： +<code> 
- +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-^原始寫法^輸出效果^ +
-|%%8-)%%|8-)| +
-|%%8-O%%|8-O| +
-|%%:-(%%|:-(| +
-|%%:-)%%|:-)| +
-|%%=)%%|=)| +
-|%%:-/%%|:-/| +
-|%%:-\%%|:-\| +
-|%%:-?%%|:-?| +
-|%%:-D%%|:-D| +
-|%%:-P%%|:-P| +
-|%%:-O%%|:-O| +
-|%%:-X%%|:-X| +
-|%%:-|%%|:-|| +
-|%%;-)%%|;-)| +
-|%%:?:%%|:?:| +
-|%%:!:%%|:!:| +
-|%%LOL%%|LOL| +
-|%%FIXME%%|FIXME| +
-|%%DELETEME%%|DELETEME| +
- +
-==== 文本到顯示符號的轉換 ==== +
- +
-DokuWiki可將特定字符轉換爲顯示時所用的樣式。以下是部份可識別字符的例子： +
- +
-^原始寫法^輸出效果^ +
-|%%->%%|->| +
-|%%<-%%|<-| +
-|%%<->%%|<->| +
-|%%=>%%|=>| +
-|%%<=%%|<=| +
-|%%<=>%%|<=>| +
-|%%>>%%|>>| +
-|%%<<%%|<<| +
-|%%--%%|--| +
-|%%---%%|---| +
-|%%640x480%%|640x480| +
-|%%(c)%%|(c)| +
-|%%(tm)%%|(tm)| +
-|%%(r)%%|(r)| +
- +
-DokuWiki也可以自動辨別英文引號的開關。例如這一句：+
 "He thought 'It's a man's world'..." "He thought 'It's a man's world'..."
-它的原始碼就是： +</code>
- +
-  "He thought 'It's a man's world'..." +
- +
-您可以到[[doku>zh-tw:entities|模式文件]]裏添加顯示符號之轉換。 +
- +
-然而，上述例子中，有三個符號並非來自模式文件。它們是：乘號、英文單引號和英文雙引號。您可到[[doku>config:typography|設定選項]]裏關閉之。 +
- +
-===== 層次標示 ===== +
- +
-有時候（特別是討論時）您想把某些文字（尤爲各次的回覆）標示作不同的層次，您可以使用下列的語法： +
- +
-  我想我們應該這麼做 +
-   +
-  > 不，我們不該。 +
-   +
-  >> 嗯，我想我們應該。 +
-   +
-  > 眞的嗎？ +
-   +
-  >> 當然！ +
-   +
-  >>> 那就做吧！ +
- +
-那麼，DokuWiki便會顯示成： +
- +
-我想我們應該這麼做 +
- +
-> 不，我們不該。 +
- +
->> 嗯，我想我們應該。 +
- +
-> 眞的嗎？ +
- +
->> 當然！+
  
->>> 那就做吧！+请注意：在配置文件中可以禁用这类自动转换。
  
 ===== 表格 ===== ===== 表格 =====
  
-DokuWiki建立表格的方式很簡單：+DokuWiki可以用简单的语法创建表格。 
  
-^ 標題1        ^ 標題2         ^ 標題3        ^ +^ 标题1        ^ 标题2         ^ 标题3       ^ 
-| (1,1)        | (1,2)         | (1,3)        | +| (1,1)        | (1,2)         | (1,3)       | 
-| (2,1)        | 水平合併示範（注意兩條豎線）|| +| (2,1)        | 展宽的单元格               || 
-| (3,1)        | (3,2)         | (3,3)        |+| (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,1)        | (1,2)         | (1,3)       | 
 +  | (2,1)        | 展宽的单元格               || 
 +  | (3,1)        | (3,2)         | (3,3)       | 
 +要水平合并单元格，只需要将后一个单元格设置为空即可，如上面演示的一样。请确保每一行有相同数量的单元格分隔符！
  
-標題也可用於「垂直欄位」上：+竖直的标题列也是可以实现的：
  
-|          ^ 標題1          ^ 標題2          ^ +|          ^ 标题1          ^ 标题2          ^ 
-^ 標題3    | (1,2)          | (1,3)          | +^ 标题3    | (1,2)          | (1,3)          | 
-^ 標題4    | 這次不再合併了 |                | +^ 标题4    | 不再合并单元格 |                | 
-^ 標題5    | (2,2)          | (2,3)          |+^ 标题5    | (2,2)          | (2,3)          |
  
-方法就是直接在「標題3、4、5」前面加上「%%^%%」即可。+可以看到，单元格前面的分隔符决定了单元格的格式。
  
-  |          ^ 標題1          ^ 標題2          ^ +  |          ^ 标题1          ^ 标题2          ^ 
-  ^ 標題3    | (1,2)          | (1,3)          | +  ^ 标题3    | (1,2)          | (1,3)          | 
-  ^ 標題4    | 這次不再合併了 |                | +  ^ 标题4    | 不再合并单元格 |                | 
-  ^ 標題5    | (2,2)          | (2,3)          |+  ^ 标题5    | (2,2)          | (2,3)          |
  
-您也可以垂直合併兩格或多格。只要在下面的格內輸入「%%:::%%」即可。+注：垂直合并单元格尚未实现。
  
-^ 標題1 ^ 標題2             ^ 標題3 ^ +您可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可：如果需要右对齐，在左边添加两个空格；反之，则在右边添加。在两边均添加空格可以实现中间对齐。
-|(1,1)| 這次示範垂直合併    |(1,3)| +
-|(2,1)| :::                 |(2,3)| +
-|(3,1)| :::                 |(2,3)|+
  
-除跨行合併語法「%%:::%%」外，單元格中不能包含其他內容。 +^           有对齐的表格                   ^^^ 
- +|        右对齐|     居中     |左对齐        | 
-  ^ 標題1 ^ 標題2             ^ 標題3 ^ +|左对齐        |        右对齐|     居中     |
-  |(1,1)| 這次示範垂直合併    |(1,3)| +
-  |(2,1)| :::                 |(2,3)| +
-  |(3,1)| :::                 |(2,3)| +
- +
-您還可以對齊表格的文字。只要在文本的相反方向添加至少兩個半形空格：如果要靠右對齊，在左邊添加兩個半形空格；反之，則在右邊添加。在兩邊均添加空格，即可以居中對齊。 +
- +
-^           對齊了的表格                   ^^^ +
-|      靠右對齊|   居中對齊   |靠左對齊      | +
-|靠左對齊      |      靠右對齊|   居中對齊   |+
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-下面是源文件中的樣子：+下面是源文件中的格式：
  
-  ^           對齊了的表格                   ^^^ +  ^           有对齐的表格                   ^^^ 
-  |      靠右對齊|   居中對齊   |靠左對齊      | +  |        右对齐|     居中     |左对齐        | 
-  |靠左對齊      |      靠右對齊|   居中對齊   |+  |左对齐        |        右对齐|     居中     |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-注意：不支援垂直對齊。+===== 无格式区块 =====
  
-===== 無格式化 =====+在一段文字的最前面加上 2 个空白，来直接作为「文本框」不对它做加工处理(就像前面那些说明一样)。或者也可以用 ''%%<%%code%%>%%'' 或 ''%%<%%file%%>%%'' 这两个标签(tag)都可以达到类似效果。
  
-若有一段文字，您不要它作格式化處理，要顯示作原來的樣子，請用「%%<nowiki></nowiki>%%」標籤包圍這個區域。您也可以使用兩個百分號「<nowiki>%%</nowiki>」。+<code> 
 +这段是用 <code> 产生的，所有空格及所有原始格式都会照样显示，还其本色。 
 + 就像       <-这个
  
-<nowiki>正如本段示範裏，本來包含了網址：http://www.splitbrain.org，以及**加上格式的文字**，但它沒有給格式化。連表情符號;-)的轉換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki> +或者 
- +    方与圆  似刚与柔 
-  <nowiki>正如本段示範裏，本來包含了網址：http://www.splitbrain.org， +    圆契合于方 
-  以及**加上格式的文字**，但它沒有給格式化。 +    方契合于圆 
-  連表情符號;-)的轉換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki> +    两心同一点
- +
-===== 代碼區塊 ===== +
- +
-在文字每一行的前方加上兩個半形空格，可使該段文字以「文字方塊」方式顯示出來。在文字方塊裏，所有文字都會無格式化。您也可以用「%%<code></code>%%」或「%%<file></file>%%」這兩個標籤去做到相同效果。 +
- +
-  這是前方加上了兩個半形空格的文字。 +
-  即使有**甚麼格式**標示了，它都不會[[格式化]]。 +
- +
-<code> +
-這是沒有格式化的代碼，所有空格都保留下來。就像              <-這樣+
 </code> </code>
  
 <file> <file>
-這段也非常相似，但 +这段跟上段很像，但是改用 <file> ，可以把它用在「引述名言(Quote)」效果上。   
-您可以用它來表明 +   
-     您正在引述(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
 </file> </file>
  
-這些區塊由下面的源碼產生出來：+若要略过某段内含 WIKI 语法，不对该段文字作任何处理， 
 +可以使用 ''%%<%%nowiki%%>%%'' 标签或更简单一点用 2 个 ''<nowiki>%%</nowiki>'' 放在该段文字的前后，请参考下面例子：
  
-    這是前方加上了兩個半形空格的文字。 + ''%%<%%nowiki%%>%%''<nowiki>这段字不要用 [[WIKI]] 语法</nowiki>''%%<%%/nowiki%%>%%''  
-    即使有**甚麼格式**標示了，它都不會[[格式化]]。+或是''<nowiki>%%</nowiki>''%%这段字不要用 [[WIKI]] 语法%%''<nowiki>%%</nowiki>''
  
-  <code> +<nowiki> 
-  這是沒有格式化的代碼，所有空格都保留下來。就像              <-這樣 +这一段包含一些原本会在 WIKI 内有特殊处理，像是 http://www.splitbrain.org 及 **强调语气的文字** ，但是正如所看到的，这里什么都不做任何处理。 
-  </code>+</nowiki>
  
-  <file> +您可以看本页的原始写法来察看这一段是怎么写的。
-  這段也非常相似，但 +
-  您可以用它來表明 +
-       您正在引述(Quote)別人的言論。 +
-  </file>+
  
-===== 語法的高亮顯示 ===== +===== 语法的高亮度显示 =====
- +
-DokuWiki可把原始碼語法以高亮模式顯示，使它更易閱讀。它使用GeSHi通用語法高亮器，只要是GeSHi支援的，DokuWiki也支援。用法就類似前例的「%%<code></code>%%」標籤，不過您要在標籤內指定該原始碼所使用的語言。例如是「%%<code java></code>%%」或「%%<file java></file>%%」。示範如下：+
  
 +[[DokuWiki]] 可把原始码语法来做高亮度显示(Syntax Highlighting)，来更加具可读性。
 +它采用的是 [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter —— 所以只要 GeSHi 有支持的，DokuWiki 亦可。
 + 
 +用法就类似前例的 %%<code>%% ，但要在标签(tag)内指定该原始码所使用的语言。比如 ''<nowiki><code java></nowiki>''
 +举例：
 <code java> <code java>
  
行 451: 行 333:
 </code> </code>
  
-目前支援的語言有： //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, 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, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//+目前支持的语言有: //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//
  
-==== 可下載的代碼區塊 ====+==== 可下载的代码块 ====
  
-若您使用上述的「%%<code>%%」或「%%<file>%%」語法，您或許希望讓瀏覽者直接下載該段代碼。您可以在語言代碼後方指定一個文件名，方便瀏覽者下載：+若您使用上述的「%%<code>%%」或「%%<file>%%」语法，您或許希望让浏览者直接下载该段代码。您可以在语言代码后方指定一個文件名，方便浏览者下载：
  
 <code> <code>
行 467: 行 349:
 </file> </file>
  
-若您不想把語法高亮顯示出，但想方便瀏覽者下載，您可以用短折號「-」作語言代碼。例如：「%%<code - myfile.foo>%%」。 +若您不想把语法高亮显示出，但想方便浏览者下载，您可以用链接号「-」作语言代码。例如：「%%<code - myfile.foo>%%」。
- +
-===== 在內容中嵌入HTML或PHP語法 ===== +
- +
-您可以在文件裏加入「''%%<%%html%%>%%''」或「''%%<%%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> +
- +
-**請特別注意**：您可以在[[doku>zh-tw:config|設定選項]]中，選擇是否支援HTML及PHP語法。若您的DokuWiki設定爲不開啟這兩項功能，那麼上面的例子就無法正常顯示，只會直接顯示出來原始寫法。您也可選擇只開啟兩項功能之一。開啟了這兩項功能後，可能會爲有心破壞的人提供機會，對您的wiki系統甚至主機造成危險。+
  
 ===== RSS/ATOM Feed聚合 ===== ===== RSS/ATOM Feed聚合 =====
打印/导出