wiki樣式

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=」後面加上不同的語法，即可套用到不同的範圍：

然而，%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 >>