摘要：
這份文檔主要給出了一些常用的 TWiki 文章編輯方法。TWiki 是一個(gè)廣泛使用的開(kāi)源 wiki
系統(tǒng)，通常被企業(yè)和組織用戶(hù)用來(lái)共享知識(shí)等。更多介紹請(qǐng)看它的官方站點(diǎn)：http://twiki.org
。
這只是作者的一份編程筆記，其實(shí)與網(wǎng)上早期版本的 TWiki 文檔中文翻譯有些重復(fù)，需要更多內(nèi)容請(qǐng)查看參考文章和鏈接。
目錄
1. 基本語(yǔ)法
1.1 話(huà)題
1.2 標(biāo)題和段落
1.3 字體
1.4 列表
1.4.1 無(wú)序號(hào)列表
1.4.2 帶序號(hào)列表
1.5 表格
1.6 鏈接
1.6.1 詞條鏈接
1.6.2 外部鏈接
1.6.3 頁(yè)面內(nèi)錨點(diǎn)
1.6.4 圖片和附件鏈接
1.7
圖標(biāo)
2. 頁(yè)面編輯技巧
3. 參考文章和鏈接
1. 基本語(yǔ)法
[1.1 話(huà)題]
Wiki 的精神就是用詞條描述世界，所以 TWiki 也是這樣，它內(nèi)部對(duì)內(nèi)容的管理是用一個(gè)一個(gè) WikiWord
來(lái)分類(lèi)的。WikiWord 就是像前面這種兩個(gè)單詞構(gòu)成的連接在一起的詞組，里面大小寫(xiě)交錯(cuò)。
TWiki 的話(huà)題（topic）推薦用 WikiWord 來(lái)建立，如果用戶(hù)輸入的新話(huà)題不是一個(gè)
WikiWord，那么建立新話(huà)題的按鈕就不會(huì)被激活。但是 TWiki 允許用戶(hù)使用非 WikiWord 建立詞條，需要手動(dòng)勾選上允許使用非
WikiWord 建立話(huà)題。
[1.2 標(biāo)題和段落]
1.2.1 標(biāo)題
TWiki 中可以使用分級(jí)標(biāo)題，分級(jí)標(biāo)題的語(yǔ)法如下：
---+
---++
即在行首三個(gè)"-"和一個(gè)"+"代表一級(jí)標(biāo)題，三個(gè)"-"和兩個(gè)"+"代表二級(jí)標(biāo)題，以此類(lèi)推。當(dāng)用戶(hù)使用規(guī)范的標(biāo)題記號(hào)建立好話(huà)題之后，可以很方便地使
用"%TOC%"標(biāo)記建立一個(gè)標(biāo)題目錄。如果用戶(hù)不想某個(gè)標(biāo)題被包含，只需要在標(biāo)記標(biāo)記后加上兩個(gè)感嘆號(hào)"!!"，比如：
---+!! 目錄
%TOC%
這樣目錄這個(gè)標(biāo)題就不會(huì)包含在自動(dòng)建立的目錄里。
1.2.2 段落
TWiki 的段落分隔和 LaTeX 有點(diǎn)兒類(lèi)似，段落之間需要空一行。如果想輸入不被 TWiki
格式化的原始文字（比如源程序等），需要用標(biāo)簽將這些段落包起來(lái)，主要有以下兩種標(biāo)簽：
<verbatim></verbatim>
<pre></pre>
區(qū)別是 <verbatim></verbatim>
中間的代碼以完全原始方式顯示，<pre></pre> 中某些 HTML 標(biāo)簽依然起作用。
[1.3 字體和分隔線]
1.3.1 字體
TWiki 使用字體的方式比較像 HTML 的標(biāo)簽，就是在字符串兩頭加上某些標(biāo)記。比如：
*Bold Font* 粗體
_Italic Font_ 斜體
__Bold Italic__ 粗斜體
=Fixed Font= 等寬字符
==Bold Fixed Font== 等寬粗體字符
最最需要注意的一點(diǎn)是：這些標(biāo)記"*_="必須內(nèi)側(cè)與文字相連，外側(cè)為空格，標(biāo)記之間也不得有空格。
1.3.2 分割線
TWiki 的分割線是在行首輸入連續(xù)的多于三個(gè)的減號(hào)"-"，例如
----
[1.4 列表]
1.4.1 無(wú)序號(hào)列表
無(wú)序號(hào)列表的格式是：
*
*
即三個(gè)空格加"*"所進(jìn)一層，六個(gè)空格加"*"縮進(jìn)第二層，以此類(lèi)推。
1.4.2 帶序號(hào)列表
帶序號(hào)列表的格式是：
1.
1.
即三個(gè)空格加"1"所進(jìn)一層，六個(gè)空格加"1"縮進(jìn)第二層，以此類(lèi)推。注意，這里的"1"代表用阿拉伯?dāng)?shù)字編號(hào)列表，其它編號(hào)方式有"A"或"a"大小寫(xiě)
字母標(biāo)號(hào)，"I"或"i"大小寫(xiě)羅馬字母編號(hào)。
注意:這里后面的小數(shù)點(diǎn)可要可不要，可以一直使用"1"編號(hào)，也可用"1,2,3"遞增編號(hào)，效果無(wú)區(qū)別。
[1.5 表格]
表格的建立是用豎線"|"分隔，比如：
|T1|T2|T3|
|A1|A2|A3|
就建立了一個(gè)兩行三列的列表。單元格內(nèi)部的左右對(duì)齊是利用和豎線的距離實(shí)現(xiàn)的。
[1.6 鏈接]
1.6.1 詞條鏈接
如果是規(guī)范的多詞 WikiWord 話(huà)題，可以使用雙方括號(hào)直接括起來(lái)，例如：[[my wiki topic]]就會(huì)直接引用
MyWikiTopic
詞條；如果是非規(guī)范話(huà)題，或者引用說(shuō)明和引用話(huà)題不一樣，需要使用引用與說(shuō)明分開(kāi)的格式，例如：[[MyWikiTopic][my WIKI
topic]]。
1.6.2 外部鏈接
外部鏈接可以直接使用類(lèi)似與詞條鏈接的方式來(lái)引用，例如：[[
http://blog.solrex.org][Solrex 的博客]] 。
1.6.3 頁(yè)面內(nèi)錨點(diǎn)
在頁(yè)面內(nèi)可以定義錨點(diǎn)，這樣可以使用鏈接在頁(yè)面內(nèi)跳來(lái)跳去。定義錨點(diǎn)的方法是在行首使用 #WikiWord，例如：
#FootNote Footnote is....
就定義了一個(gè)到該段的錨點(diǎn)。引用錨點(diǎn)和詞條鏈接的方式也類(lèi)似，例如：[[#FootNote][to
footnote]]。如果引用別的頁(yè)面的錨點(diǎn)，只需要在錨點(diǎn)前面加上該頁(yè)面的話(huà)題名，例如：[[MyWikiTopic#FootNote][to
another footnote]]。
1.6.4 圖片和附件鏈接
如果引用在同一頁(yè)面的附件或者圖片（其實(shí)一般圖片也是附件），鏈接的格式為：%ATTACHURL%/filename.extesion，比
如：%ATTACHURL%/about.pdf；引用在不同頁(yè)面的鏈接，需要在文件名前面加上該頁(yè)面主題的名字，比如：%PUBURL%/%WEB%
/MyWikiTopic/about.pdf
[1.7 圖標(biāo)]
TWiki 預(yù)定義了很多圖標(biāo)，直接在文中就可以使用，比如幫助的小 i 圖標(biāo)是：%H%，update 的圖標(biāo)是：%U%，new
的圖標(biāo)是：%N%。合理使用這些圖標(biāo)能增強(qiáng)文章的可讀性。
2. 頁(yè)面編輯技巧
[1] 建立話(huà)題時(shí)合理分級(jí)，有規(guī)律地規(guī)劃父話(huà)題和子話(huà)題關(guān)系。
[2] 處理重復(fù)話(huà)題時(shí)使用 %INCLUDE{"XXX"}% 來(lái)包含已有的話(huà)題，比如我已經(jīng)有了 PersonalComputer 話(huà)題，在建立
PC 話(huà)題時(shí)候，就應(yīng)該直接在頁(yè)面中使用 %INCLUDE{"PersonalComputer"}% 來(lái)避免冗余。
[3] 使用%TOC%自動(dòng)創(chuàng)建目錄：當(dāng)編輯一篇比較長(zhǎng)的文章時(shí)，建議使用標(biāo)題標(biāo)記建立分級(jí)標(biāo)題，最后使用 %TOC% 在上方建立一個(gè)可索引目錄。
[4] 合理使用字體和圖標(biāo)增加可讀性。
[5] 合理使用 HTML 代碼來(lái)加強(qiáng)頁(yè)面排版功能。TWiki 可以直接支持 HTML 代碼，為了格式的統(tǒng)一，一般不建議直接使用
HTML。但有些頁(yè)面排版過(guò)于復(fù)雜，使用 HTML 可以直接達(dá)到要求。
[6] 使用注釋的技巧：TWiki 沒(méi)有裝 footnote
插件時(shí)候是不支持注釋鏈接的，但是可以通過(guò)一些技巧來(lái)實(shí)現(xiàn)。我們可以先在注釋或者引用列表前建立一個(gè)錨點(diǎn)：
#FootNote
---+ Footnotes
1 aaa
1 bbb
當(dāng)文中內(nèi)容需要注釋時(shí)，使用 HTML 和 TWiki
鏈接一起加一個(gè)上腳標(biāo)：aaa<sup>[[[#FootNote][1]]]</sup>，這樣 aaa
的右上角就可以出現(xiàn)一個(gè)方括號(hào)，里面是帶到腳注鏈接的腳注編號(hào) "1"。
3. 參考文章和鏈接
[1] 早期版本 TWiki 語(yǔ)法格式的中文翻譯:
http://www.stlchina.org/twiki/bin/view.pl/TWiki/TextFormattingRules
[2] TWiki 官方語(yǔ)法文檔：
http://twiki.org/cgi-bin/view/TWiki/TextFormattingRules