wiki:DokuWiki 支持一些簡單的標記語言。本頁面包含了你在編輯頁面時所有可能用到的語法的說明。如果需要查看本頁源碼,只需要點擊頁面頂部或者底部的編輯本頁 (或者顯示源碼)即可。
如果您是初次使用DokuWiki或是現在想嘗試一下,可以進入測試頁面隨意發揮。
ⓐ 校勘的編號在經文中的呈現(縮小)
ⓐ 校勘的編號在經文中的呈現(縮小)
[1] 校勘的編號在校勘區的呈現(不縮小)
[1] 校勘的編號在校勘區的呈現(不縮小)
① 註解的編號在經文中的呈現(縮小)
① 註解的編號在經文中的呈現(縮小)
[一] 註解的編號在註解區的呈現(不縮小)
[一] 註解的編號在註解區的呈現(不縮小)
註解可自動編號,因此在經文中標示 - [ ] -,在註解區標示 [ ] 即可,括弧中間不一定要標數字。
[*] 校勘已有出現時的呈現(縮小)
[*] 校勘已有出現時的呈現(縮小)
摘句的標題
-{摘句的標題}-
摘句(佳句)的內容
-<摘句(佳句)的內容>-
框起內容
<box 100%>框起內容</box>
引用經文
<code>引用經文</ code>
強制
建立新行
強制\\ 建立新行
以下其餘的功能中,「標題段落」、「圖像和其他文件」、「列表」及「表格」可參考,其餘的請盡量使用阿含經集印專用格式。
DokuWiki支持 粗體, 斜體, 下劃線 以及 等寬體
等格式。當然,您也可以 混合使用
所有這些格式。
DokuWiki支持 **粗體**, //斜體//, __下劃線__ and ''等寬體'' 等格式。 當然,您也可以 **__//''混合使用''//__** 所有這些格式。
可以使用 下標 和 上標。
可以使用 <sub>下標</sub> 和 <sup>上標</sup>。
您也可以使用 刪除線 標記某些信息。
您也可以使用 <del>刪除線</del> 標記某些信息。
本站並支援 !!螢光筆!!, 文字變色這些格式。
請注意,不要用此功能來標示阿含的摘句!阿含的摘句請仍用 這樣
本站並支援 !!螢光筆!!, <color green>文字變色</color>這些格式。 請注意,不要用此功能來標示阿含的摘句!阿含的摘句請仍用 -<這樣>-
您也可加上
您也可加上 <note>便條紙</note>。
段落 是由空行所建立的。如果您想 強制建立新行 而不建立段落,您可以使用兩個連續的反斜杠+空格或是回車作為標記。請看樣例:
這是一些有著換行標記的文字。
請注意
反斜杠只在回車符之前
或者在
一個空格之前的時候才有效。 \\而這樣就並不起作用。
這是一些有著換行標記的文字。\\ 請注意 反斜杠只在回車符之前\\ 或者在\\ 一個空格之前的時候才有效。 \\而這樣就並不起作用。
請只在必須的時候才使用強制的換行標記。
DokuWiki支持多種形式的鏈接。
外部鏈接會被自動地識別: http://www.google.com 或者簡單地寫作 www.google.com - 當然您也可以為鏈接設置名字: 鏈接到google. 類似這樣的電子郵件地址: andi@splitbrain.org 也可以被識別。
DokuWiki支持多種形式的鏈接。外部鏈接會被自動地識別: http://www.google.com 或者簡單地寫作 www.google.com - 當然您也可以為鏈接設置名字: [[http://www.google.com|鏈接到google]]。 類似這樣的電子郵件地址: <andi@splitbrain.org> 也可以被識別。
內部鏈接可以用方括號創建。您可以只給出鏈接的地址:wiki:pagename,也可以附加上鏈接的名字:wiki:pagename。Wiki的頁面名字將會被自動地識別為小寫字母,並且不允許使用特殊字符。
內部鏈接可以用方括號創建。您可以只給出鏈接的地址:[[pagename]], 也可以附加上鏈接的名字:[[pagename|我的鏈接]]。 Wiki的頁面名字將會被自動地識別為小寫字母,並且不允許使用特殊字符。
您可以通過在頁面名中使用冒號的方式來使用 命名空間。
您可以通過在頁面名中使用冒號的方式來使用 [[wiki:namespaces|命名空間]]。
如果您需要關于命名空間(namespaces)的更詳細的信息,請參見 wiki:namespaces。
您也可以鏈接到一個網頁內部的某一節,只需要將該節書簽的名稱以一個#號分隔加在網頁的地址後面即可。這是一個連向 本節 的鏈接。
這是一個連向 [[syntax#internal|本節]] 的鏈接。
注:
DokuWiki支持 wiki:interwiki ,即到其他wiki的鏈接。例如,這是一個到Wikipedia上關于Wiki的一個頁面的的鏈接: Wiki
DokuWiki支持 [[interwiki|Wiki間鏈接]] ,即到其他wiki的鏈接。 例如,這是一個到Wikipedia上關于Wiki的一個頁面的的鏈接: [[wp>Wiki]]
Windows共享文件夾,例如 this 也可以被識別。請注意,這只在內部 Intranet 等環境中才可能被成功訪問。
Windows共享文件夾,例如 [[\\server\share|this]] 也可以被識別。
注:
您也可以用圖像來作為一個內部或者外部的鏈接,只需同時使用鏈接和圖像的語法,如下所示:
[[http://www.php.net|{{wiki:php-powered.png}}]]
請注意:在鏈接名中使用語法,只有顯示圖像的語法會被識別,請不要使用其它語法。
您可以使用兩個連續小括號來添加腳注1)。
您可以使用兩個連續小括號來添加腳注((看這里,這是一個腳注))。
您可以使用最多達5層的標題來使您的頁面更富結構性。如果您使用了三個以上的標題,那麼DokuWiki會自動在頁面上生成一個名為“本頁目錄”的標題列表。當然,您也可以關閉這項特性,只需在編輯時在頁面里加入 ~~NOTOC~~
字樣即可。
==== H3標題 ==== === H4標題 === == H5標題 ==
您可以通過連續的4個以上“-”號來創建一條水平分割線:
您可以使用雙大括號來在頁面中加入 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 }} {{ wiki:php-powered.png }}
當然,您也可以指定一個圖像的名字,將鼠標移到圖像上可以看到效果。
{{ wiki:php-powered.png |這是圖像的名字}}
如果您指定的文件名(無論是外部的還是內部的)不是一個圖像(gif,jpeg,png
),那麼它將被顯示為一個鏈接。
Dokuwiki支持帶編號或不帶編號的列表。要使用列表,在文字前加入兩個空格,然後使用*
標志不帶編號的列表,用-
標志帶編號的列表。
* 列表 * 第二項 * 下一層 * 第三項 - 帶編號的列表 - 第二項 - 用縮進表示更深的層 - 完了
DokuWiki會將一些常用的 emoticon 轉換為圖像。除了默認的表情符號以外,您也可以在 smiley
文件夾中放入更多的表情圖,然後在 conf/smileys.conf
中設置它們即可。下面是Dokuwiki包含了的表情圖像:
DokuWiki可以將特定字符轉換為印刷時所用的樣式。下面是可以識別的這類字符的列表:
→ ← ↔ ⇒ ⇐ ⇔ » « -- — 640×480 © ™ ® “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長度單位),不設定寬度的則用 - 即可。
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 可以將源代碼作語法高亮以增加可讀性。它使用稱作 GeSHi 的通用語法高亮工具(Generic Syntax Highlighter)――所有被GeSHi支持的語言都可以在DokuWiki中得到高亮。使用code標記的方法和上面是類似的,不過需要指定使用的語言,例如: <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. } }
現在,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> 這是 <font color="red" size="+1">HTML</font> 代碼。 </html>
這是 HTML 代碼。
<php> echo '由PHP生成的logo:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; </php>
echo '由PHP生成的logo:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
請注意: HTML和PHP嵌入的功能默認情況下是被禁用的,因此,您可能無法看到上面的代碼運行的結果而只能夠看見源代碼,這取決于DokuWiki站點的設置。
參考資料
注:本文檔中文原始版由 jiayq84@gmail.com 根據DokuWiki 2005.2.6版本的語法說明翻譯,轉載請保留本行信息。
DokuWiki 的語法可以通過 wiki:plugins 的方式進行擴展. 在相應插件的頁面有安裝說明。下列語法插件適用于當前版本中: