當您已經理解編輯的運作方式,您應該要瞭解維基編輯慣例,以便讓您可以運用您新習得的技術...
快速參考#
---- = 產生水平線。額外的‘-’將會被忽略。 \\ = 強迫產生一個斷行。 \\\ = 強迫斷行並且回到列首。 [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) 我們可以如此的反覆下去(此列在該項目的第三列)... 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] 這裡是我前面提到的註腳。
[其它註腳] 其它的註腳。請注意本註腳的名稱跟上一個註腳是有差異的。
如同我們在這裡標示了意見箱(comment box)一樣,您能夠直接在您的維基頁面上做一些有趣的事。本範例所呈現的意見箱,使用定義於“jspwiki.css”樣式表中的“commentbox”樣式。您只要在頁面中使用 %%commentbox <text> %%,就能夠建立類似本範例的意見箱。