用戶工具

網站工具


zh-tw:wiki使用帮助:wiki语法

格式化語法

DokuWiki 支援一些簡單的標記語言,以盡可能使文檔的可讀性更高。本頁包含了您在編輯頁面時可能用到所有語法的說明。如果需要查看本頁源碼,只需要點擊頁面頂部或者底部的按鈕。如果您想做一些嘗試,那麼可以使用詞條編輯練習 來盡情揮灑。通過快捷按鈕 ,您可以更方便地使用下面部分語法標記。如果你想更完美的排版您的資料請務必掌握以下標記的使用。

為了讓大家能夠更快的上手,本wiki為大家提供了比較常見的 bbcode語法代碼

基本文字格式

DokuWiki支持,,以及等寬體 等格式。當然,您可以混合使用 這些格式。

DokuWiki支持**粗體**,//斜體//,__底線__以及''等寬體''等格式。
當然,您可以**__//''混合使用''//__**這些格式。

您也可以使用下標上標

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

同時也可以使用刪除線 標記某些資訊。

同時也可以使用<del>刪除線</del> 標記某些資訊。

您可以使用兩個連續的“反斜線”接“空格”來自行表示分行符號。 或用“空行”作為段落標記。

請看樣例
這是一些有著換行標記的文字。
請注意雙反斜線只在回車符之前
或者接在
一個空格之前的時候才有效。\\而這樣就並不起作用。

這裡是下一個段落。

這是一些有著換行標記的文字。\\ 請注意
雙反斜線只在回車符之前\\
或者接在\\ 一個空格之前的時候才有效。\\而這樣就並不起作用。

這裡是下一個段落。

請僅在必須的時候使用強制換行標記。

連結

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]]。
類似這樣的電子郵寄地址:也可以被識別。

內部連結

內部連結可以用方括號創建。您可以只給出頁面名 ,或附加連結文本

內部連結可以用方括號創建。您可以只給出
[[頁面名]],或附加[[頁面名|連結文本]]。

Wiki的頁面名 會被自動地轉換為小寫字母,並且不允許使用特殊字元。

您可以通過在頁面名中添加冒號的方式來使用命名空間

您可以通過在頁面名中添加冒號的方式來使用[[某目錄:命名空間]]。

如果您需要更多有關“命名空間(namespaces)”的詳細資訊,請參見namespaceshttp://vocawiki.net/wiki%E4%BD%BF%E7%94%A8%E5%B8%AE%E5%8A%A9:%E5%88%9D%E5%AD%A6%E8%80%85%E6%95%99%E7%A8%8B#命名空間與頁面

連結到一個特定章節也是可能的。只需要在#號後面加上章節的名稱。這是一個指向本節的連結。

這是一個指向[[wiki使用幫助:wiki語法#內部連結|本節]]的連結。

注意:

  • 指向已存在頁面 的和不存在頁面 的連結,其外觀是不同的。
  • 預設情況下,DokuWiki不使用CamelCase 來自動建立連結。提示:如果DokuWiki顯示為連結,則說明已啟動。
  • 當一節的標題改變時,它的書簽也會改變。因此,請不要過於依賴章節連結。

Wiki間連結

DokuWiki支持Interwiki (Wiki間連結)。他們是到其他Wiki的快速連結。例如,這是一個指向Wikipedia上Wiki條目的連結:Wiki

DokuWiki支援[[doku>Interwiki]](Wiki間連結)。他們是到其他Wiki的快速連結。
例如,這是一個指向Wikipedia上Wiki條目的連結:[[wp>Wiki]]。

Windows共用資料夾

Windows共用資料夾,例如這個 也可以被識別。請注意,這只在企業內部網 等局域網環境中才有意義。

Windows共用資料夾,例如[[\\server\share|這個]]也可以被識別。

注:

  • 出於安全原因,只有在微軟IE流覽器上才能夠直接訪問Windows共用資料夾(並且僅在“本地區域”)。
  • 對於Mozilla和Firefox可以通過Mozilla知識庫 中提到的不同解決方法啟用。

圖像連結

您也可以通過結合連結和圖像 (見下文)的語法,用圖像來連結到一個內部或者外部的頁面。如下所示:

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

請注意:圖像的格式化語法是連結文本唯一接受的格式化語法。

所有的圖像和連結語法都是支援的(包括圖像大小調整、內部和外部的圖像與連結以及wiki內連結)。

註腳

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

您可以使用兩個連續小括弧來添加註腳((這是一個註腳))。

分節

您可以使用多達5層的標題來組織您的內容。如果您使用了三個以上的標題,將自動生成目錄——這可以通過在頁面加入 字樣來禁用。

多個等級的標題

這裡將使用wiki語法中“分節”章節的語法。

  • 標題分H1 - H5 五個等級的標題

練習創建全部5個等級的標題

  • 插入文本加上語法標籤並保存
  • ====== H1標題 ======
    ===== H2標題 =====
    ==== H3標題 ====
    === H4標題 ===
    == H5標題 ==
點擊預覽可以看到如下效果

水準分割線

您可以通過4個以上連續的“-”號來創建一條水準分割線:



----

圖像和其它檔

您可以用兩個大括弧在頁面中加入外部或內部的圖像 。您還可以指定它們的大小。

原始大小:

指定寬度:

指定寬度和高度2))

重新指定寬度和高度的外部圖像:

原始大小:                        {{wiki:dokuwiki-128.png}}
指定寬度:                        {{wiki:dokuwiki-128.png?50}}
指定寬度和高度((當指定的長寬比與圖像的不一致,在調整圖像大小前,其將先被裁剪到新的比例)):                  {{wiki:dokuwiki-128.png?200*50}}
重新指定寬度和高度的外部圖像:    {{http://de3.php.net/images/php.gif?200x50}}

通過使用左空格或右空格,您可以選擇對齊方式。

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

當然,您也可以指定一個標題(多數流覽器顯示為提示文本3)))。

{{ wiki:dokuwiki-128.png |這是標題}}

如果您指定的檔案名(無論是外部的還是內部的)不是一個圖像(gif,jpeg,png ),那麼它將被顯示為一個連結。

對於將圖像連結到其他頁面,參見上面的圖像連結

列表

DokuWiki支持帶編號或不帶編號的列表。要創建清單,在文字前加入兩個空格,然後使用* 標記不帶編號的清單,用- 標記帶編號的清單。

  • 這是一個列表
  • 第二項
    • 您可以有不同的層次
  • 另一項
  1. 帶編號的列表
  2. 另一項
    1. 用縮進表示更深的層
  3. 就這樣
  * 這是一個列表
  * 第二項
    * 您可以有不同的層次
  * 另一項

  - 帶編號的列表
  - 另一項
    - 用縮進表示更深的層
  - 就這樣

文本轉換

DokuWiki可以將預定義的字元或者字串轉換成圖像、其他文本或HTML。

文本轉換為圖像主要用於表情符號。文本到HTML的轉換用於排版的字元替換,但也可以配置為使用其他HTML。

文本到圖像的轉換

DokuWiki會將一些常用的 表情符號 轉換為相應圖像。這些表情符號 和其他圖像可以被配置和擴展。這是DokuWiki中包含的表情符號的概況:

  • 8-) undefined 8-) undefined
  • 8-O undefined 8-O undefined
  • :-( undefined :-( undefined
  • :-) undefined :-) undefined
  • =) undefined =) undefined
  • :-/ undefined :-/
  • false :-\
  • :-? undefined :-? undefined
  • :-D undefined :-D undefined
  • :-P undefined :-P undefined
  • :-O undefined :-O undefined
  • :-X undefined :-X undefined
  • :-| undefined :-| undefined
  • ;-) undefined ;-) undefined
  • ^_^ undefined ^_^
  • :?: undefined :?: undefined
  • :!: undefined :!: undefined
  • LOL undefined LOL undefined
  • FIXME undefined FIXME undefined
  • DELETEME undefined DELETEME undefined

文本到HTML的轉換

印刷: 可以將特定字元轉換為印刷時所用的樣式。這是可識別的字元示例。

→ ← <→ ⇐ < » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”

-> <- <-> => <= <=>>> <<-- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

同樣的做法可以產生任何類型的HTML,只需要添加到模式檔

這裡有三個例外,它們並非來自模式檔:乘法(640×480)、'單引號'和”雙引號”。它們可以通過選項關閉。

引用

有時您想將某些文本標記為回復或者評論。您可以使用下列語法:

我想我們應該做這件事

> 不,我們不應該

>> 好吧,我說我們應該

> 真的?

>> 是!

>>> 那來做吧!

我想我們應該做這件事

不,我們不應該

好吧,我說我們應該

真的?

是!
那來做吧!

表格

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)          |

跨行合併儲存格(垂直合併儲存格)也是可以實現的,通過在下面的相鄰儲存格輸入::: 可以把兩個相鄰行的儲存格合併。

標題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 |

注意:不支持垂直對齊。

無格式化

如果您需要文本完全顯示為它鍵入的樣子(沒有任何格式化),用<nowiki> 標籤包圍這個區域,或更簡單地用兩個百分號%%

這是一些包含這樣的位址:http://www.splitbrain.org,以及**格式**的文字,但它沒有被解析。 對於帶有表情符號的</nowiki>;-) 的undefined 文本也一樣。 <code> <nowiki> 這是一些包含這樣的位址:http://www.splitbrain.org,以及**格式**的文字,但它沒有被解析。 // 對於帶有表情符號的//;-)的//__這段__文本////也一樣。 </code> ===== 代碼塊 ===== 您可以將代碼塊包含到文檔中,可以通過縮進兩個空格(像前面例子中所用的)或者使用標籤''

<nowiki>''或''</nowiki><file><nowiki>''。

  這是縮進了兩個空格的文本。

<code>
這是預格式化的代碼,所有空格都被保留:像              <-這樣
這非常相似,但您可以用它來表明您引用了一個檔。

這些區塊由下面的源碼創建:

  這是縮進了兩個空格的文本。
<code>
這是預格式化的代碼,所有空格都被保留:像              <-這樣
</code>
<file>
這非常相似,但您可以用它來表明您引用了一個檔。
</file>

語法高亮

DokuWiki 可以高亮原始程式碼,使它更容易閱讀。它使用GeSHi通用語法高亮器——因此支持任何GeSHi所支援的語言。語法和前面章節中代碼與檔塊的一樣,但這時所用語言的名稱被放入標籤中。例如<code java>或者<file 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.
    }
}

當前可以識別下列語言字串:4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, gdb, glsl, gml, gnuplot, groovy, gettext, haskell, hq9plus, html, idl, ini, inno, intercal, io, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, mapbasic, matlab, mirc, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, pascal, perl, perl6, per, php-brief, php, pike, pic16, pixelbender, plsql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, qbasic, rails, rebol, reg, robots, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xml, xorg_conf, xpp, z80

可下載的代碼塊 ====

當您使用上面的</nowiki>''或''

<nowiki>''語法,您或許希望讓顯示的代碼也可以被下載。您可以通過在語言代碼後面指定一個檔案名來實現: <code> <file php myexample.php> <?php echo __GESHI_QUOT__hello world!__GESHI_QUOT__; ?> 

</code>

myexample.php
 <?php echo __GESHI_QUOT__hello world!__GESHI_QUOT__; ?> 

如果您不想要任何高亮,但想要一個可下載的檔,指定破折號(-)作為語言代碼:</nowiki><code - myfile.foo>''。 ===== 嵌入HTML和PHP ===== 您可以嵌入原始HTML或PHP代碼到檔中,通過使用''<html>''或''<php>%% 標籤。(如果您需要包圍區塊級別的元素,使用大寫字母的標籤。) ''

HTML例子:

 <html> 這是一些<span style=__GESHI_QUOT__color:red;font-size:150%;__GESHI_QUOT__ >行內HTML</span> </html> <HTML> <p style=__GESHI_QUOT__border:2px dashed red;__GESHI_QUOT__ >這是一些區塊HTML</p> </HTML>


<html> 這是一些<span style="color:red;font-size:150%;">行內HTML</span> </html> <HTML> <p style="border:2px dashed red;">這是一些區塊HTML</p> </HTML>


PHP例子:


<code>
<php>
echo 'PHP生成的標誌:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP標誌!" />';
echo '(生成行內HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>同樣,不過是區塊級別的元素:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP標誌!" /></td>';
echo '</tr></table>';
</PHP>

echo 'PHP生成的標誌:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP標誌!" />'; echo '(生成行內HTML)';

 echo '<table class="inline"><tr><td>同樣,不過是區塊級別的元素:</td>'; echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP標誌!" /></td>'; echo '</tr></table>'; 

:HTML和PHP嵌入預設在配置中被禁用。如果禁用,代碼被顯示出來而不是執行。

RSS/ATOM Feed聚合

DokuWiki 能夠從外部的XML feed中聚合資料。為了解析這些XML feed,使用了SimplePie 。所有的能夠被SimplePie理解的格式都可以在DokuWiki中使用。您可以通過多個參數來改變渲染,參數之間用空格隔開:

參數 描述
any number 最多顯示多少內容項;默認是8
reverse 將最新條目顯示在前面
author 顯示條目的作者名
date 顯示條目資料
description 顯示條目的描述;如果HTML 被禁用,所有的標籤將被過濾掉
n [dhm] 刷新週期,其中,d=天數,h=小時數,m=分。例如,12h=12個小時。

刷新週期默認是4小時。小於或者等於10分鐘均視為10分鐘。DokuWiki 通常會提供頁面的緩存版,顯然,這種做法不適用於包含動態外部內容的頁面。上面的參數告訴DokuWiki ,如果離上次重新解釋的時間已經超出了,則重新解釋頁面。

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

Experimental Virtual Graphics Port Support For Linux 由 Unknown Lamer (2011/11/08 13:09)

Vulnerabilities Discovered In Prison SCADA Systems 由 Unknown Lamer (2011/11/08 11:01)

World Emissions of Carbon Dioxide Outpace Worst-Case Scenario 由 Unknown Lamer (2011/11/08 09:00)

Could Crowd-Sourced Direct Democracy Work? 由 Unknown Lamer (2011/11/08 08:13)

Strange Places To Find Open Source 由 Soulskill (2011/11/08 07:29)

控制宏

一些語法會影響DokuWiki對頁面的解釋,而自身不輸出任何內容。可用的控制宏如下:

描述
如果頁面出現該控制巨集,將不會創建目錄
~~NOCACHE~~ DokuWiki默認會緩存所有的輸出。有時並不希望這樣(例如,當使用了上面的<php>語法),增加這個控制巨集將強制DokuWiki在每次訪問時重新解析頁面

翻譯者

vocawiki所支援的更多語法

vocawiki通過外掛程式擴展為大家提供了更多額外的語法支援。

插入視頻網站的flash

插入各大視頻的視頻須使用如下代碼

[flash:]
":"後面插入視頻網站的外鏈位址 也就是↓
[flash:視頻網站給出的位址]

下麵用烏鴉製作的RIN版BRS的sina視頻來做外鏈示例
插入如下代碼即可

[flash:http://you.video.sina.com.cn/api/sinawebApi/outplayrefer.php/vid=16571283_1210722020/s.swf]

插入音訊檔

插入有詳細物理連接的音訊檔請使用如下代碼

[mp3link:]
":"後面插入視頻網站的外鏈位址 也就是↓
[mp3link:音訊的地址]

下麵用sakura與利夫製作的only my railgun的mp3示例
插入如下代碼即可

[mp3link:http://e-avalanche.com/player/media/only my railgun(mix2 by li).mp3]

如果是WMA格式 請使用如下方式:

[wmp:]
":"後面插入視頻網站的外鏈位址 也就是↓
[wmp:音訊的地址]

bbcode代碼

這應該是大家最熟悉的bbcode代碼 bbcode代碼常見於各大論壇系統!例如ivocaloid論壇所用的Discuz!代碼j就是基於bbcode代碼演變而成的。
下面的例子將向你展示本WIKI系統所支援的bbcode代碼代碼,你會發現他和ivocaloid論壇所用的Discuz!代碼非常相似,也就是說ivocaloid論壇的大部分帖子僅需要稍加修改即可發佈在本網站。

[b]粗體文字 Abc[/b] 
[i]斜體文字 Abc[/i] 
[u]底線文字 Abc[/u] 
[color=red]紅顏色[/color] 
[size=3]文字大小為 3[/size]
[url]http://vocawiki.net[/url]
[url=http://vocawiki.net]Vocawiki[/url]
[email]myimagination@aol.tw[/email]
[email=myimagination@aol.tw]郵箱[/email]
[code]原始代碼[/code]
[list][*]列表項 #1[*]列表項 #2[*]列表項 #3[/list]
[img]http://vocawiki.net/_media/wiki:dokuwiki-128.png[/img]
[img=88,31]http://vocawiki.net/_media/wiki:dokuwiki-128.png[/img]

粗體文字 Abc
斜體文字 Abc
底線文字 Abc
紅顏色
文字大小為 3
http://vocawiki.net
Vocawiki
myimagination@aol.tw
郵箱

原始代碼


  • 列表項 #1
  • 列表項 #2
  • 列表項 #3


http://vocawiki.net/_media/wiki:dokuwiki-128.png

wrap與其他擴展語法

普通編輯器模式下的快捷按鈕後幾排的wrapnote、tip均為額外添加的語法格式,這些按鈕可以快幫你插入語法(可以自訂),通過使用這些語法格式你可以添加更醒目的標誌來強調顯示特定內容。

這裡推薦大家使用wrap格式化語法 因為你可以通過下面的例子發現他的可塑性更高!
更多的語法格式請大家流覽wrap格式化語法官方說明 例如:

<note tip>tip</note>
<WRAP center round important 60%>
「重要」方盒
</WRAP>
<WRAP center round important 60%>
「重要」方盒
</WRAP>
<WRAP center round important 60%>
「重要」方盒
</WRAP>
<wrap important>
「重要」方盒
</wrap>

tip

「重要」方盒

「重要」方盒

「重要」方盒


「重要」方盒

1) 1
2) 2
3) 3
zh-tw/wiki使用帮助/wiki语法.txt · 上一次變更: 2012/06/06 14:25 由 admin