Wiki樣式基本介紹
WikiStyles允許作者修改頁面內容（如文字）的顏色或其它屬性。Wikistyle使用百分比符號所寫成，例如%red%或者是%bgcolor=lightblue%。
Wiki樣式和CSS樣式的比較
Wiki樣式(WikiStyles)是專門用在撰寫Wiki頁面，而和CSS並不完全相同。Wiki樣式讓作者們可以使用管理者所定義好的CSS樣式。並且可以自行定義不同的CSS樣式組合。而不用更動網路主機中的CSS定義資料。
要注意的地方是，雖然PmWiki允許作者們在表格以及區塊中使用進階的 class= 及 style= 。但是以上兩者其實是HTML語法，而不是Wiki樣式。所以要使用上述的進階用法，您必須具有CSS的相關知識。
字體及文字顏色
最基本的wikistyles為改變文字屬性，例如文字顏色、背景顏色以及字型。PmWiki 定義了數種改變文字顏色的方法，例如：%black%, %white%, %red%, %yellow%, %blue%, %gray%, %silver%, %maroon%, %green%, %navy%, and %purple%。
籃子裡有%red%蘋果，%blue%藍苺，%purple%茄子，%green%來姆果
，%%以及其它水果。 |
籃子裡有蘋果，藍苺，茄子，來姆果
，以及其它水果。
|
對於未定義名稱的顏色，必須使用%color=...%這樣的格式。（註：為避免與WikiWord混淆，RGB顏色（#rrggbb）定義務必使用小寫字母。）
我也想來點%color=#ff7f00%椪柑%%！
|
我也想來點椪柑！
|
使用%bgcolor=...%來設定背景顏色：
這個句子有%bgcolor=green yellow%綠底黄字的設定。 |
這個句子有綠底黄字的設定。
|
請參見 WikiStyle Colors 獲得關於更多有關文字顏色設定的方法。
文字對齊(Text justification)
Wiki樣式也可以用於文字對齊的設定
%center%此文字被置中
%right% 靠右對齊
| 此文字被置中
靠右對齊
|
Wiki樣式也可用於建立浮動文字(floating text)
%rfloat% 此文字為向右的浮動文字
%rframe% 此文字在框架內會向右浮動
框架外的文字
| 此文字為向右的浮動文字
此文字在框架內會向右浮動
框架外的文字
|
作用範圍
Wikistyles可以設定套用的範圍；倘若不設定範圍，則樣式會一直生效，直到下一個樣式定義，或者到達段落結尾。使用時在樣式定義前加上範圍修飾字即可。例如套用到整個段落(%p ...%)、整份清單(%list ...%)、清單項目(%item ...%)以及任何的區塊(%block ...%)。下表的「apply=」後面加上不同的語法，即可套用到不同的範圍：
| 應用語法 | 縮寫 | 應用範圍 |
|---|
%apply=img ...% | - | 以下所有的圖片 |
%apply=p ...% | %p ...% | 僅此段落 |
%apply=pre ...% | - | 此預先格式化內容(preformatted text) |
%apply=list ...% | %list ...% | 僅此清單 |
%apply=item ...% | %item ...% | 僅此清單項目 |
%apply=div ...% | - | 僅此div |
%apply=block ...% | %block ...% | 僅此區塊(block)，不論為段落、清單、標題或division |
然而，%p color=blue%和%apply=p color=blue%的效用是一樣的；另外，%list ROMAN%和%apply=list list-style=upper-roman%的效用也是一樣的。
某些predefined style shortcuts也可以被使用，例如%right%便是%text-align=right apply=block%的縮寫。
%p bgcolor=#ffeeee%段落最前面的樣式定義會套用在整個段落內容上，即使裡頭又定義了%blue%其它的樣式%%。
|
段落最前面的樣式定義會套用在整個段落內容上，即使裡頭又定義了其它的樣式。
|
>>Wiki樣式<<區塊能將樣式套用到自定範圍的頁面內容中。樣式區塊會一直作用直到下一個>><<。
>>blue font-style=italic bgcolor=#ffffcc<<
上一行後所有內容的樣式皆為藍色斜體字，
包括了
預先格式化文字
* 清單
-> 縮排物件
>><<
|
上一行後所有內容的樣式皆為藍色斜體字，
包括了
預先格式化文字
縮排物件
|
Wikistyle 同等語法：
在其他的語言中，和wikistytle具有同等效力的語法如下：
------------ CSS ------------- --HTML--
color bgcolor class
background-color margin id
text-align padding hspace
text-decoration border vspace
font-size float target
font-family list-style rel
font-weight width* accesskey
font-style height* value
Special: define, apply
前兩欄的同等語法來自於 階層式樣式表(cascading style sheet) (CSS) 同名稱語法的所有特性。而最後一欄的同等語法只適用於特定項目 。
class= and id= assign a CSS class or identifier to an HTML element
target=name opens links that follow in a browser window called "name"
rel=name in a link identifies the relationship of a target page
accesskey=x uses 'x' as a shortcut key for the link that follows
value=9 sets the number of the current ordered list item
自訂的樣式與其語法
define=屬性可用來為任何wiki樣式定義一個語法。之後的文章使用這個語法，即可重覆利用這個樣式定義。
例如下面，我們定義一個為box的樣式語法：
%define=box block bgcolor=#ddddff border="2px dotted blue"%
%box% [@
$ 回聲 "Hello world"
Hello World
$ 離開
@]
%box font-weight=bold color=green% [@
$ 回聲 "I said, HELLO"
@] |
$ 回聲 "Hello world"
Hello World
$ 離開
$ 回聲 "I said, HELLO"
|
小技巧︰將常用的樣式語法集中放在Group Header?頁面中，以便群組裡頭所有的頁面都能利用這些縮寫。系統管理員可以在local customization?先定義一些套用於整個系統的樣式縮寫（詳見CustomWikiStyles?）。
小技巧︰樣式縮寫應命名成有意義的字詞，而不是直接用顏色名字。比如說如果警告訊息要用綠色字，則設定縮寫為%define=warn green%，並使用%warn%來套用警告樣式，而非使用%green%。之後若決定變換警告樣式，則只要修改%define=warn green%，所有%warn%就會跟著變換。這樣比起一個一個換掉%green%來得容易多了。
預設的樣式語法
PmWiki預先設定了一些樣式語法
- 文字顏色：black, white, red, yellow, blue, gray, silver, maroon, green, navy,purple （於
%color=...%使用）
- 對齊：
%center%和%right%
- 圖片與格子（Images and boxes）
- 向右浮動、向左浮動：
%rfloat% 和 %lfloat%
- 圖框:
%frame%, %rframe%, 和 %lframe%
- 縮圖大小：
%thumb%
- 在新視窗開啟連結：
%newwin%（予%target=_blank%使用）
- 註釋：
%comment%（予%display=none%使用）
- 有序清單：
%decimal%, %roman%, %ROMAN%, %alpha%, %ALPHA%（請參照Cookbook:OutlineLists）
使用範例
WikiStyleExamples?頁面有許多wiki樣式的使用範例。
已知問題
- 在樣式定義中，百分比符號（%）無法正確作用（例如：
%block width=50% %）
<< Table directives? | DocumentationIndex | Wiki style examples? >>
