本頁目錄

Wiki 語法說明

wiki:DokuWiki 支持一些簡單的標記語言。本頁面包含了你在編輯頁面時所有可能用到的語法的說明。如果需要查看本頁源碼,只需要點擊頁面頂部或者底部的編輯本頁 (或者顯示源碼)即可。
如果您是初次使用DokuWiki或是現在想嘗試一下,可以進入測試頁面隨意發揮。

阿含經集印專用格式

校勘的編號在經文中的呈現(縮小)

 校勘的編號在經文中的呈現(縮小)

[1] 校勘的編號在校勘區的呈現(不縮小)

[1] 校勘的編號在校勘區的呈現(不縮小)

註解的編號在經文中的呈現(縮小)

 註解的編號在經文中的呈現(縮小)

[一] 註解的編號在註解區的呈現(不縮小)

[一] 註解的編號在註解區的呈現(不縮小)

註解可自動編號,因此在經文中標示 - [ ] -,在註解區標示 [ ] 即可,括弧中間不一定要標數字。


[*] 校勘已有出現時的呈現(縮小)

[*] 校勘已有出現時的呈現(縮小)


摘句的標題

-{摘句的標題}-

摘句(佳句)的內容

-<摘句(佳句)的內容>-

框起內容

<box 100%>框起內容</box>
引用經文
<code>引用經文</ code>

強制
建立新行

強制\\
建立新行

以下其餘的功能中,「標題段落」、「圖像和其他文件」、「列表」及「表格」可參考,其餘的請盡量使用阿含經集印專用格式。

基本文本格式

DokuWiki支持 粗體斜體下劃線 以及 等寬體 等格式。當然,您也可以 混合使用 所有這些格式。

DokuWiki支持 **粗體**, //斜體//, __下劃線__ and ''等寬體'' 等格式。
當然,您也可以 **__//''混合使用''//__** 所有這些格式。

可以使用 下標上標

可以使用 <sub>下標</sub> 和 <sup>上標</sup>。

您也可以使用 刪除線 標記某些信息。

您也可以使用 <del>刪除線</del> 標記某些信息。

本站並支援 !!螢光筆!!, 文字變色這些格式。
請注意,不要用此功能來標示阿含的摘句!阿含的摘句請仍用 這樣

本站並支援 !!螢光筆!!, <color green>文字變色</color>這些格式。
請注意,不要用此功能來標示阿含的摘句!阿含的摘句請仍用 -<這樣>-

您也可加上

便條紙

,這功能還有 important, tip, warning 三種額外的參數可指定。

您也可加上 <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|本節]] 的鏈接。

注:

Wiki間鏈接

DokuWiki支持 wiki:interwiki ,即到其他wiki的鏈接。例如,這是一個到Wikipedia上關于Wiki的一個頁面的的鏈接: Wiki

DokuWiki支持 [[interwiki|Wiki間鏈接]] ,即到其他wiki的鏈接。
例如,這是一個到Wikipedia上關于Wiki的一個頁面的的鏈接: [[wp>Wiki]] 

Windows共享文件夾

Windows共享文件夾,例如 this 也可以被識別。請注意,這只在內部 Intranet 等環境中才可能被成功訪問。

Windows共享文件夾,例如 [[\\server\share|this]] 也可以被識別。

注:

圖像鏈接

您也可以用圖像來作為一個內部或者外部的鏈接,只需同時使用鏈接和圖像的語法,如下所示:

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

請注意:在鏈接名中使用語法,只有顯示圖像的語法會被識別,請不要使用其它語法。

腳注

您可以使用兩個連續小括號來添加腳注1)

您可以使用兩個連續小括號來添加腳注((看這里,這是一個腳注))。

標題段落

您可以使用最多達5層的標題來使您的頁面更富結構性。如果您使用了三個以上的標題,那麼DokuWiki會自動在頁面上生成一個名為“本頁目錄”的標題列表。當然,您也可以關閉這項特性,只需在編輯時在頁面里加入 ~~NOTOC~~ 字樣即可。

H3標題

H4標題

H5標題
==== 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支持帶編號或不帶編號的列表。要使用列表,在文字前加入兩個空格,然後使用*標志不帶編號的列表,用-標志帶編號的列表。

  1. 帶編號的列表
  2. 第二項
    1. 用縮進表示更深的層
  3. 完了
  * 列表
  * 第二項
    * 下一層
  * 第三項

  - 帶編號的列表
  - 第二項
    - 用縮進表示更深的層
  - 完了

表情符號

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語法將不起作用。可以有三種方法:在行前加兩個以上的空格(前面做樣例時用的方法),或者可以使用 Codefile 標記。

這是一段被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或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 的方式進行擴展. 在相應插件的頁面有安裝說明。下列語法插件適用于當前版本中:

1) 看這里,這是一個腳注