Wiki語法

本頁尚未完全翻譯完成。

複製自(但不包含於!) http://www.wikidot.com/doc:wiki-syntax
如果你在此進入編輯模式,與後者編輯的是同一個頁面:「需要幫忙嗎?請參考 wiki syntax descriptioncode snippets collection.」

這個也很有用: [http://doc.wikidot.com/] (由Community-Admins建立) 右邊有翻譯按鈕!


這個文件描述Wikidot.com所使用的Wiki語法

本網站的任何頁面都存在著兩種型式:原始碼(source code)和編譯碼(compiled code)。原始碼是你用來編輯以及描述頁面內容。當你瀏覽頁面時,原始碼會被編譯為XHTML碼以傳送給瀏覽器使用。Wiki語法用來是編輯原始碼,以創建頁面內容。

如果你想尋找已寫好的程式碼片段(code snippet)以複製/貼上/修改,請參見我們的程式碼片段網站

文字格式

輸入的程式碼 得到的效果
//斜體字// 斜體字
**粗體字** 粗體字
//**斜體加粗體字**// 斜體加粗體字
__加底線__ 加底線
--加刪除線-- 加刪除線
{{打字機體(等寬字體)}} 打字機體(等寬字體)
正常字^^上標字^^ 正常字上標字
正常字,,下標字,, 正常字下標字
[!-- 隱藏的註解 --]
[[span style="color:red"]]自訂的 //區段// 元素[[/span]] 自訂的 區段 元素
##blue|預設名稱的## or ##44FF88|自訂編碼的## 顏色 預設名稱的 or 自訂編碼的 顏色

字體大小

輸入的程式碼 得到的效果
[[size 80%]]正常大小的80%[[/size]] 正常大小的80%
[[size 100%]]正常大小的100%[[/size]] 正常大小的100%
[[size 200%]]正常大小的200%[[/size]] 正常大小的200%
[[size xx-small]]xx-small 字體[[/size]] xx-small 字體
[[size x-small]]x-small 字體[[/size]] x-small 字體
[[size small]]small 字體[[/size]] small 字體
[[size smaller]]smaller 字體[[/size]] smaller 字體
正常字體 正常字體
[[size larger]]larger 字體[[/size]] larger 字體
[[size large]]large 字體[[/size]] large 字體
[[size x-large]]x-large 字體[[/size]] x-large 字體
[[size xx-large]]xx-large 字體[[/size]] xx-large 字體

段落及換行

段落之間以兩個「換行」來間隔。一個「換行」就如其名,只會換一行。

這是第一段。內容是什麼並不重要,只是湊成一段文字而已。 

這是第二段。同樣地,別在意內容到底寫了什麼,只是湊成另一段文字而已。 
這只是換一行。
這是再換一行。

這是第一段。內容是什麼並不重要,只是湊成一段文字而已。

這是第二段。同樣地,別在意內容到底寫了什麼,只是湊成另一段文字而已。
這只是換一行。
這是再換一行。

標點符號

如果你很在意標點符號的效果,這裡有些方法來改善:

輸入的程式碼 得到的效果
``雙引號'' “雙引號”
`單引號' ‘單引號’
,,上下雙引號'' „上下雙引號”
刪節號... 刪節號…
破折號 -- 破折號 —

純文字

如果你希望某段文字以純文字方式顯示,跳過語法的效果,就把該段文字用兩個「@」號夾住。

這段 //文字// **受到** 語法效果。 

@@這段 //文字// **不受** 語法效果。@@

這段 文字 受到 語法效果。

這段 //文字// **不受** 語法效果。

註解

「註解」是一個原始碼區塊,在編繹時會被跳過。建立方式是在原始碼中加上[!-- ... --],例如:

[!--
這段文字不會被編譯。
--]

標題

要建立標題,在該行的最前面加上「加號(+)」。加號的數量會決定標題字的層級。

+ 第一級標題
++ 第二級標題
+++ 第三級標題
++++ 第四級標題
+++++ 第五級標題
++++++ 第六級標題

內容目錄(Table of Contents)

「內容目錄」指的是所有「標題」的清單和連結。在希望加入的地方放置一個「內容目錄」的標籤即可。

[[toc]]
[[f>toc]] - 靠右的內容目錄
[[f<toc]] - 靠左的內容目錄

水平分隔線

用四個以上的「減號」(----) 可建立水平分隔線。

清單(Lists)

不編號清單

在段落的開頭加上一個「星號」,就會產生清單的符號。在「星號」前加上空格,可以讓清單項目向右縮排。

* 第一項
* 第二項
 * 第二之一項
  • 第一項
  • 第二項
    • 第二之一項

編號清單

方法與不編號清單類似。在段落開頭使用「#」號可以建立編碼清單。

# 第一項
# 第二項
 # 第二之一項
  1. 第一項
  2. 第二項
    1. 第二之一項

不編碼清單和編碼清單可以混合使用。

名詞定義清單

你可以用以下方式來建立名詞定義清單。

: 名詞一 : 意思指的是這個。
: 名詞二 : 意思指的是那個。
名詞一
意思指的是這個。
名詞二
意思指的是那個。

引用區塊(Block Quotes)

你可以在行首使用一個或多個「>」符號,來建立「引用區塊」。「>」符號後面要加一格空格。

這是一般的文字。

> 這就是引用區塊的文字。 \
另外,注意到我們可以在行尾使用反斜線「\」, \
這樣就可以把很多行連接成同一段。

>
> 這是另一段,接下來......
>> 這是第二層的縮排。 \
會比第一層的引用區塊往右縮得更多。

回到一般的文字。

這是一般的文字。

這就是引用區塊的文字。 另外,注意到我們可以在行尾使用反斜線「\」, 這樣就可以把很多行連接成同一段。

這是另一段,接下來……

這是第二層的縮排。 會比第一層的引用區塊往右縮得更多。

回到一般的文字。

連結

內部連結

不像某些其他的wiki引擎以CamelCase格式的文字作為頁面連結(指的是取消文字間的空格,但每個單字字首採用大寫的連寫格式),wikidot的內部連結一律採用三個中括號包夾。
如果頁面的網址包含有不允許的字符,該字符會被「unix化」成可允許的字符。然而顯示出來的名稱仍然會維持原來的樣子。

輸入的程式碼 得到的效果 備註
[[[link-to-a-page]]] link-to-a-page 使用原始的頁面名稱
[[[link "TO" ą pagE]]] link "TO" ą pagE 目標頁面自動淨化
[[[○○目錄: ◎◎頁面]]] ◎◎頁面 連結到一個置於某目錄名稱下的頁面
[[[some page| 另訂的文字]]] 另訂的文字 使用另訂的文字來顯示連結
[[[doc|Documentation]]] Documentation 連結到一個既有的頁面 (不同顏色)
[[[doc#toc1|第一節]]] 第一節 連結到一個錨點(第一節)
[[[doc#toc1]]] doc 連結到一個錨點(第一節)

URLs

輸入的程式碼 得到的效果 備註
http://www.wikidot.com http://www.wikidot.com 簡單的一行連結
[http://www.wikidot.com wikidot] wikidot 自訂連結顯示的名稱
*http://www.wikidot.com
[*http://www.wikidot.com wikidot]
http://www.wikidot.com
wikidot
在新視窗開啟連結
[# 空白連結] 空白連結 也就是href="javascript:;"連結,並不會轉到任何地方法。建構下拉式選單時很好用。

錨點

要放置錨點的話,使用[[# 錨點名稱]]語法。要放置錨點的連結,使用[#錨點名稱 連結顯示的文字]

電子郵件

輸入的程式碼 得到的效果 備註
support@example.com moc.elpmaxe|troppus#moc.elpmaxe|troppus 簡單的單行email
[support@example.com 寫信給我!] moc.elpmaxe|troppus#��榵硿䫯� 自訂的連結文字

雖然我們不鼓勵任何人在網路上公開自己的email網址,但是WikiDot還是提供了一個簡單的加密機制以防止機器人讀取電子郵件。
每封信都會被加密,然後在客戶的瀏覽器上解碼。此法雖非100%安全,但比普通文字信件安全得多。

跨Wiki的連結

要連結到一篇「維基百科」的文章,可以使用以下語法:

輸入的程式碼 得到的效果
[wikipedia:Albert_Einstein] Albert_Einstein
[wikipedia:Albert_Einstein 愛因斯坦] 愛因斯坦

其他連結定義方式的範例:

  • [google:free+wiki] - 在google搜尋「free wiki」一詞
  • [dictionary:wiki] - 在dictionary.reference.com網站搜尋「wiki」這個字的定義

圖片

單張圖片

在頁面中插入單張圖片,採用以下語法:

[[image 圖片來源位址 屬性1="設定值1" 屬性2="設定值2" ...]]

屬性有以下幾種:

屬性名稱 允許的設定值 設定值範例 說明
link wiki頁面名稱或URL連結 "wiki-page"
"http://www.example.com"
以其他頁面或網路連結作為圖片。當使用Flickr為圖片來源時會被忽略。連結前加上的星號(*)的話會在新視窗開啟。
alt 任何字串 "a photo of me" 當圖片不存在時的替代顯示文字
width 畫素數 "200px" 強制寬度
height 畫素數 "200px" 強制高度
style 有效的CSS style定義 "border: 1px solid red; padding: 2em;" 為圖片加上額外的CSS style參數
class CSS class "mystyle" 強制該圖片以CSS class定義的方式顯示 - 通常只用在自訂的背景主題
size "square" - 75x75畫素
"thumbnail" - 長邊100畫素
"small" - 長邊240畫素
"medium" - 長邊500畫素
"large" - 長邊1024畫素(只適用於Flickr的較大圖片)
"original" - 原始圖片(只適用於Flickr)
any of allowed ;-) 顯示為一張 調整大小的 圖片; 適合作為索引圖
如果圖片來源是flickr,會依要求的尺寸從Flickr伺服器中調出來;
這個選項只適用於本地檔案或Flicke裡的圖片。

size 屬性在本地檔案(附在頁面的檔案,在Wikidot伺服器內)非常好用。而且不只可用在圖片上,PDF或Postscript也可以用。更多細節參見this page

圖片來源位址 可以是下列的任何一種:

來源種類 格式 設定值範例 說明
URL網址 任何有效的URL網址 http://www.example.com/image.jpg 由該網址顯示圖片
附加檔案(本頁面的) filename exampleimage.jpg 顯示附加在本頁面的圖片
附加檔案(非本頁面的) /another-page-name/filename /another-page/exampleimage.jpg 顯示附加在其他頁面的圖片
flickr 圖片 flickr:photoid flickr:83001279 顯示位於Flickr上的圖片,且附有連往Flickr原始頁面的連結
flickr 圖片(私人帳號裡的) flickr:photoid_secret flickr:149666562_debab08866 顯示位於Flickr上的圖片,且附有連往Flickr原始頁面的連結;如果加上secret一字,即使圖片在Flickr標註為「非公開的」也會顯示出來。

如果想在新視窗中開啟圖片所自動產生的連結,你可以在link屬性前加上星號(例如 link="*http://www.example.com"),或是在src元素前加上星號(例如*flickr:149666562_debab08866*image-file等等 )。

以下為選擇水平排列的方法:

  • [[=image… - 圖片置中
  • [[<image… - 圖片置左
  • [[>image… - 圖片置右
  • [[f<image… - 圖片漂浮於左(被文字圍繞)
  • [[f>image… - 圖片漂浮於右(被文字圍繞)

多張圖庫

要插入一系列的多張圖片內容,使用[[gallery]] 元素:

[[gallery size="圖片大小"]]

or
[[gallery size="圖片大小"]]
: 圖片來源1 屬性1="設定值1" 屬性2="設定值2" ...
: 圖片來源2 屬性1="設定值1" 屬性2="設定值2" ...
...
[[/gallery]]

[[gallery]] 標籤中唯一允許的屬性是 size ,其設定值也只能設定為 "square", "thumbnail", "small", "medium"

如果 [[gallery]] 標籤沒有一一指定圖片,會自動顯示附加在該頁面的所有可顯示圖示的縮圖(包括.pdf和.ps)。

如果 [[gallery]] 標籤有一一指定圖片,只有這些圖片會被顯示。這裡的圖片來源 不可以是URL網址。個別圖片只有以下屬性被允許:

  • link - URL網址或wiki頁面名稱(不適用於Flickr圖片)
  • alt - 當圖片不存在時的替代顯示文字。

想在新視窗開啟文件的方式,與單張圖片的規則相同。

如果你想要由Flickr載入圖片,請參閱FlickrGallery module

程式碼區塊

[[code]]…[[/code]] 標籤(頭尾標籤各佔一行)來建立程式碼區域。

這是一個程式碼區域的範例!

想在程式碼區塊中,利用PHP標籤來套用PHP的程式碼自動配色,需先加上[[code type="php"]]…[[/code]] 這樣的標籤。

然後在程式碼區塊中想要套用PHP顏色的範圍,以 <?php.. ?>標籤包圍起來。

WikiDot.com使用PEAR::Text_Highlighter(高亮化文字識別),並支援多種顏色主題設定。以下為支援的種類(可以作為type的設定值):

php, html, cpp, css, diff, dtd, java, javascript, perl, python, ruby, xml.

[[code type="php"]]
<?php
/* comment */
for($i=0; $i<100; $i++){
echo "number".$i."\n";
}
?>
[[/code]]
<?php
/* comment */
for($i=0; $i<100; $i++){
echo "number".$i."\n";
}
?>

表格

簡單表格

你可以用成對的直線(||,就是反斜線\按鍵的上面)來建立簡單表格:

||~ 標題 1 ||~ 標題 2 ||~ 標題 3 ||
|| 方格 1 || 方格 2 || 方格 3 ||
|||| 合併的方格 4 || 方格 5 ||
||方格 6 |||| 合併的方格 7 ||
|||||| 合併的方格 8||
標題 1 標題 2 標題 3
方格 1 方格 2 方格 3
合併的方格 4 方格 5
方格 6 合併的方格 7
合併的方格 8
|| lines must start and end || with double vertical bars || nothing ||
|| cells are separated by || double vertical bars || nothing ||
|||| you can span multiple columns by || starting each cell ||
|| with extra cell |||| separators ||
|||||| but perhaps an example is _
the easiest way to see ||
每行字必須以雙直線 開始及結束 (空白)
方格之間 以雙直線間隔 (空白)
你可以橫跨多個欄(即水平合併方格) 只需要在每個格子前面
加上更多的 方格間隔符號
但是使用範例
可能是最容易看懂的方式

在表格的單一格內可以在行尾使用「底線(_)」來強制換行(參見以上範例)

進階的表格(自訂的表格)

使用特殊的標籤可以允許classstyle 屬性來管理表格的外觀顯示,以建立進階的表格:

[[table]]
[[row]]
[[cell style="border: 1px solid silver; background-color: yellow;"]]
call 0.0
[[/cell]]
[[cell style="border: 1px solid silver"]]
call 0.1
[[/cell]]
[[/row]]
[[row style="border: 1px solid silver"]]
[[cell]]
call 1.0
[[/cell]]
[[cell style="border: 1px solid silver; background-color: yellow;"]]
call 1.1
[[/cell]]
[[/row]]
[[/table]]
會顯示成這樣的表格…
cell 0.0 cell 0.1
cell 1.0 cell 1.1

每個 [[table]][[row]][[cell]]元素都可以接受styleclass屬性,然後它們會轉換成(X)HTML標籤: <table><tr><td>

有個利用表格來製作頁面排版的範例,請參閱我們的「程式碼片段Wiki(Snippets Wiki)」:http://snippets.wikidot.com/code:layout-with-tables

表格可以是多層次的(蜂巢狀)。

區域格式元素

靠左、靠右、置中、兩端對齊

文字區塊的對齊方式採用以下程式碼:

[[<]] ... [[/<]] 靠左
[[>]] ... [[/>]] 靠右
[[=]] ... [[/=]] 置中
[[==]] ... [[/==]] 兩端對齊

範例:

[[=]]
這一串文字是用來示範對齊模式,\
所以內容是什麼並不重要。 \
重要的是讓你看出來這個對齊模式的效果, \
就像這樣。

你可以自己試試其他的效果。
[[/=]]

這一串文字是用來示範對齊模式,所以內容是什麼並不重要。重要的是讓你看出來這個對齊模式的效果,就像這樣。

你可以自己試試其他的效果。

要使單行文字置中,可直接在行首加上等號(=):

= 此行置中。

此行置中。

自訂的 div 區塊

To improve the layout you can use [[div]] ... [[/div]] elements which transform to html @div> ... </div@ blocks.
Allowed attributes are: class and style only but this should be more than enough to create desired layout.

[[div]] blocks can be nested.

Below is an example how to create a 2-column layout using div block:

[[div style="float:left; width: 45%; padding: 0 2%"]]
left column left column left column left column left column
left column left column left column left column left column
[[/div]]
[[div style="float:left; width: 45%; padding: 0 2%"]]
right column right column right column right column right column
right column right column right column right column right column
[[/div]]

~~~~~

left column left column left column left column left column left column left column left column left column left column

right column right column right column right column right column right column right column right column right column right column

The ~~~~ element is used to clear floats and translates more or less to <div style="clear:both"></div>).

Custom [[div]] blocks can be used to create very advanced page layouts.

數學

WikiDot.com uses LaTeX to render beautiful equations. For these who know LaTeX syntax using wikidot equations should be quite obvious. Please

方程式

Simply put the equation between [[math label]] … [[/math]] block tags (the label is optional). The equation is rendered within LaTex \begin{equation} ... \end{equation} environment. Please refer to any LaTeX reference manual for details about syntax.

[[math label1]]
\rho _{\rm GJ} = -\sigma (r) \left[ (1 - \eta _{\ast }^2 {\kappa \over {\eta ^3}}) \cos \chi \right.
+ \left. {3\over 2} \theta (\eta) H(\eta)
\xi \sin \chi \cos \phi \right]
[[/math]]
(1)
\begin{align} \rho _{\rm GJ} = -\sigma (r) \left[ (1 - \eta _{\ast }^2 {\kappa \over {\eta ^3}}) \cos \chi \right. + \left. {3\over 2} \theta (\eta) H(\eta) \xi \sin \chi \cos \phi \right] \end{align}

To refer to a labeled equation simply use [[eref label]] to get a raw number or e.g. Eq. ([[eref label1]]) which gives Eq. (1).

To break long equations use a type="eqnarray" attribute, e.g.

[[math label2 type="eqnarray"]]
\lefteqn{ \cos x = 1        
-\frac{x^{2}}{2!} +{} } \\
& & {}+\frac{x^{4}}{4!}
-\frac{x^{6}}{6!}+{}\cdots
[[/math]]
(2)
\begin{eqnarray} \lefteqn{ \cos x = 1 -\frac{x^{2}}{2!} +{} } \\ & & {}+\frac{x^{4}}{4!} -\frac{x^{6}}{6!}+{}\cdots \end{eqnarray}

文字之間的數學符號

To use math expressions inside text (sentence) use [[$ ... $]] block tags.

[[$ E = mc^2 $]] is much more popular than 
[[$ G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu} $]]

$E = mc^2$ is much more popular than $G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu}$

註腳

在文章中加入註腳可使用 [[footnote]] 區塊。註腳的內容會自動顯示在頁面文章最末。如果不希望顯示在頁面最末,在希望顯示的地方插入 [[footnoteblock]]

張先生[[footnote]]也就是衛生股長小張的父親。[[/footnote]]常常自己一個人拎著鍋子,
到隔好幾條街、比較遠的那家豆漿店 [[footnote]]據說是班長小青的媽媽開的。[[/footnote]]去買豆漿。

[[footnoteblock]]

張伯伯1常常自己一個人拎著鍋子,到隔好幾條街、比較遠的那家豆漿店2去買豆漿。

如果你對預設的標題「Footnotes」不滿意,也可以自訂標題:用[[footnoteblock title="Custom title"]] 或乾脆不要標題 (title="")。

參考資料

「參考資料」區塊以 [[bibliography]]...[[/bibliography]] 來定義。每筆參考資料都採下列格式表示:
標籤名稱 : 完整說明
在文章中要放置一個引用參考資料的連結記號,使用 ((bibcite 標籤名稱)).

人類發現的第一顆脈衝星是由J. Bell和A. Hewish [((bibcite bell))]所觀測到的。另一個引用參考的範例[見 ((bibcite guy))]。

[[bibliography]]
: bell : Bell, J.; Hewish, A.; Pilkington, J. D. H.; Scott, P. F.; and Collins, R. A. //Observation of a Rapidly Pulsating Radio Source.// Nature 217, 709, 1968.
: guy : Guy, R. K. //Modular Difference Sets and Error Correcting Codes.// §C10 in Unsolved Problems in Number Theory, 2nd ed. New York: Springer-Verlag, pp. 118-121, 1994.
[[/bibliography]]

人類發現的第一顆脈衝星是由J. Bell和A. Hewish [1]所觀測到的。另一個引用參考的範例[見 2]。

Bibliography
1. Bell, J.; Hewish, A.; Pilkington, J. D. H.; Scott, P. F.; and Collins, R. A. Observation of a Rapidly Pulsating Radio Source. Nature 217, 709, 1968.
2. Guy, R. K. Modular Difference Sets and Error Correcting Codes. §C10 in Unsolved Problems in Number Theory, 2nd ed. New York: Springer-Verlag, pp. 118-121, 1994.

如果你對預設的標題「Bibliography」不滿意,也可以自訂標題:用[[bibliography title="Custom title"]] 或乾脆不要標題 (title="")。

包含其他頁面(Include other pages)

If you want to include contents of another page use:

 [[include pagename]]

The include tag should start and end with a newline.

The [[include]] tag can also take parameters and substitute variables in the included source. To denote variables in the included page use:

{$var1}, {$number_books}, {$title}, {$variable_name}, {$variableName}

and in the including page use:

 [[include pagename var1=value1 | number_books = 43 | title=Best Wiki Ever 
| variable_name = just a variable
| variableName = another variable
]]

As you can see you can split variable definitions over several lines for cleaner code.

NOTE: includes and images/files: The [[include]] works just by inserting the page source at a given place. If you have any images or files attached in the included page and you refer to them as [[image filename.jpg]] in the included page, please rather use the image/file source with the name of the page too, e.g. [[image included-page/filename.jpg]]

嵌入多媒體文件

視訊

To embed video directly into the page use [[embedvideo]] ... [[/embedvideo]] block.
Between the the "embedding html code" should be placed from any of the following video online galleries:

E.g.

[[embedvideo]]
<embed style="width:400px; height:326px;" id="VideoPlayback" align="middle"
type="application/x-shockwave-flash"
src="http://video.google.com/googleplayer.swf?docId=263244138622602613"
allowScriptAccess="sameDomain" quality="best" bgcolor="#ffffff" scale="noScale" salign="TL" 
FlashVars="playerMode=embedded"> </embed>
[[/embedvideo]]

聲音

To embed audio use [[embedaudio]] ... [[/embedaudio]] and the html embedding code found on the audio hosting website.

Currently supported are:

E.g.

[[embedaudio]]
<embed src="http://www.odeo.com/flash/audio_player_standard_gray.swf" 
quality="high" width="300" height="52" name="audio_player_standard_gray" 
align="middle" allowScriptAccess="always" wmode="transparent"  
type="application/x-shockwave-flash" flashvars="audio_id=99133&audio_duration=282.0&valid_sample_rate=true&external_url=http://www.vitalpodcasts.com/FileSystem/podcasts/89/opensource_episode1.mp3" pluginspage="http://www.macromedia.com/go/getflashplayer" />
</embed><br /><a style="font-size: 9px; padding-left: 110px; color: #f39; 
letter-spacing: -1px; text-decoration: none" href="http://odeo.com/audio/99133/view">
powered by <strong>ODEO</strong></a>
[[/embedaudio]]

嵌入其他網站的程式碼

Sometimes web sites (mainly social-oriented ones) allow you to paste a code block directly into other pages in order to increase your site functionality or embed some contet from the original site.

[[embed]] 標籤

The [[embed]] block tag allows you to do the same with your wiki pages. E.g. to display del.icio.us tag cloud as generated from http://del.icio.us/help/tagrolls simply wrap the html code:

[[embed]]
<script type="text/javascript" src="http://del.icio.us/feeds/js/tags/michal_frackowiak?icon;size=12-35;color=87ceeb-0000ff;title=my%20del.icio.us%20tags"></script>
[[/embed]]

For the list of supported services please see the page: Embedding code from other services.

Please note that if the code contains <script type="text/javascript"… i.e. just JavaScript, the content will not be fully rendered when you click preview while editing the page. It should be there however when you view the page afterwards.

[[iframe]] 元素

Using the iframe element one can embed content of any other web page. The syntax is

[[iframe url-source attributes]]

and it translates into HTML tags <iframe src="url-source" attributes></iframe>. The allowed attributes are: frameborder (0 or 1 allowed), align (left, right, top, bottom, middle), height (number of pixels or %), width (number of pixels or %), scrolling (yes or no), class, style

Iftags指令(關鍵字標籤)

Tags are kind of special labels for a page, manually added in by editors by clicking on the tags link at the page options buttons on bottom of a page. Every tag can be max 64 characters long, tags are "space" separated and there is no limit of tags per page. Tags are very useful to label pages and then it's easy to create Tag Cloud, which allow to find interesting pages or topics much faster.

Special tags start with an underline: they are not automatically shown in tag clouds, but they can be used as special limitations in [[iftag]] conditions. Tags can be used in ListPages Module with generic conditions ( +, - ) too.

Iftag is a special condition question. You can use it on every page to "react" on tags and set up on the particular page used .

Syntax:

[[iftags +tag1 -tag2 tag3]] ... [[/iftags]]

where the +/-"tag#" stands for the requested tag-indexes.
  • + before a tagname means - this tag must exist, (tag without a modifier works in a same way)
  • - before a tagname means - this tag must not exist.

Example:

[[iftags +science]]
This page is labeled as: science.

Click here to view more science articles >
[[/iftags]]

[[iftags +bug -fixed]]
This is a bug, but it's not fixed yet.
[[/iftags]]

Modules指令(功能模組)

Modules are independent widgets that can be placed in the pages. The general syntax is:
[[module ModuleName param1="value1" param2="value2" ...]]

To read more about modules see the modules section of the documentation.

附加檔案

what you type what it means
[[file filename | custom-text]] produces a link to a file attached to this page.
custom-text changes the name of a link (custom-text will be displayed instead of the file name).
[[file /another-page/filename | custom-text]] produces a link to a file attached to another-page

The destination file must be first attached to the page — by clicking "files" and "upload file" from the options at the bottom of any page.

使用者

what you type what you get comments
[[user user-name]]
e.g. [[user michal frackowiak]]
michal-frackowiak user info (no buddy icon)
[[*user user-name]]
e.g. [[*user michal frackowiak]]
michal-frackowiakmichal-frackowiak user info (with buddy icon)

社群工具連結按鈕(Social bookmarking)

It is easy to add "social bookmarking" buttons to your pages — just write [[social]] (without any parameters) and get:

BlinkListblogmarksdel.icio.usdiggFarkfeedmelinksFurlLinkaGoGoNewsVineNetvouzRedditYahooMyWebFacebook

This is equivalent to:

[[social blinkbits,blinklist,blogmarks,co.mments,connotea,del.icio.us,de.lirio.us,digg,fark,feedmelinks,furl,linkagogo,ma.gnolia,newsvine,netvouz,rawsugar,reddit,scuttle,shadows,simpy,smarking,spurl,tailrank,wists,yahoomyweb,facebook]]

You can also choose only selected services, e.g. to choose digg, furl and del.icio.us use:

[[social digg,furl,del.icio.us,facebook]]

and get: diggFurldel.icio.usFacebook

Tip: use social bookmarking! It is always a good idea to put social shortcuts under an article or inside your side bar.

獨立的按鈕(頁面選項)

Somehow it might be convenient to hide the default page options and present only selected buttons to the users. The syntax for it is:

[[button type options]]

Where the type is: edit, edit-append, edit-sections, history, print, files, tags, source (view page source), backlinks, talk (works similar as in MediaWiki/Wikipedia).

Possible attributes are:

  • text — alternative text to be displayed
  • class — CSS class of the A element
  • style — CSS style definition

For some nice "view source" and "print" buttons with icons you can use the following code:

[[>]]
[[button source style="background-image: url(http://www.wikidot.com/local--files/files/view-source.png); background-repeat: no-repeat; background-position: bottom right; padding-right: 20px; color: #444"]]
[[button print style="background-image: url(http://www.wikidot.com/local--files/files/document-print.png); background-repeat: no-repeat; background-position: bottom right; padding-right: 20px;color: #444"]]
[[/>]]

to get:

排版元素

Tab view

To generate a tabview, i.e. a set of tabs, the following syntax can be used:

[[tabview]]
[[tab Title of Tab No. 1]]
Content of Tab No. 1.
[[/tab]]
[[tab Title of Tab No. 2]]
Content of Tab No. 2.
[[/tab]]
[[tab Title of Tab No. 3]]
Content of Tab No. 3.
[[/tab]]
[[/tabview]]

This will produce the following tabset:

Content of Tab No. 1.

Tabs will accept any content, but at the moment it is not possible to nest tabviews.

Another example of tabview can be found at our Snippets Wiki at http://snippets.wikidot.com/code:tabs.


Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License