當你知道了Wiki的文本編輯器是如何工作的時候,你此時最好去閱讀[WikiEtiquette],這樣你才能夠掌握最新的Wiki語法...
[{TableOfContents}]
!!快速參考
{{{
---- = 水平線。多餘的'-'將被忽略。
// = 強制換行。
[link] = 創建連至內部名爲 'link' 的 WikiPage 的超鏈。
[also a link] = 創建連至內部名爲'AlsoALink'頁面但顯示依然如輸入那樣帶空格的超鏈。
[例|link] = 創建創建連至內部名爲'Link'頁面但顯示爲文本'例'的超鏈。
[1] = 創建腳註號爲1的腳註參考。
[#1] = 設置腳註1。
[[link] = 創建文本'[link]'。
!heading = 小號標題文本 'heading'。
!!heading = 中號標題文本 'heading'。
!!!heading = 大號標題文本 'heading'。
''text'' = 以斜體顯示 'text'。
__text__ = 以粗體顯示 'text'。
{{text}} = 以等寬字體顯示 'text'。
* text = 以文本 'text' 創建普通列表。
# text = 以文本 'text' 創建數字列表。
;term:ex = 以'def'中的文字說明'term'項。
}}}
!!文本編輯
你無需知道任何Wiki的語法規則,像寫郵件一樣用普通的文本然後再用一個空行來作爲段落的標記就行了。
任何時候你都可以對頁面進行編輯(看左邊的工具欄),再看看使用中的頁面發生了什麼變化。
!加入圖片
你可以插入任何圖片到Wiki裏面並加入鏈接,在Wiki頁面允許的情況下。
例如,這是一個包含了[PNG]的圖片: [http://www.ecyrd.com/~jalkanen/test.png].
如果你制定了一個鏈接的文本([[this one here|http://example.com/example.png]) ,那麼這個鏈接的文本就會顯示在圖片沒有被顯示出來的圖片框裏面。
你也可以加上一個圖片, 並把它指向其他的頁面. 看看 [WikiAttachments] 來獲得更多的幫助吧.
如果你想更多的控制頁面佈局,可以使用[Image]插件。它可以實現更多的功能。
Wiki決定着哪些圖片是可以支持的. 查看 [SystemInfo] 可以看到一組不同類別的圖片類型。
!標題
JSPWiki有3種類型的標題://
小標題 用一個感嘆號'!'//
中等標題 用二個感嘆號'!!'//
大標題 用三個感嘆號'!!!'//
標題會產生一個"命名標記", 你可以從其他頁面指到這個頁面的標題上。查看 [Named Headings] 獲得更多的幫助.
!列表
在一行的開頭使用星號(*) 來生成列表.多個星號可以生成多級列表,例子如下:
{{{
* 水果
* MP3
* 電腦
** 聯想電腦
}}}
效果如
* 水果
* MP3
* 電腦
** 聯想電腦
!數字標題
與列表類似,只是使用了(#) 而不是星號. 如下:
{{{
# 一 標題1
# 二 標題2
# 三 標題3
## 三.一 標題3.1
}}}
效果如
# 一 標題1
# 二 標題2
# 三 標題3
## 三.一 標題3.1
如果一個列表的行使用多行來顯示,那麼直接在第二行的文本開始加空格直道和第一行對齊就可以了。例:
* 這是一行的列表項.//
* 這是個多行的列表項.//
我們繼續在該列表項中添加行.//
現在在第三行了...//
* 這是第三行列表項.//
!定義表註釋
一個簡單的方法是用 ';:' -創建:
;__創建__:''在這裏進行創建的操作''
另一個用法是用 ';:' 來註釋別人寫的文本, 在定義的是時候使用一個空的 '條件', 像這樣:
{{{
;:''這裏是註釋.''
}}}
顯示效果如下:
;:''這裏是註釋.''
!文本效果
你可以使用 __粗體__ 或 ''斜體'' , 分別使用兩個下劃線和兩個單引號. 如果你使用的是微軟的視窗系統,確定你使用了正確的單引號, 因爲有很多符號比較類似, 實際上它們不是單引號.
!預格式文本
如果你想建立一個預格式化的文本 (像代碼) 使用3個({) 做爲開始, 3個(}) 作爲結束,中間填寫代碼.
!!鏈接部分
鏈接是Wiki的主要部分.
!鏈接到Wiki頁面
在括號裏輸入鏈接頁的名字就可以了: [[像這樣]. 這將自動創建一個鏈接的頁面。
!鏈接到外部站點
鏈接也可以直接指向 http:, ftp:, mailto:, https:, 或 news:, 如果這個鏈接指向了一個外部地址. 例如, 指向java.sun.com 的主頁, 使用 [[http://java.sun.com], 會變成 [http://java.sun.com/]; [[Java home page|http://java.sun.com], 會變成 [Java home page|http://java.sun.com].
!腳註
這是一個特殊的超鏈接. 在鏈接的裏面只需要使用數字。
像 [[1], 會創建一個腳註[1]. 一個真正的腳註如 [[#1]
會指向你鏈接的地方. 同過下面的例子來理解腳註.
你也可以使用一個普通的鏈接作爲腳註. 例如, 這個腳註[Footnote number 1|1] 是上面的腳註, 但是這個指向了其他的腳註[2].
!Wiki內部鏈接
你可以不需要知道URL就指定鏈接到不同的Wiki中。僅僅使用一個鏈接從[[Wiki:WikiPage] 並且 JSPWiki 會爲你創建一個鏈接. 例如, 這個鏈接指到[JSPWiki TextFormatting rules|JSPWiki:TextFormattingRules]. 查看 [SystemInfo] 獲得更多幫助。
如果Wiki不支持內部的鏈接, 當你保存的時候會得到一個提示信息。
!!表格
你可以使用('|')來創建簡單的表格。使用兩個豎槓('||')作爲表格的標題,使用一個豎槓來生成表格的行。
例如:
{{{
|| 標題1 || 標題2
| ''咯咯咯'' | 酒吧
| [主要鏈接] | [動物世界]
}}}
你也可以在表格中加入鏈接,效果如下:
|| 標題1 || 標題2
| ''咯咯咯'' | 酒吧
| [主要鏈接] | [動物世界]
!!樣式
%%commentbox
__你好!注意這裏__//
這個評論窗口使用了"commentbox"的樣式, 該樣式定義在 "jspwiki.css" 樣式表中. 製作一個同樣的樣式,你可以使用 {{{%%commentbox <這裏是填寫的文本內容> %%}}}.
%%
除了Wiki樣式表提供的樣式外,我們也可以使用自定義的樣式表。如:
{{{
%%small
這裏的文本使用了小一些的字體
%%
}}}
使用了css的"small", 同樣在jspwiki.css文件中有定義。 也有可能這些css定義在不同的站點之間,這取決於這些站點的管理員如何定義這些css文件。
你甚至可以定義任何的CSS:
{{{
%%( font-size: 150%; color: red; )
你好,世界!
%%
}}}
將顯示爲:
%%( font-size: 150%; color: red; )
你好, 世界!
%%
__注意__ 如果你想結束這個CSS使用{{{%%}}}!
!!管理你的Wiki
!衝突
如果某人和你正在編輯同一個頁面,JSPWiki將給你一個提示,首先改變頁面的人會成功...
__警告的話:__ 如果你使用返回按鈕進入到編輯頁面,你也會看到一個提示。此時瀏覽器認爲你仍然在編輯一個早期的副本。
!刪除頁面
每個頁面的下面都有“更多信息”的鏈接. 如果你點擊他, 你就會進入一個頁面,這個頁面可以刪除或者恢復該文章以往的版本。 注意可能Wiki的管理員不允許用戶刪除頁面。
!添加新頁面
創建一個鏈接指向一個新的頁面使用 [WikiName]。
點擊那個新的鏈接, 鏈接的後綴將會出現一個?並且頁面會跳到編輯一個新頁面上。
!添加附件
如果Wiki管理員已經配置了它, 將會在每個頁面的底部出現 "添加附件" 的鏈接。 點擊它你可以上傳附件,查看 [WikiAttachments]獲得更多幫助。
!!使用變量
在JSPWiki裏,有一些系統定義好的或者用戶自定義的變量,我們可以在自己的Wiki頁面裏讀取並顯示這些變量. 基本格式爲:
!插入變量
你可以在頁面裏插入很多變量:
{{ [[{$variablename}], }}
__注意__: 變量名是不區分大小寫的, "paGeNamE" 與 "PageName" 表示相同的變量.
你可以在[WikiVariables]裏面找到變量的用法。
!加入插件
加入插件的基本語法是:
[[{INSERT <plugin class> WHERE param1=value, param2=value, ...}]
更多的信息請查看 [JSPWikiPlugins].
!插入表單
請查看 [WikiForms].
----
[#1] 這裏是上面提及的腳註
[The other footnote|#2] 其他的腳註. 注意它們的名字爲什麼不同?