DokuWiki语法格式说明
DokuWiki?支持一些簡(jiǎn)單的標(biāo)記語(yǔ)言, 以盡最大可能使文檔看上去更友好。本頁(yè)面包含了所有你在編輯頁(yè)面時(shí)可能用到的語(yǔ)法的說(shuō)明。如果需要查看本頁(yè)源碼，只需要點(diǎn)擊頁(yè)面頂部或者底部的?編輯本頁(yè)?按鈕即可。 I如果您是初嘗Wiki，那么可以使用?Wiki砂箱?來(lái)盡情揮灑。通過(guò)快捷按鈕，您可以更方便地使用這些標(biāo)記。
基本文本格式
DokuWiki支持?粗體,?斜體,?下劃線?以及?等寬體?等格式。 當(dāng)然，你也可以使用?混合使用?這些格式。
DokuWiki支持 **粗體**, //斜體//, __下劃線__ 以及 ''等寬體'' 等格式。 當(dāng)然，你也可以使用 **__//''混合使用''//__** 這些格式。
可以使用?下標(biāo)?和?上標(biāo)。
可以使用 <sub>下標(biāo)</sub> 和 <sup>上標(biāo)</sup>。
您也可以使用?刪除線?標(biāo)記某些信息。
您也可以使用 <del>刪除線</del> 標(biāo)記某些信息。
段落?是由空行所建立的。如果您想?強(qiáng)制建立新行?而不建立段落，您可以使用兩個(gè)連續(xù)的反斜杠+空格或是回車作為標(biāo)記。請(qǐng)看樣例：
這是一些有著換行標(biāo)記的文字。
請(qǐng)注意 反斜杠只在回車符之前
或者在
一個(gè)空格之前的時(shí)候才有效。 \\而這樣就并不起作用。
這是一些有著換行標(biāo)記的文字。\\ 請(qǐng)注意 反斜杠只在回車符之前\\ 或者在\\ 一個(gè)空格之前的時(shí)候才有效。 \\而這樣就并不起作用。
請(qǐng)只在必須的時(shí)候才使用強(qiáng)制的換行標(biāo)記。
鏈接
DokuWiki支持多種形式的鏈接。
外部鏈接
外部鏈接會(huì)被自動(dòng)地識(shí)別：http://www.google.com?或者簡(jiǎn)單地寫作?www.google.com?- 當(dāng)然您也可以為鏈接設(shè)置名字：鏈接到google。類似這樣的電子郵件地址：?andi [at] splitbrain [dot] org?也可以被識(shí)別。
DokuWiki支持多種形式的鏈接。外部鏈接會(huì)被自動(dòng)地識(shí)別： http://www.google.com 或者簡(jiǎn)單地寫作 www.google.com - 當(dāng)然您也可以為鏈接設(shè)置名字： [[http://www.google.com|鏈接到google]]。 類似這樣的電子郵件地址： <andi@splitbrain.org> 也可以被識(shí)別。
內(nèi)部鏈接
內(nèi)部鏈接可以用方括號(hào)創(chuàng)建。您可以只給出鏈接的地址：pagename，也可以附加上鏈接的名字：我的鏈接。
內(nèi)部鏈接可以用方括號(hào)創(chuàng)建。您可以只給出鏈接的地址：[[pagename]]， 也可以附加上鏈接的名字：[[pagename|我的鏈接]]。
Wiki的頁(yè)面名字?將會(huì)被自動(dòng)地識(shí)別為小寫字母，并且不允許使用特殊字符。
您可以通過(guò)在頁(yè)面名中使用冒號(hào)的方式來(lái)使用?命名空間。
您可以通過(guò)在頁(yè)面名中使用冒號(hào)的方式來(lái)使用 [[wiki:namespaces|命名空間]]。
如果您需要關(guān)于命名空間(namespaces)的更詳細(xì)的信息，請(qǐng)參見(jiàn)?namespaces.
您也可以鏈接到一個(gè)網(wǎng)頁(yè)內(nèi)部的某一節(jié)，只需要將該節(jié)書簽的名稱以一個(gè)#號(hào)分隔加在網(wǎng)頁(yè)的地址后面即可。這是一個(gè)連向?本節(jié)?的鏈接。
這是一個(gè)連向 [[syntax#內(nèi)部鏈接|本節(jié)]] 的鏈接。
注：
- 到?已存在頁(yè)面?的鏈接和到?未存在頁(yè)面?的鏈接，其外觀是不同的。
- 默認(rèn)情況下，DokuWiki不使用?CamelCase?來(lái)自動(dòng)建立鏈接，（CamelCase類似于PmWiki中的WikiWord）。但是也可以在?設(shè)置文件?中啟用它。 Hint: If DokuWiki is a link, then it’s enabled.
- 當(dāng)一節(jié)的標(biāo)題改變時(shí)，該節(jié)的書簽也會(huì)改變，因此，請(qǐng)不要太依靠網(wǎng)頁(yè)內(nèi)的鏈接。
Wiki間鏈接
DokuWiki支持?Wiki間鏈接?，即到其他wiki的鏈接。例如，這是一個(gè)到Wikipedia上關(guān)于Wiki的一個(gè)頁(yè)面的的鏈接：?Wiki?。
DokuWiki支持 [[interwiki|Wiki間鏈接]] ，即到其他wiki的鏈接。 例如，這是一個(gè)到Wikipedia上關(guān)于Wiki的一個(gè)頁(yè)面的的鏈接： [[wp>Wiki]] 。
Windows共享文件夾
Windows共享文件夾，例如?this?也可以被識(shí)別。請(qǐng)注意，這只在內(nèi)部?局域網(wǎng)?等環(huán)境中才可能被成功訪問(wèn)。
Windows共享文件夾，例如 [[\\server\share|this]] 也可以被識(shí)別。
注：
- 出于安全原因，只有在微軟IE瀏覽器上才能夠直接訪問(wèn)Windows共享文件夾。 (且只適用于局域網(wǎng)內(nèi)部環(huán)境).
-
Mozilla和Firefox可采用?Mozilla知識(shí)庫(kù)?中提到的方法實(shí)現(xiàn)此功能. 但是，在打開(kāi)Windows共享時(shí)仍然彈出JavaScript警告。如需為所有用戶刪除這個(gè)警告， 請(qǐng)將本行代碼加入?
conf/lang/en/lang.php中 (詳情見(jiàn)?localization):- conf/lang/en/lang.php
-
<?php /** * Customization of the english language file * Copy only the strings that needs to be modified */ $lang['js']['nosmblinks'] = '';
圖像鏈接
您也可以用圖像來(lái)作為一個(gè)內(nèi)部或者外部的鏈接，只需同時(shí)使用鏈接和圖像的語(yǔ)法，如下所示：
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
請(qǐng)注意：在鏈接名中使用語(yǔ)法，只有顯示圖像的語(yǔ)法會(huì)被識(shí)別，請(qǐng)不要使用其它語(yǔ)法。
DokuWiki支持完整的圖像及[#links|鏈接]]預(yù)發(fā)，包括調(diào)整圖像大小、內(nèi)部和外部的圖像鏈接，以及wiki內(nèi)鏈接。
腳注
您可以使用兩個(gè)連續(xù)小括號(hào)來(lái)添加腳注1)。
您可以使用兩個(gè)連續(xù)小括號(hào)來(lái)添加腳注((看這里，這是一個(gè)腳注))。
標(biāo)題段落
您可以使用最多達(dá)5層的標(biāo)題來(lái)使您的頁(yè)面更富結(jié)構(gòu)性。如果您使用了三個(gè)以上的標(biāo)題，那么DokuWiki會(huì)自動(dòng)在頁(yè)面上生成一個(gè)名為“本頁(yè)目錄”的標(biāo)題列表。當(dāng)然，您也可以關(guān)閉這項(xiàng)特性，只需在編輯時(shí)在頁(yè)面里加入?~~NOTOC~~?字樣即可。
H3標(biāo)題
H4標(biāo)題
H5標(biāo)題
==== H3標(biāo)題 ==== === H4標(biāo)題 === == H5標(biāo)題 ==
您可以通過(guò)連續(xù)的4個(gè)以上“-”號(hào)來(lái)創(chuàng)建一條水平分割線：
圖像和其它文件
您可以使用雙大括號(hào)來(lái)在頁(yè)面中加入?圖像，視頻及聲音文件?。您還可以選擇是否指定圖像的顯示大小。
原始大小：?
指定寬度(50 pixel)：?
指定寬度和高度(200×50)2)：?
重新指定寬度和高度的外部圖像(100×100)：?
原始大小： {{wiki:dokuwiki-128.png}}
指定寬度(50 pixel)： {{wiki:dokuwiki-128.png?50}}
指定寬度和高度(200×50)： {{wiki:dokuwiki-128.png?200*50}}
重新指定寬度和高度的外部圖像(100x100)： {{http://de3.php.net/images/php.gif?200x50}}
使用左方或者右方的空格，您可以選擇對(duì)齊方式：
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
當(dāng)然，您也可以指定一個(gè)圖像的名字，將鼠標(biāo)移到圖像上可以看到效果。
{{ wiki:dokuwiki-128.png |這是圖像的名字}}
如果您指定的文件名（無(wú)論是外部的還是內(nèi)部的）不是一個(gè)圖像（gif,jpeg,png），那么它將被顯示為一個(gè)鏈接。
支持的媒體格式
DokuWiki 可以直接在頁(yè)面中嵌入一下格式.
| 圖像 | gif,?jpg,?png |
| 視頻 | webm,?ogv,?mp4 |
| 音頻 | ogg,?mp3,?wav |
| Flash | swf |
如果指定不支持的媒體格式的文件名，則它將作為鏈接顯示。
加上??linkonly?就會(huì)在網(wǎng)頁(yè)中只顯示鏈接，不顯示內(nèi)容。
{{wiki:dokuwiki-128.png?linkonly}}
dokuwiki-128.png?這是一個(gè)圖片的鏈接。
備用的文件格式
并非所有瀏覽器都支持所有的視頻和音頻格式，要解決這個(gè)問(wèn)題，你可以上傳不同的文件格式，以獲得最大的瀏覽器兼容性。
例如有一個(gè) mp4 的視頻文件:
{{video.mp4|一個(gè)很有意思的視頻}}
如果同時(shí)上傳了?video.webm?和?video.ogv?到與?video.mp4?相同的命名空間的話, DokuWiki會(huì)自動(dòng)識(shí)別為備用的文件格式，并選擇一個(gè)最適合當(dāng)前瀏覽器的文件格式。
此外，DokuWiki也支持“視頻海報(bào)”，可以在視頻播放前顯示制定的圖片。該圖片必須與視頻文件名相同，并且為 jpg 和 png格式。
列表
Dokuwiki支持帶編號(hào)或不帶編號(hào)的列表。要使用列表，在文字前加入兩個(gè)空格，然后使用*標(biāo)志不帶編號(hào)的列表，用-標(biāo)志帶編號(hào)的列表。
- 列表
-
第二項(xiàng)
- 下一層
- 第三項(xiàng)
- 帶編號(hào)的列表
-
第二項(xiàng)
- 用縮進(jìn)表示更深的層
- 完了
* 列表
* 第二項(xiàng)
* 下一層
* 第三項(xiàng)
- 帶編號(hào)的列表
- 第二項(xiàng)
- 用縮進(jìn)表示更深的層
- 完了
同時(shí)可以關(guān)注?列表項(xiàng)目常見(jiàn)問(wèn)題解答.
文本轉(zhuǎn)換
DokuWiki可以將預(yù)定義的字符或者字符串轉(zhuǎn)換成圖片、其他文本或HTML。
文本到圖片的轉(zhuǎn)換，主要用作表情符號(hào)。文本到HTML的轉(zhuǎn)換，多用於顯示符號(hào)替換，但也可以配置為使用其他HTML。
表情符號(hào)
DokuWiki會(huì)將一些常用的?表情符號(hào)?轉(zhuǎn)換為圖像。除了默認(rèn)的表情符號(hào)以外，您也可以在?Smileys?文件夾中放入更多的表情圖，然后在?conf/smileys.conf?中設(shè)置它們即可。下面是Dokuwiki包含了的表情圖像：
印刷樣式
DokuWiki?可以將特定字符轉(zhuǎn)換為印刷時(shí)所用的樣式。下面是可以識(shí)別的這類字符的列表：
→ ← ↔ ? ? ? ? ? – — 640×480 ? ™ ? “He thought 'It's a man's world'…”
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..."
請(qǐng)注意：在配置文件中可以禁用這類自動(dòng)轉(zhuǎn)換。
層次顯示
有時(shí)候（特別是討論時(shí)）您想把某些文字（尤為各次的回復(fù)）標(biāo)示作不同的層次，您可以使用下列的語(yǔ)法：
I think we should do it > No we shouldn't >> Well, I say we should > Really? >> Yes! >>> Then lets do it!
I think we should do it
No we shouldn't
Well, I say we should
Really?
Yes!
Then lets do it!
表格
DokuWiki可以用簡(jiǎn)單的語(yǔ)法創(chuàng)建表格。
| 標(biāo)題 1 | 標(biāo)題 2 | 標(biāo)題 3 |
|---|---|---|
| （1，1） | （1，2） | （1，3） |
| （2，1） | 展寬的單元格 | |
| （3，1） | （3，2） | （3，3） |
表格的每一行都以分隔符?|?（普通行）或者?^?（標(biāo)題行）作為開(kāi)頭和結(jié)束。
^ 標(biāo)題 1 ^ 標(biāo)題 2 ^ 標(biāo)題 3 ^ | （1，1） | （1，2） | （1，3） | | （2，1） | 展寬的單元格 || | （3，1） | （3，2） | （3，3） |
要水平合并單元格，只需要將后一個(gè)單元格設(shè)置為空即可，如上面演示的一樣。請(qǐng)確保每一行有相同數(shù)量的單元格分隔符！
豎直的標(biāo)題列也是可以實(shí)現(xiàn)的：
| 標(biāo)題 1 | 標(biāo)題 2 | |
|---|---|---|
| 標(biāo)題 3 | （1，2） | （1，3） |
| 標(biāo)題 4 | 不再合并單元格 | |
| 標(biāo)題 5 | （2，2） | （2，3） |
可以看到，單元格前面的分隔符決定了單元格的格式。
| ^ 標(biāo)題 1 ^ 標(biāo)題 2 ^ ^ 標(biāo)題 3 | （1，2） | （1，3） | ^ 標(biāo)題 4 | 不再合并單元格 | | ^ 標(biāo)題 5 | （2，2） | （2，3） |
您也可以垂直合并兩格或多格。只要在下面的格內(nèi)輸入:::即可
| 標(biāo)題 1 | 標(biāo)題 2 | 標(biāo)題 3 |
|---|---|---|
| （1，1） | 這次示范垂直合并 | （1，3） |
| （2，1） | （2，3） | |
| （3，1） | （3，3） |
除跨行合并語(yǔ)法:::外，單元格中不能包含其他內(nèi)容。
^ 標(biāo)題 1 ^ 標(biāo)題 2 ^ 標(biāo)題 3 ^ | （1，1） | 這次示范垂直合并 | （1，3） | | （2，1） | ::: | （2，3） | | （3，1） | ::: | （3，3） |
您可以對(duì)齊表格的文字。只需要添加多余兩個(gè)的空格在您需要對(duì)齊的方向的反向即可：如果需要右對(duì)齊，在左邊添加兩個(gè)空格；反之，則在右邊添加。在兩邊均添加空格可以實(shí)現(xiàn)中間對(duì)齊。
| 有對(duì)齊的表格 | ||
|---|---|---|
| 右對(duì)齊 | 居中 | 左對(duì)齊 |
| 左對(duì)齊 | 右對(duì)齊 | 居中 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
下面是源文件中的格式：
^ 有對(duì)齊的表格 ^^^ | 右對(duì)齊| 居中 |左對(duì)齊 | |左對(duì)齊 | 右對(duì)齊| 居中 | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
注意：不支持垂直對(duì)齊
無(wú)格式區(qū)塊
若要略過(guò)某段內(nèi)含 WIKI?語(yǔ)法，不對(duì)該段文字作任何處理， 可以使用 <nowiki> 標(biāo)簽或更簡(jiǎn)單一點(diǎn)用 2 個(gè) %% 放在該段文字的前后，請(qǐng)參考下面例子：
正如本段示范里，本來(lái)包含了網(wǎng)址：http://www.splitbrain.org，以及**加上格式的文字**，但它沒(méi)有給格式化。連表情符號(hào)；-）的轉(zhuǎn)換，也與//__加上格式的文字__//一樣，全都失效了。
使用百分號(hào)對(duì) //__這段__ 文字// 可以達(dá)到同樣的效果 ;-).
<nowiki>正如本段示范里，本來(lái)包含了網(wǎng)址：http://www.splitbrain.org，以及**加上格式的文字**，但它沒(méi)有給格式化。連表情符號(hào)；-）的轉(zhuǎn)換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki> 使用百分號(hào)對(duì) %%//__這段__ 文字// 可以達(dá)到同樣的效果 ;-)%%。
代碼區(qū)塊
在一段文字的最前面加上 2 個(gè)空白，來(lái)直接作為「文本框」不對(duì)它做加工處理(就像前面那些說(shuō)明一樣)。或者也可以用?<code>?或?<file>?這兩個(gè)標(biāo)簽(tag)都可以達(dá)到類似效果。
這段是用 <code> 產(chǎn)生的，所有空格及所有原始格式都會(huì)照樣顯示，還其本色。
就像 <-這個(gè)
這段跟上段很像，但是改用 <file> ，可以把它用在「引述名言(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
這些區(qū)域的源碼如下:
這段是用 <code> 產(chǎn)生的，所有空格及所有原始格式都會(huì)照樣顯示，還其本色。
<code> 就像 <-這個(gè) </code>
<file>
這段跟上段很像，但是改用 <file> ，可以把它用在「引述名言(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>
語(yǔ)法的高亮度顯示
DokuWiki?可把原始碼語(yǔ)法來(lái)做高亮度顯示(Syntax Highlighting)，來(lái)更加具可讀性。 它采用的是 GeSHi Generic Syntax Highlighter —— 所以只要 GeSHi 有支持的，DokuWiki 亦可。
用法就類似前例的?<code>?，但要在標(biāo)簽(tag)內(nèi)指定該原始碼所使用的語(yǔ)言。比如?<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.
}
}
目前支持的語(yǔ)言有:?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>?語(yǔ)法，您或許希望讓瀏覽者直接下載該段代碼。您可以在語(yǔ)言代碼后方指定一個(gè)文件名，方便瀏覽者下載：
<file php myexample.php> <?php echo "hello world!"; ?> </file>
- myexample.php
-
<?php echo "hello world!"; ?>
若您不想把語(yǔ)法高亮顯示出，但想方便瀏覽者下載，您可以用鏈接號(hào)?-?作語(yǔ)言代碼。例如：<code – myfile.foo>。
在內(nèi)容中嵌入HTML或PHP語(yǔ)法
可以在文件里透過(guò)加入?<html>?or?<php>?標(biāo)簽來(lái)使用HTML或PHP，比如：
這是一段用?<font?color="red"?size="+1">HTML 寫的紅色字(size=+1)</font>
<html> 這是一段用 <font color="red" size="+1">HTML 寫的紅色字(size=+1)</font> </html>
22?echo?'由 PHP 所產(chǎn)生 Logo:';?echo?'<img src="'?<span%20class="sy0">.?$_SERVER['PHP_SELF']?.?'?= '?<span%20class="sy0">.php_logo_guid()?.?'" alt="PHP Logo !" />';
<php>
echo '由 PHP 所產(chǎn)生 Logo:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=
' . php_logo_guid() . '"
alt="PHP Logo !" />';
</php>
請(qǐng)?zhí)貏e注意：HTML及PHP語(yǔ)法可以在設(shè)定選項(xiàng)中決定支持與否。若您的DokuWiki設(shè)定不打開(kāi)這兩項(xiàng)功能（可單獨(dú)打開(kāi)兩者之一功能）那么上面的例子就不會(huì)被執(zhí)行，而是直接顯示出來(lái)原始寫法。
RSS/ATOM Feed聚合
DokuWiki能從外部XML feed中聚合數(shù)據(jù)。為分析這些XML feed，DokuWiki使用了SimplePie。凡是SimplePie能理解的格式，都可用於DokuWiki中。您可以更改不同的參數(shù)，以改變其渲染。參數(shù)之間請(qǐng)用空格隔開(kāi)：
| 參數(shù) | 描述 |
|---|---|
| any number | 最多顯示多少項(xiàng)內(nèi)容；預(yù)設(shè)值是8。 |
| reverse | 將最新條目顯示在前面。 |
| author | 顯示條目的作者名字。 |
| date | 顯示條目數(shù)據(jù)。 |
| description | 顯示條目的描述；如果HTML被禁用，所有標(biāo)籤將被過(guò)濾掉 |
| n[dhm] | 刷新周期，其中，d=日數(shù)，h=小時(shí)數(shù)，m=分。例如，12h=12小時(shí)。 |
預(yù)設(shè)的刷新周期是4小時(shí)。小於10分鐘者亦視為10分鐘。DokuWiki通常會(huì)提供頁(yè)面的暫存版，但這做法不適用於包含動(dòng)態(tài)外部?jī)?nèi)容的頁(yè)面。上面的參數(shù)則告訴DokuWiki：若對(duì)上一次渲染時(shí)間已經(jīng)過(guò)了刷新周期，就要重新渲染頁(yè)面。
範(fàn)例:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
- What Fossils Will Modern-Day Civilization Leave Behind??由 BeauHD (2020-01-07 08:00)
- Facebook's First CES Reveal In Years Is a Privacy Tool That Falls Short?由 BeauHD (2020-01-07 04:30)
- YouTube Overhauls Advertising, Data Collection On Kids Content?由 BeauHD (2020-01-07 01:20)
- Self-Sovereign ID Tech Is Being Advanced By Security Failures, Privacy Breaches?由 BeauHD (2020-01-07 00:40)
- The Original Xbox Was Announced 19 Years Ago Today?由 BeauHD (2020-01-07 00:00)
總結(jié)
以上是生活随笔為你收集整理的DokuWiki语法格式说明的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇： 台媒：台积电先进芯片产能满载，三星6nm
- 下一篇： 富士康回应印度建厂取消：未与苹果产生纠纷