狼之樂園協作平台使用一些簡單語法,試著讓資料檔案盡可能的可讀。這個頁面包含所有你可以在編輯頁面時使用的語法。點選在頁面頂端或底端的「編修本頁」按鈕來觀看這一頁的原始檔。如果你想要嘗試,請使用新手試煉場。你也可以使用編輯按鈕取用更簡單的語法。
(譯者註:接下來就讓我們花點時間看一下吧,不一定要全懂,建議挑有興趣的先學,有其他問題或想學多點再來看這也可以。)
或者你可以參考快速編輯指引
DokuWiki 使用空行來區分段落1)。例如:
Paragraphs are created from blank lines. If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
實際顯示的結果為:
Paragraphs are created from blank lines.
If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
如果你想要 強制斷行2) 的話而不是變成另一段落,那麼就在要斷尾處加2個連續的倒斜線 \\ 以及1個空白或位於這行的結尾。
你應該只在真正需要使用強制斷行的地方才用強制斷行。
DokuWiki 支援以下基本語法,並且可以 組合
各種效果。
說明 | 原始寫法 | 輸出效果 |
---|---|---|
粗體 | **粗體** | 粗體 |
斜體 | //斜體// | 斜體 |
底線 | __底線__ | 底線 |
定距字體,或稱「等寬」字體3) | ''定距'' | 定距 |
下標字 | H<sub>2</sub>O | H2O |
上標字 | y = x<sup>2</sup> + 1 | y = x2 + 1 |
刪除線 | <del>刪除線</del> |
DokuWiki 可使用多種型態的連結,以下介紹各式連結用法:
若使用標準 URL Scheme (如 http://www.google.com),或只是 FQDN (如 www.google.com)都會被自動判斷為外部連結。 此外,可以透過設定連結名稱(Linknames) 來設定連結的顯示,比如:這會連到 Google 或者 email也可以用 andi@splitbrain.org 或 andi 來表示。
若使用標準 URL Scheme (如 http://www.google.com), 或只是 FQDN (如 www.google.com)都會被自動判斷為外部連結。 此外,可以透過設定連結名稱(Linknames) 來設定連結的顯示, 比如:[[http://www.google.com|這會連到 Google]] 或者 email也可以用 <andi@splitbrain.org> 或 [[andi@splitbrain.org|andi]] 來表示。
內部連結是用2個中括號包裹要連結的頁面名稱來產生。 可以直接用 pagename 或加上該連結的說明 說明文字。 頁面名稱會被自動轉換成小寫英文字,並且不支援特殊符號。 (中文頁面名稱雖然支援,但在某些部份並不完善,仍建議盡量使用英文頁面名稱 — Reder 2008/06/05 04:58)
內部連結是用2個中括號包裹要連結的頁面名稱來產生。 可以直接用 [[pagename]] 或加上該連結的說明 [[pagename|說明文字]]。 頁面名稱會被自動轉換成小寫英文字,並且不支援特殊符號。 (中文頁面名稱雖然支援,但在某些部份並不完善,仍建議盡量使用英文頁面名稱)
也可以加上冒號「:」(colon)用來做 namespaces 的區分而互相連結。
也可以加上冒號「:」(colon)用來做 [[namespaces]] 的區分而互相連結。
提到「namespaces」,它可用來對整體 Wiki 頁面架構作更好的規劃。 每一個 namespace 本身就是「目錄」,因此若某頁名稱為「wact:tags:list」, 那麼就會對應為「wact/tags/list.txt」的結構,也就是 wact目錄 → tags目錄 → list.txt, 所以拿這招來規劃 WIKI 結構是相當好用的。如果在某個 namespace 之下的頁面,創立內部連結,[[pagename]], 此頁面也會擁有相同的 namespace。 若想更深入瞭解,那麼請看 namespaces。
若要連到某頁的某章節段落,也可以。 就像 HTML 的 bookmark 一樣,只要在該頁後面加上 #某章節 就可以囉。 比如
這會連到 這一節(internal)。
這會連到 [[syntax#internal|這一節(internal)]]。
請注意:
DokuWiki 可用 interwiki 來快速連到其他 Wikis。
比如:這會連到 Wikipedia(維基百科)的 Wiki 頁Wiki。
此外還可運用:
新增語法 | 出現的結果 | 說明 |
---|---|---|
[[wf>Wolf]] | Wolf | 連到 WikiFur(外國獸迷百科)找有關 Wolf 的解釋 |
[[wfzh>狼]] | 狼 | 連到 WikiFur(獸迷百科中文版)找有關 狼 的解釋 |
[[wp>狼]] | 狼 | 連到 WikiPedia(世界最大百科中文版)找有關 狼 的解釋 |
[[wpen>Wolf]] | Wolf | 連到 WikiPedia(世界最大百科英文版)找有關 Wolf 的解釋 |
[[wbt>9858]] | 9858 | 連到狼之樂園的會員管理通則, 主題編號為9858 |
[[wbu>2]] | 2 | 連到狼之樂園的狼王白牙會員資料, 會員編號為2 |
[[wbf>1]] | 2 | 連到狼之樂園的圖片分享 - 原創, 版面編號為1 |
原始寫法 | 出現的結果 | 說明 |
---|---|---|
[[google>Wiki]] | Wiki | 請 Google 搜尋大神幫您找有關 Wiki 的網頁 |
[[wp>Wiki]] | Wiki | 連到 Wikipedia(維基百科)的 Wiki 頁 |
[[Meatball>MeatballWiki]] | MeatballWiki | 連到 MeatBall Wiki 的 MeatballWiki 頁 |
[[phpfn>phpinfo]] | phpinfo | 到 php 官網看 phpinfo function 的手冊說明 |
[[JspWiki>System.out.println]] | System.out.println | 從 JSP Wiki 找 System.out.println 說明 |
[[FreeBSDman>uname]] | uname | 到 FreeBSD 官網找 uname 的線上說明 |
[[man>passwd]] | passwd | 到 Linux Qustion 查 passwd 的用法 |
[[rfc>2010]] | 2010 | 找 RFC #2010 文件 |
[[amazon>Bible]] | Bible | 到亞馬遜書局找有關聖經(Bible)的書 |
[[dict>apple]] | apple | 從雅虎奇摩字典查 apple 單字 |
[[imdb>Titanic]] | Titanic | 從 IMDB4)電影資料庫尋找有關 鐵達尼(Titanic) 的資料 |
[[GoogleGroups>FireBird BBS]] | FireBird BBS | 用Google Newsgroup內找 FireBird BBS 文章(tw.bbs.*轉信文章亦可) |
[[bug>4]] | 4 | 察看 DOKUWIKI 編號 4 的 bug 回報 |
備註:此外,還有多種變化,請自行參見下列有關 conf/interwiki.conf
的說明。
InterWiki 可透過 conf/interwiki.conf
檔來設定。DokuWiki內建包含了 http://usemod.com/intermap.txt 所列的每項 InterWiki,格式如下
捷徑名稱{NAME} | 網址{URL} |
---|---|
wp | http://en.wikipedia.org/wiki/ |
wpde | http://de.wikipedia.org/wiki/ |
若不想用預設的圖示,那麼可在 interwiki
目錄內放跟捷徑名稱相同的圖檔。比如捷徑名稱為「wp」,那麼圖檔名稱應為「wp.gif」或「wp.png」才行。
而這些圖檔必須是 16×16 像素(pixels) 的 PNG 或 GIF 格式。
MS Windows 主機使用 SMB5)協定,或稱為 CIFS6)的協定,可讓 MS Windows 主機可以將另一 MS Windows 主機目錄檔案當成是本機上的目錄檔案一般地使用,即所謂的網路芳鄰分享。而這個協定亦可以用於 Internet ,即位於不同網段的 Windows 主機也可使用此協定進行目錄檔案的分享(假如傳送過程中未有其他的網路設備阻擋時)。而其他 OS 像是 FreeBSD, Linux 也有相關 Samba 軟體來使用這項功能。
網芳資源可用 這樣子 來進行連結。另外可參考Intranet。
網芳資源可用 [[\\server\share|這樣子]] 來進行連結。
千萬要注意:
也可透過使用圖片來連到wiki內部的頁面,或者其他的 URL ,比如:
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
請記得: 在 [[URL|連結名稱]] 的「連結名稱」處若用 {{}} 的話,只能用圖檔檔名喔。
您可以任意增加註解 7) ,怎麼用呢? 把要註解的文字用 2 個括號類似包水餃一樣包起來就好囉。 而註解的編號管理,請別擔心,DokuWiki 會自動幫您弄好。
您可以任意增加註解 ((這是示範註解)) ,怎麼用呢? 把要註解的文字用 2 個括號類似包水餃一樣包起來就好囉。
一個層次分明的內容,加上有條不絮的說明文字,似乎總是最能令人消化吸收的。
我們可以透過設定最多至五種不同層次的標題,來完成目錄表的自動建構。 若該頁內有至少三個層次的標題,那麼 DOKUWIKI 就會自動產生相對應的目錄表(TOC)。 不過若不想要「目錄表」的話,那麼只要在文章開頭打入~~NOTOC~~即可。
標題是在左右各以等號 = 標示, 從 == 到 ====== 每多1個 = 則分別代表更高層次的標題
====== 有六個 = 則為「標題層次第1級」, 而本節目前是 ===== Sectioning 目錄的節次結構 ===== 也就是「標題層次第2級」
==== 標題層次第 3 級 ==== === 標題層次第 4 級 === == 標題層次第 5 級 ==
而連續四個短折號「-」(dash)所組成的 ---- 即可產生水平線。 舉例: ↓
可以用2個重疊的 {{}} 括號(curly brackets)來貼圖或檔案,詳情請見 images。 也可以在編輯時用工具列的按鈕來完成。
此外,還可指定圖檔的顯示大小。
實際大小: {{wiki:dokuwiki-128.png}} 縮放為自訂的寬度(50 pixel): {{wiki:dokuwiki-128.png?50}} 縮放為自訂的大小(200x50): {{wiki:dokuwiki-128.png?200x50}} 縮放以URL連結的影像(100x100): {{http://de3.php.net/images/php.gif?100x100}}
也可運用 {{圖檔檔名}} 在括號與檔名之間插入空白的變化,來指定要放左、右或中間。
當然還可在圖片上加上「說明文字(title)」(在多數的瀏覽器上,滑鼠移到該圖上則會顯示)。
{{ wiki:dokuwiki-128.png |這是該圖的說明}}
若您所指定的檔案(無論是內部連結或外部URL)並不是圖檔(gif,jpeg,png這三種圖檔類型
),那麼「這是該圖的說明」那段文字會被顯示出來而當作連結,效果等同 HTML 中的 <img alt=“這是該圖的說明” >。
DokuWiki 可使用項目表有兩種型態:數字及符號表。
要建立項目表的話,在該行前面先空出兩格,然後加上 *
即可產生符號項目表,
或者改用 -
的話則會產生數字項目表。
-
或 *
前面多加空白,就會內縮為更深(細微)的層次了。* 這是項目表 * 然而 * 也可以用不同層次的項目表來表達 * 其他 - 這也一樣是項目表,不過前面會加上編號 - 第二項 - 只要在 ''-'' 或 ''*'' 前面多加空白,就會內縮為更深(細微)的層次了。 - 第三項 - 空行,則會結束列表,重新起算編號。
DokuWiki 支援 emoticon 普遍常用的表情符號。表情符號圖檔都被放在 smiley
目錄內,
並且可以用 conf 目錄下的 smileys.conf
檔案來做更多的設定,
以下是目前 DokuWiki 所內建的表情符號表。
原始寫法 | 表情符號 |
---|---|
8-) | |
8-O | |
:-( | |
:-) | |
=) | |
:-/ | |
:-\ | |
:-? | |
:-D | |
:-P | |
:-O | |
:-X | |
:-| | |
;-) | |
:?: | |
:!: | |
LOL | |
FIXME | |
DELETEME |
^_^
原始寫法 | 輸出的印刷符號(或結果) |
---|---|
-> | → |
<- | ← |
<-> | ↔ |
=> | ⇒ |
<= | ⇐ |
<=> | ⇔ |
>> | » |
<< | « |
-- | – |
--- | — |
640x480 | 640×480 |
(c) | © |
(tm) | ™ |
(r) | ® |
"He thought 'It's a man's world'..." | “He thought 'It's a man's world'…“ |
注意: 若您不想要這項功能的話,可以在 dokuwiki.php 檔中設定關閉。
有時候你想要將某些文字標為引述,你可以使用下列的語法:
我想我們應該這麼做 > 不,我們不該。 >> 嗯,我想我們應該。 > 真的嗎? >> 當然! >>> 那就做吧!
我想我們應該這麼做
不,我們不該。
嗯,我想我們應該。
真的嗎?
當然!
那就做吧!
DokuWiki 建立表格的方式很簡單:
標題一 | 標題二 | 標題三 |
---|---|---|
第1行,第1列 | 第1行,第2列 | 第1行,第3列 |
第2行,第1列 | 合併兩欄(注意後面有兩個 | 豎號喔) | |
第3行,第1列 | 第3行,第2列 | 第3行,第3列 |
以 |
開始與結束的是「普通欄位」,而 ^
則是「標題欄」(通常 CSS 預設為藍底粗黑字),
同時也以 |
或 ^
分欄。
當然,只要您高興,也可以全部「只用 ^ 」都是標題或「只用 | 」都沒標題。
^ 標題一 ^ 標題二 ^ 標題三 ^ | 第1行,第1列 | 第1行,第2列 | 第1行,第3列 | | 第2行,第1列 | 合併兩欄(注意後面有兩個 | 豎號喔) || | 第3行,第1列 | 第3行,第2列 | 第3行,第3列 |
上面「合併兩欄(注意後面有兩個 | 豎號喔)」,
只須將欲合併的欄位直接接上 | 或 ^ 即可合併多欄位。
但要注意的是每行的欄位數(不管是哪一種分隔線)都要一致。
而標題也可以「垂直」欄位來表示。
標題一 | 標題二 | |
---|---|---|
標題三 | 第1行,第2列 | 第1行,第3列 |
標題四 | 這次不使用合併 | |
標題五 | 第3行,第2列 | 第3行,第3列 |
上面例子所看到的,就是直接在「標題三、四、五」前面加上 ^ 即可。
| ^ 標題一 ^ 標題二 ^ ^ 標題三 | 第1行,第2列 | 第1行,第3列 | ^ 標題四 | 這次不使用合併 | | ^ 標題五 | 第3行,第2列 | 第3行,第3列 |
請注意: 垂直方向的欄位(rowspan)並無法合併,但可斷行。 若有需要,可改用最後面介紹的 HTML 方式來使用。
You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.
Table with alignment | ||
---|---|---|
right | center | left |
left | right | center |
xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
This is how it looks in the source:
^ Table with alignment ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
在一段文字的最前面加上 2 個空白,來直接作為「文字方塊」不對它做加工處理(就像前面那些說明一樣)。或者也可以用 <code>
或 <file>
這兩個標籤(tag)都可以達到類似效果。
這段是用 <code> 產生的,所有空格及所有原始格式都會照樣顯示,還其本色。 就像 <-這個 或者 方與圓 似剛與柔 圓契合於方 方契合於圓 兩心同一點
這段跟上段很像,但是改用 <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
若要略過某段內含 WIKI 語法,不對該段文字作任何處理,
可以使用 <nowiki>
標籤或更簡單一點用 2 個 %%
放在該段文字的前後,請參考下面例子:
<nowiki>
這段字不要用 [[WIKI]] 語法</nowiki>
或是%%
這段字不要用 [[WIKI]] 語法%%
這一段包含一些原本會在 WIKI 內有特殊處理,像是 http://www.splitbrain.org 及 **強調語氣的文字** ,但是正如所看到的,這裡什麼都不做任何處理。
您可以看本頁的原始寫法來察看這一段是怎麼寫的。
DokuWiki 可把原始碼語法來做高亮度顯示(Syntax Highlighting),來更加具可讀性。 它採用的是 GeSHi Generic Syntax Highlighter —— 所以只要 GeSHi 有支援的,DokuWiki 亦可。
用法就類似前例的 <code> ,但要在標籤(tag)內指定該原始碼所使用的語言。比如 <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. } }
目前支援的語言有: 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