Wiki語法快速參考 for more

----       = 創(chuàng)建水平線.
\\         = 換行, \\\=force line break and clear.
[link]     = 創(chuàng)建一個(gè)鏈接，指向內(nèi)部的wiki頁面'Link'.
[this is also a link] = 創(chuàng)建一個(gè)鏈接，指向內(nèi)部的wiki頁面'ThisIsAlsoALink'.
[click here|link] = 創(chuàng)建一個(gè)鏈接，指向內(nèi)部的wiki頁面'Link', 鏈接文字是'click here'.
[1]        = Makes a reference to a footnote numbered 1.
[#1]       = Marks the footnote number 1.
[[link]    = 不創(chuàng)建鏈接而是輸出文字'[link]'.
!heading   = 小號(hào)標(biāo)題
!!heading  = 中號(hào)標(biāo)題
!!!heading = 大號(hào)標(biāo)題
''text''   = 將text斜體.
__text__   = 將text粗體.
{{text}}   = prints 'text' in monospaced font.
* text     = 無符號(hào)列表
# text     = 有符號(hào)列表
;term:ex   = 名詞定義，用'ex'定義名字'term'

文字相關(guān)語法

在寫wiki頁面時(shí)可以不懂任何wiki語法，只需要像寫信那樣寫自己的wiki頁面，用空行來分割不同的段落，這樣輸出的頁面跟你輸入時(shí)的格式是類似的.

標(biāo)題'!'

!text    = 用于定義小號(hào)標(biāo)題
!!text   = 用于定義中號(hào)標(biāo)題
!!!text  = 用于定義大號(hào)標(biāo)題

除了用于定義頁面輸出樣式，標(biāo)題還有兩個(gè)增值用法

書簽:

所有標(biāo)題都會(huì)自動(dòng)生成一個(gè)頁面書簽, 這樣我們可以在其他頁面定義一個(gè)鏈接到這個(gè)頁面某個(gè)書簽的鏈接. 舉例, 在本頁有下面這樣的標(biāo)題，

!!This is my heading

那么生成的HTML代碼將如下，

This is my heading

在其他頁面可以通過如下文字鏈接到這個(gè)書簽，

[TextFormattingRules#ThisIsMyHeading]
or [Bookmark Text|TextFormattingRules#ThisIsMyHeading]

生成索引和目錄:

Table Of Contents Plugin將會(huì)把標(biāo)題生成對(duì)應(yīng)的索引和目錄

無符號(hào)列表'*'

'*'生成無符號(hào)列表，多個(gè)'*'生成多級(jí)無符號(hào)列表. 舉例:

* One
* Two
* Three
** Three.One

生成列表如下

• One
• Two
• Three
  • Three.One

有符號(hào)列表'#'

類似無符號(hào)列表, 只是使用'#'. 舉例如下:

# One
# Two
# Three
## Three.One

生成列表如下

1. One
2. Two
3. Three
   1. Three.One

名詞定義與注釋';:'

';term:ex'用于名詞定義，名詞construct的定義舉例如下:

;__Construct__:''Something you use to do something with''

將生成如下格式，

Construct

Something you use to do something with

term為空時(shí)用于生成注釋，舉例如下:

;:''Comment here.''

將生成如下格式，

Comment here.

文字效果（粗體和斜體）

__text__      生成粗體文字
''text''      生成斜體文字

預(yù)格式化文本(Preformatted text)

三個(gè)'{'可以起到HTML標(biāo)簽里PRE的作用，這個(gè)功能在輸出程序代碼等文字時(shí)會(huì)非常有用.

在Wiki頁面里添加圖片

Inlined Image

最簡(jiǎn)單的方式是使用Inlined Image，寫法和一般的鏈接寫法類似，舉例: [http://image15.360doc.com/DownloadImg/2010/09/1917/5404160_1.png]可顯示圖片

也可以為圖片指定ALT時(shí)的文字，格式為[this one here|http:///example.png]. 例如[Hello All|http://image15.360doc.com/DownloadImg/2010/09/1917/5404160_1.png]顯示結(jié)果:

圖片可以位于Web上任意可以訪問的位置，也可以是某個(gè)頁面的附件，顯示時(shí)使用不同的鏈接地址就行，譬如完整URL(http:///example.png)或者附件URL(WikiPage/AttachmentName).

Inline Image有一個(gè)局限，就是只支持特定類型的圖片格式，JSPWiki默認(rèn)支持的圖片格式是PNG，我們也可以修改配置文件jspwiki.properties來配置支持的圖片類型，配置格式舉例如下:

jspwiki.translatorReader.inlinePattern.1 = *.jpg
jspwiki.translatorReader.inlinePattern.2 = *.png

當(dāng)前JSPWiki支持的Inline Image的格式可以參考SystemInfo.

Image Plugin

Inline Image使用簡(jiǎn)單，但沒有格式控制，圖片類型也受限制，另一種輸出圖片的方法是使用Plugin機(jī)制，具體用法參考Image Plugin.

創(chuàng)建超級(jí)鏈接

基本應(yīng)用

語法: [Like this] or [Like this|link]

link可以是某個(gè)wiki頁面, 例如[Rain Zhao]或[link sample to page Rain Zhao|RainZhao].

link也可以是一個(gè)完整的URL, 鏈接地址以下面的協(xié)議開頭的將被視為外部鏈接, http:, ftp:, mailto:, https:, or news:. 舉例, 語句 [http://java.], 將顯示 http://java./, 語句 [Java home page|http://java.], 將顯示 Java home page.

頁腳注釋(Footnotes)

超鏈地址使用數(shù)字將創(chuàng)建一個(gè)Footnote, 例如 footnote[1], 將創(chuàng)建footnote[1], 也可以命名一個(gè)footnote, 格式與命名一個(gè)普通超鏈一樣. 例如 [Footnote number 1|1]將生成[Footnote number 1], 這是另一個(gè) footnote[2].

使用 [#1] 定義footnote, 也可以使用[footnote 1|#1]定義footnote, 上文的兩個(gè)footnote定義在本頁最后.

InterWiki

我們還可以定義一個(gè)超鏈鏈接到其他wiki里的某個(gè)頁面. 系統(tǒng)里支持哪些InterWiki是在配置文件里配置的, 配置格式舉例如下:

jspwiki.interWikiRef.JSPWiki = http://www./Wiki.jsp?page=%s
jspwiki.interWikiRef.Edit = Edit.jsp?page=%s
jspwiki.interWikiRef.WikiWikiWeb = http:///cgi/wiki?%s
jspwiki.interWikiRef.Google = http://www.google.com/search?q=%s

應(yīng)用舉例如下:

[TextFormattingRules on JSPWiki.org|JSPWiki:TextFormattingRules]
[Edit:TextFormattingRules]

輸入如下:TextFormattingRules on JSPWiki.org, Edit:TextFormattingRules

InterWiki其實(shí)就是輸出替換, 通過InterWiki機(jī)制我們除了鏈接其他wiki頁面, 還可以實(shí)現(xiàn)一些有趣的功能, 譬如實(shí)現(xiàn)在新窗口里打開鏈接:

首先在jspwiki.properties里加入如下配置：

jspwiki.interWikiRef.newhttp=http:%s" TARGET="_new
jspwiki.interWikiRef.new = Wiki.jsp?page=%s" target="_new

然后我們?cè)趯憌iki頁面時(shí)，就可以選擇是否在新窗口里打開新頁面了，

[Foster Schucker]  -- open this wiki page in this window
[new:Foster Schucker] -- open this wiki page in a new window
[http://www.] -- open this external link in this window
[newhttp://www.]] -- open this external link in a new window

在 SystemInfo 里列出了可用的wiki.

表格相關(guān)語法

使用管道符號(hào)('|')生成表格. 使用雙管道符號(hào)生成表格標(biāo)題. 舉例:

|| Heading 1 || Heading 2
| ''Gobble'' | Bar
| [Main]     | [SandBox]

生成表格如下,

 

Heading 1	Heading 2
Gobble	Bar
Main	SandBox

使用CSS樣式表

我們可以使用CSS樣式來輸出豐富的字體顏色等各種效果，CSS可以是jspwiki.css已經(jīng)定義好的樣式，也可以自己定義的樣式，下面是使用標(biāo)準(zhǔn)樣式定義的示例:

%%small
This is small text
%%

樣式 "small" 必須在文件 jspwiki.css 里定義. 這種用法要求wiki頁面作者清楚管理員提供了哪些CSS樣式, 提供的CSS樣式在各個(gè)站點(diǎn)可能是不同的.

下面是使用自己定義的CSS樣式:

%%( font-size: 150%; color: red; )
Hello, world!
%%

輸出如下:

使用變量

在JSPWiki里，有一些系統(tǒng)定義好的或者用戶自定義的變量，我們可以在自己的Wiki頁面里讀取并顯示這些變量. 基本格式為: [{$variablename}]

除了在頁面里顯示一個(gè)已有變量, 還可以在頁面里使用SET定義頁面變量, 基本格式為: [{SET name=value}]

JSPWiki Variables介紹了關(guān)于變量的詳細(xì)信息, JSPWiki MetaData介紹了SET的詳細(xì)用法.

注意: 變量名是不區(qū)分大小寫的, "paGeNamE" 與 "PageName" 表示相同的變量.

使用Plugin

使用Plugin的基本格式如下:

[{INSERT <plugin class=""></plugin> WHERE param1=value, param2=value, ...}]

JSPWiki Plugins詳細(xì)介紹了Plugin的用法.