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

快速參考#

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

[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) ../images/xmlCoffeeCup.png

假如您替圖片指定一個文字([這是一個例子|http://example.com/example.png]),則該文字會變成該圖片的替代文字(當無法載入,或是無法顯示時,瀏覽器將會顯示的替代文字)。

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

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

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

標題#

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

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

項目符號列表(Bulleted lists)#

在第一行中使用一個星號(*)來產生項目符號列表。使用多個星號來標示較內層的項目。比如:
* 一
* 二
* 三
** 三.二

會產生:

    • 三.二

編號列表#

如同項目符號列表,但是以井字號(#)代替。比如:
# 一
# 二
# 三
## 三.二

會產生:

    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]則參考到其它註腳。

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

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

表格#

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

比如:

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

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

標題 1 標題 2
Gobble Bar
Main SandBox

樣式#

嗨,看這裡!
如同我們在這裡標示了意見箱(comment box)一樣,您能夠直接在您的維基頁面上做一些有趣的事。本範例所呈現的意見箱,使用定義於“jspwiki.css”樣式表中的“commentbox”樣式。您只要在頁面中使用 %%commentbox <text> %%,就能夠建立類似本範例的意見箱。
除了由維基標記(WikiMarkup) 所提供的基本樣式,我們也允許您加入您專屬的樣式到頁面中。比如下面的例子
%%small
這是一段小型字型所呈現文字
%%

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

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

%%( font-size: 150%; color: red; )
Hello, world!
%%
上例的範例會被呈現成:
Hello, world!

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

%%
做結束!

管理您的維基系統#

不一致#

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

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

刪除頁面#

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

加入新的頁面#

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

附加檔案#

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

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

插入變數#

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

[{$variablename}],

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

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

嵌入外掛程式#

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

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

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

插入表單#

請參考維基表單


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

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

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-3) was last changed on 06-Apr-2007 04:02 by 203.207.8.146