HomeContactBlogMember Area

Contents

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? >>


Home | Site Map | Trademark Policy | Privacy Policy

Copyright © 2013 OSGi™ Alliance. Comments about the site?  Send them to: OSGi Alliance WebMaster.