====== Wiki 語法說明 ====== [[wiki:DokuWiki]] 支持一些簡單的標記語言。本頁面包含了你在編輯頁面時所有可能用到的語法的說明。如果需要查看本頁源碼，只需要點擊頁面頂部或者底部的//編輯本頁// (或者//顯示源碼//)即可。\\ 如果您是初次使用DokuWiki或是現在想嘗試一下，可以進入[[playground:playground|測試頁面]]隨意發揮。\\ ===== 阿含經集印專用格式 ===== -[1]- 校勘的編號在經文中的呈現（縮小） -[1]- 校勘的編號在經文中的呈現（縮小） [1] 校勘的編號在校勘區的呈現（不縮小） [1] 校勘的編號在校勘區的呈現（不縮小） -[一]- 註解的編號在經文中的呈現（縮小） -[一]- 註解的編號在經文中的呈現（縮小） [一] 註解的編號在註解區的呈現（不縮小） [一] 註解的編號在註解區的呈現（不縮小） 註解可自動編號，因此在經文中標示 - [ ] -，在註解區標示 [ ] 即可，括弧中間不一定要標數字。 \\ [＊] 校勘已有出現時的呈現（縮小） [＊] 校勘已有出現時的呈現（縮小） \\ -{摘句的標題}- -{摘句的標題}- -<摘句（佳句）的內容>- -<摘句（佳句）的內容>- 框起內容 框起內容 引用經文 引用經文 強制\\ 建立新行 強制\\ 建立新行 以下其餘的功能中，「標題段落」、「圖像和其他文件」、「列表」及「表格」可參考，其餘的請盡量使用阿含經集印專用格式。 ===== 基本文本格式 ===== DokuWiki支持 **粗體**， //斜體//， __下劃線__ 以及 ''等寬體'' 等格式。當然，您也可以 **__//''混合使用''//__** 所有這些格式。 DokuWiki支持 **粗體**， //斜體//， __下劃線__ and ''等寬體'' 等格式。 當然，您也可以 **__//''混合使用''//__** 所有這些格式。 可以使用 下標 和 上標。 可以使用 下標 和 上標。 您也可以使用 刪除線 標記某些信息。 您也可以使用 刪除線 標記某些信息。 本站並支援 !!螢光筆!!， 文字變色這些格式。\\ 請注意，不要用此功能來標示阿含的摘句！阿含的摘句請仍用 -<這樣>- 本站並支援 !!螢光筆!!， 文字變色這些格式。 請注意，不要用此功能來標示阿含的摘句！阿含的摘句請仍用 -<這樣>- 您也可加上 便條紙，這功能還有 important, tip, warning 三種額外的參數可指定。 您也可加上 便條紙。 **段落** 是由空行所建立的。如果您想 **強制建立新行** 而不建立段落，您可以使用兩個連續的反斜杠+空格或是回車作為標記。請看樣例： 這是一些有著換行標記的文字。\\ 請注意 反斜杠只在回車符之前\\ 或者在\\ 一個空格之前的時候才有效。 \\而這樣就並不起作用。 這是一些有著換行標記的文字。\\ 請注意 反斜杠只在回車符之前\\ 或者在\\ 一個空格之前的時候才有效。 \\而這樣就並不起作用。 請只在必須的時候才使用強制的換行標記。 ===== 鏈接 ===== DokuWiki支持多種形式的鏈接。 ==== 外部鏈接 ==== 外部鏈接會被自動地識別： http://www.google.com 或者簡單地寫作 www.google.com - 當然您也可以為鏈接設置名字： [[http://www.google.com|鏈接到google]]. 類似這樣的電子郵件地址： 也可以被識別。 DokuWiki支持多種形式的鏈接。外部鏈接會被自動地識別： http://www.google.com 或者簡單地寫作 www.google.com - 當然您也可以為鏈接設置名字： [[http://www.google.com|鏈接到google]]。 類似這樣的電子郵件地址： 也可以被識別。 ==== 內部鏈接 ==== 內部鏈接可以用方括號創建。您可以只給出鏈接的地址：[[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會自動在頁面上生成一個名為“本頁目錄”的標題列表。當然，您也可以關閉這項特性，只需在編輯時在頁面里加入 ''~~NOTOC~~'' 字樣即可。 ==== 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支持帶編號或不帶編號的列表。要使用列表，在文字前加入兩個空格，然後使用''*''標志不帶編號的列表，用''-''標志帶編號的列表。 * 列表 * 第二項 * 下一層 * 第三項 - 帶編號的列表 - 第二項 - 用縮進表示更深的層 - 完了 * 列表 * 第二項 * 下一層 * 第三項 - 帶編號的列表 - 第二項 - 用縮進表示更深的層 - 完了 ===== 表情符號 ===== 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'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." 請注意：在配置文件中可以禁用這類自動轉換。 ===== 表格 ===== 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 | 下面是源文件中的格式： |< 100% 50px - 5em 10em 10% >| ^ A ^ B ^ C ^ D ^ E ^ | 1 | 2 | 3 | 4 | 5 | ===== 無格式區塊 ===== 您可以在文章中插入無格式區塊，在這些區塊中Wiki語法將不起作用。可以有三種方法：在行前加兩個以上的空格（前面做樣例時用的方法），或者可以使用 ''Code'' 或 ''file'' 標記。 這是一段被code包圍的區塊，其中的空格都被保留了：像 <-這樣 和code是類似的。不過您可以用這個來表示您引用了一個文件的內容。 要讓Wiki語法解釋完全失效，可以用 ''nowiki'' 標簽包圍整個區塊，或者也可以簡單地使用雙百分號標記 ''%%''。 這是一段完全沒有Wiki語法解釋的文字，例如：http://www.splitbrain.org ， **粗體**，雖然按照語法書寫，但是它們並沒有被解釋。 如何使用這些標記，請查看這一段的源文件。 ===== 語法高亮 ===== [[DokuWiki]] 可以將源代碼作語法高亮以增加可讀性。它使用稱作 [[http://qbnz.com/highlighter/|GeSHi]] 的通用語法高亮工具（Generic Syntax Highlighter）――所有被GeSHi支持的語言都可以在DokuWiki中得到高亮。使用code標記的方法和上面是類似的，不過需要指定使用的語言，例如： ''''。 /** * 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. } } 現在，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的代碼。例如： 這是 HTML 代碼。 這是 HTML 代碼。 echo '由PHP生成的logo：'; echo 'PHP Logo !'; echo '由PHP生成的logo：'; echo 'PHP Logo !'; **請注意**： 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 (繁體中文)]] \\ 注：本文檔中文原始版由 根據DokuWiki 2005.2.6版本的語法說明翻譯，轉載請保留本行信息。\\ \\ ===== 語法插件 ===== DokuWiki 的語法可以通過 [[doku>wiki:plugins|插件]] 的方式進行擴展. 在相應插件的頁面有安裝說明。下列語法插件適用于當前版本中: ~~INFO:syntaxplugins~~