當您已經理解編輯的運作方式，您應該要瞭解維基編輯慣例，以便讓您可以運用您新習得的技術...

快速參考#

----       = 產生水平線。額外的‘-’將會被忽略。
\\         = 強迫產生一個斷行。
\\\        = 強迫斷行並且回到列首。

[link]     = 建立一個超連結，其連結到一個名為‘link’的內部維基網頁。
[this is also a link] = 建立一個超連結，其連結到
                        一個名為‘ThisIsAlsoALink’的內部維基網頁。
[click here|link] = 建立一個超連結，其連結到一個名為‘link’的內部維基網頁，
                    並以‘click here’作為顯示的文字。

[1]        = 產生連結到編號為 1 的註腳參考連結。
[#1]       = 產生註腳編號 1 的註腳。
[[link]    = 產生‘[link]’而不是產生一個超連結。

!heading   = 以小型標題的字元大小來呈現標題文字‘heading’。
!!heading  = 以中型標題的字元大小來呈現標題文字‘heading’。
!!!heading = 以大型標題的字元大小來呈現標題文字‘heading’。

''text''   = 將‘text’以斜體的方式呈現。
__text__   = 將‘text’以粗體的方式呈現。
{{text}}   = 將‘text’以定寬字（monospaced）字型來呈現。

* text     = 將‘text’以項目符號（‧）的方式來編排。
# text     = 將‘text’以編號的方式來編排。
;term:ex   = 產生‘ex’來說明‘term’的定義。

撰寫文字#

您可以在不瞭解維基文字格式規則的情況下來正常使用維基系統。您只要撰寫正常的文字內容，並且使用空白行來分段（就像是在寫電子郵件一般），您就可以使用我們的系統了。

您也可以使用左邊的選單中的編輯選向來編輯網頁，您可以馬上檢視您對網頁所做的任何改變。

新增圖片#

您可以在在文章中嵌入任何系統支援的、可存取的圖片，並連結到它。比如，下面是兩個內嵌的 PNG 圖片：1) ，和 2) 。

假如您替圖片指定一個文字（[這是一個例子|]），則該文字會變成該圖片的替代文字（當無法載入，或是無法顯示時，瀏覽器將會顯示的替代文字）。

您也可以附加一張圖片，並參考到它，就好像它是另一個網頁一般。請參考維基附加檔案以取得更多資訊。

假若您需要更多的版面控制（或是類似圖形化標題的處理），請參考 Image 外掛程式。其可以協助您完成更複雜的處理，而不僅僅是將圖片嵌入到文字中而已。

系統可直接嵌入的影像、圖片類型端賴底層的維基系統的設定。請參考系統資訊來獲得本系統目前所接受的影像類型。

標題#

JSPWiki 提供三種標題：1) 小型標題（以單一一個驚嘆號‘!’來作為開頭），2) 中型標題（兩個驚嘆號），或是大型標題（三個驚嘆號）。

所有的標題也會連帶產生對應的“命名錨點（named anchor）”，因此您可以從其它的維基頁面中參考到這個頁面。請參考命名標題以取得更多的資訊。

項目符號列表（Bulleted lists）#

在第一行中使用一個星號（*）來產生項目符號列表。使用多個星號來標示較內層的項目。比如：

* 一
* 二
* 三
** 三.二

會產生：

• 一
• 二
• 三
  • 三.二

編號列表#

如同項目符號列表，但是以井字號（#）代替。比如：

# 一
# 二
# 三
## 三.二

會產生：

1. 一
2. 二
3. 三
   1. 三.二

假如您的列表項目需要多列來呈現，只需要在下一列的開頭加上一個或多個空白，則該列會自動的加入前一個項目。這感覺起來似乎挺複雜的，您可以嘗試編輯下面這個範例：

• 這是一個單列項目。
• 1) 這個項目實際上橫跨多列。 2) 我們將這一列接續上一列。 3) 我們可以如此的反覆下去（此列在該項目的第三列）... 4) 請注意，所有的句子都會放置在同一個項目內！
• 我們讓第三列又再一次呈現單列項目，好讓您能瞭解。

定義列表和註解、評論#

簡單的產生定義列表的方式是使用‘;:’符號，比如，我們定義‘‘Construct’：

Construct

Something you use to do something with

藉由在‘;:’的定義中使用空的‘term’，您可以替其它人的文字加上簡短的註解或評論。比如：

;:''註解在此''

上例會產生：

註解在此

文字效果#

藉由使用兩個底線（_）和兩個單引號（'），可以分別在網頁上呈現粗體或 斜體兩種文體。假如您使用微軟視窗作業系統，請確保您使用正確的引號標誌，因為在該系統上有兩種很類似的符號。

預先格式的文字（Preformatted text）#

假如您想要添加預先格式文字（比如程式碼），只要使用三個連續的大括號（{）來起始一個文字區塊，再以三個連續的大括號（}）做結束。請嘗試編輯下面的範例來嘗試這個特性。

   這是一個範例。

到處都是連結#

連結是維基系統不可或缺的部分。

連結到一個維基頁面#

只要在中括號中輸入要連結的維基頁面名稱：[像這樣]。如此將會自動的建立一個指向該頁面的連結。

注意！本系統也可以設定為支援標準的駝峰格式（CamelCase）的連結方式（假如將組態設定成支援該格式，則您只要輸入類似 CamelCase 這樣的字串，其將會自動轉換成一個連結）。該選項預設是不啟用（off），但是假如系統管理者開啟該選項，那麼，您可以隨意的在頁面中使用它 =)。

連結到外部的網站#

您所設定的連結可以是一個直接以 http:、ftp:、mailto:、https: 或是 news: 作為開頭的 URL，在這種情形下，該連結會指向一個外部的網頁。比如，若是要指向 java.sun.com 的首頁，請使用 [http://java.sun.com]，其會轉換為 http://java.sun.com/；您也可以使用 [Java 首頁|http://java.sun.com]，其會轉換為 Java 首頁。

註腳#

本系統支援註解超連結。藉著在欲產生的超連結中網址中，以數字代替，您可以建立一個指向註腳的參考。比如 [1]，其會建立立一個註腳[1]。要在頁面中建立實際的註腳，您只要在您希望放置註腳的位置放置 [#1]。請參考本頁頁底的註腳。

就像您平常產生正常的超連結一樣，您也可以建立一個命名的註腳。比如，[註腳編號 1] 參考到前述的註腳，而註腳[2]則參考到其它註腳。

維基網站間的連結（InterWiki links）#

您也可以在不同的維基網站間建立連結，而不需要知道它們的網站實際的 URL。您只要使用類似[維基網站名稱:欲連結的維基頁面]的格式，則 JSPWiki 將會替您建立該連結。比如，[JSPWiki 標籤編輯標準|JSPWiki:TextFormattingRules] 會指向 JSPWiki 網站的 TextFormattingRules 頁面。請檢視系統資訊頁面以取得更多關於內建的維基網站可用連結資訊。

假如系統並不支援您所使用的維基網站間連結，則在該頁面要儲存時，系統會通知您使用了不支援的連結。

表格#

您可以藉由使用分隔符號（‘|’）產生簡單的表格。使用兩個分隔符號起始表格的標題，單一一個分隔符號來表示表格的一列。

比如：

|| 標題 1 || 標題 2
| ''Gobble'' | Bar
| [Main]     | [SandBox]

會產生下面的表格。注意，您也可以在表格中使用連結。

標題 1	標題 2
Gobble	Bar
Main	SandBox

樣式#

除了由維基標記（WikiMarkup） 所提供的基本樣式，我們也允許您加入您專屬的樣式到頁面中。比如下面的例子

%%small
這是一段小型字型所呈現文字
%%

使用定義於 templates/default/jspwiki.css 檔案中的“small”CSS 樣式。要注意的是，若是您使用該樣式，那麼其定義可能隨不同的網站而不同，端賴網站管理者如何定義這些樣式。

您也可以定義任何的 CSS 樣式：

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

上例的範例會被呈現成：

注意！ 您必須在您所撰寫的樣式文字結尾以

%%

做結束！

管理您的維基系統#

不一致#

假如有某一個使用者跟您在同一時間編輯同一個頁面，JSPWiki 將會防止您進行行改變，並且顯示一個發生衝突的頁面來取代您原先的編輯。在這裡，我們要很抱歉的說，先跑先贏...

警告：假如您使用您的瀏覽器上的上一頁按鈕，回到原先編輯的頁面，您幾乎一定會遇到前述的不一致警告。這是因為瀏覽器認為它仍然再編輯該頁面的早先副本。

刪除頁面#

每一個頁面的頁底都會有一個“更多資訊...”的連結。假如您點選它，您會被轉送到一個頁面，在那個頁面中，您可以回復該頁面舊的版本，或刪除整個頁面。要注意的是，您的管理者也許不允許您隨意刪除頁面。

加入新的頁面#

只要使用維基命名建立一個指向新的（不存在）的頁面的超連結，點選那個新建立的連結，那麼您會進入該頁面的編輯模式。

附加檔案#

假如維基系統的管理者將系統設定為允許在頁面中附加檔案，那麼在每一個頁面的頁底，會有一個“附加檔案...”的連結。經由連結，您可以附加一些檔案到該頁面中。請參考維基附加檔案，以取得更多資訊。

變數、外掛程式、表格和其它額外的功能#

插入變數#

您可以在您的頁面中插入變數。基本的語法如下：

[{$variablename}],

其中 variablename 為您想要插入的變數名稱。要注意的是，變數名稱是跟大小寫無關；也就是說，“pagename”跟“paGeNamE”和“PageName”為相同的變數。

您可以在系統變數中檢視系統所提供的變數列表。

嵌入外掛程式#

在系統中嵌入一個外掛程式的基本語法為：

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

在維基外掛程式中有更多的資訊。

插入表單#

請參考維基表單。

---

[#1] 這裡是我前面提到的註腳。

[其它註腳] 其它的註腳。請注意本註腳的名稱跟上一個註腳是有差異的。