• 固定網址
• 編輯
• 版本
• 列印
• Backlinks

文字格式

authors (basic)

Wikistyle basics（基礎Wiki樣式）

WikiStyles?允許作者修改頁面內容（如文字）的顏色或其它屬性。Wikistyle使用百分比符號所寫成，例如%red%或者是%bgcolor=blue%。

最基本的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%綠底黄字的設定。

Scopes（作用範圍）

Wikistyles可以設定套用的範圍；倘若不設定範圍，則樣式會一直生效，直到下一個樣式定義，或者到達段落結尾。使用時在樣式定義前加上範圍修飾字即可。例如套用到整個段落(%p ...%)、整份清單(%list ...%)、清單項目(%item ...%)以及任何的區塊(%block ...%)。

%p
bgcolor=#ffeeee%段落最前面的樣式定義會套用在整個段落內容上，即使裡頭又定義了%blue%其它的樣式%%。

>>Wiki樣式<<區塊能將樣式套用到自定範圍的頁面內容中。樣式區塊會一直作用直到下一個>><<。

>>blue font-style=italic bgcolor=#ffffcc<<
上一行後所有內容的樣式皆為藍色斜體字，

包括了
    預先格式化文字
* 清單
-> 縮排物件
>><<

    預先格式化文字

Wikistyle attributes

The style attributes recognized within a wikistyle specification are:

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

The attributes in the first two columns correspond to the cascading style sheet (CSS) properties of the same name. The attributes in the last column apply only to specific items:

• 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

Custom style shortcuts（自定樣式縮寫）

define=屬性可用來為任何wiki樣式定義命一個縮寫。之後的文章使用這個縮寫，即可重覆利用這個樣式定義。

%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%來得容易多了。

Predefined style shortcuts（預設樣式縮寫）

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% %）

<< | DocumentationIndex? | >>