雅威聖會 聖經真理研究院

辨明真理、認真遵行

使用者工具

網站工具

您在這裏: 首頁 » wiki » Formatting Syntax
wiki:syntax

差異處

這裏顯示兩個版本的差異處。

連向這個比對檢視

兩邊的前次修訂版前次修改
下次修改		前次修改
wiki:syntax [2013/01/21 13:18 -0600 Mon. (12 年前)] – wzmwiki:syntax [2024/08/07 08:12 -0500 Wed. (8 個月前)] (目前版本) – 外部編輯 127.0.0.1
行 1: 行 1:
-英文原版說明請見 [[:wiki:syntax_en]]。+====== Formatting Syntax ======
  
-====== Wiki 語法 ======+[[doku>DokuWiki]] supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing "Edit this page". If you want to try something, just use the [[playground:playground|playground]] page. The simpler markup is easily accessible via [[doku>toolbar|quickbuttons]], too.
  
-[[DokuWiki]] 支援一些簡單的語法，務求使文檔更易讀。本頁包含了您在編輯頁面時可以使用的語法。點選在頁面頂端或底端的「編修本頁」按鈕，可觀看這一頁的原始檔。如要實驗，請移玉步至[[playground:playground]]。您可以使用[[doku>toolbar|編輯按鈕]]，讓編輯過程更方便。+===== Basic Text Formatting =====
  
-譯者註：接下來就讓我們花點時間看一下吧，不一定要全懂，**建議**挑有用到、有興趣的先學，有其他問題或想學多點再來看這也可以。+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
  
 +  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
 +  Of course you can **__//''combine''//__** all these.
  
-===== 基本文字格式 =====+You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-DokuWiki 使用**空行**來區分段落((也就是 XHTML 語法中的 <p></p>))。例如：+  You can use <sub>subscript</sub> and <sup>superscript</sup>, too.
  
-  Paragraphs are created from blank lines.  +You can mark something as <del>deleted</del> as well.
-   +
-  If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.+
  
-實際顯示的結果為：+  You can mark something as <del>deleted</del> as well.
  
-Paragraphs are created from blank lines.+**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
  
-If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line.+This is some text with some linebreaks\\ Note that the 
 +two backslashes are only recognized at the end of a line\\ 
 +or followed by\\ a whitespace \\this happens without it.
  
-若您想 **強制斷行**((也就是 XHTML 語法中的 <br/>)) 的話而不是變成另一段落，那麼就在要斷尾處加兩個連續的倒斜線 %%\\%% 以及1個空白或位於這行的結尾。請看示範：+  This is some text with some linebreaks\\ Note that the 
 +  two backslashes are only recognized at the end of a line\\ 
 +  or followed by\\ a whitespace \\this happens without it.
  
-這是一些有換行標記的文字。\\ 請注意： +You should use forced newlines only if really needed.
-兩個倒斜線只在Enter之前\\ +
-或者接在\\ 一個空格之前，才會有效。\\而這樣就並不起作用。+
  
-  這是一些有換行標記的文字。\\ 請注意： +===== Links =====
-  兩個倒斜線只在Enter之前\\ +
-  或者接在\\ 一個空格之前，才會有效。\\而這樣就並不起作用。+
  
-您應該只在真正需要使用強制斷行的地方才用強制斷行。+DokuWiki supports multiple ways of creating links.
  
-DokuWiki 支援以下基本語法，並且可以 **__//''組合''//__** 各種效果。+==== External ====
  
-|說明^原始寫法^輸出效果^ +External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <[email protected]> are recognized, too.
-^粗體|%%**粗體**%%|**粗體**| +
-^斜體|%%//斜體//%%|//斜體//| +
-^底線|%%__底線__%%|__底線__| +
-^定距字體，或稱「等寬」字體((monospaced font))|%%''定距''%%|''定距''| +
-^下標字|%%H<sub>2</sub>O%%|H<sub>2</sub>O| +
-^上標字|%%y = x<sup>2</sup> + 1%%|y = x<sup>2</sup> + 1| +
-^刪除線|%%<del>刪除線</del>%%|<del>刪除線</del>|+
  
-===== 連結 =====+  DokuWiki supports multiple ways of creating links. External links are recognized 
 +  automagically: http://www.google.com or simply www.google.com - You can set 
 +  link text as well: [[http://www.google.com|This Link points to google]]. Email 
 +  addresses like this one: <[email protected]> are recognized, too.
  
-DokuWiki 可使用多種型態的連結，以下介紹各式連結用法：+==== Internal ====
  
-==== 外部連結 ====+Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]].
  
-若使用標準 URL Scheme （如 http://www.google.com），或只是 FQDN （如 www.google.com）都會被自動判斷為外部連結。 +  Internal links are created by using square brackets. You can either just give 
-此外，可以透過設定連結名稱(Linknames) 來設定連結的顯示，比如：[[http://www.google.com|這會連到 Google]]  +  a [[pagename]] or use an additional [[pagename|link text]].
-或者 email也可以用 <[email protected]> 或 [[[email protected]|andi]] 來表示。+
  
-  若使用標準 URL Scheme （如 http://www.google.com）， +[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
-  或只是 FQDN （如 www.google.com）都會被自動判斷為外部連結。 +
-  此外，可以透過設定連結名稱(Linknames) 來設定連結的顯示， +
-  比如：[[http://www.google.com|這會連到 Google]]  +
-  或者 email也可以用 <andi@splitbrain.org> 或 [[[email protected]|andi]] 來表示。+
  
-==== 內部連結 ====+You can use [[some:namespaces]] by using a colon in the pagename.
  
-內部連結是用兩組中括號包裹要連結的頁面名稱來產生。 +  You can use [[some:namespaces]] by using a colon in the pagename.
-可以直接用 [[:zh-tw:pagename]] 或加上該連結的說明 [[:zh-tw:pagename|說明文字]]。  +
-頁面名稱會被自動轉換成小寫英文字，並且不支援特殊符號。 +
-（中文頁面名稱雖然支援，但在某些部份並不完善，仍建議盡量使用英文頁面名稱 --- //[[reder.[email protected]|Reder]] 2008/06/05 04:58//）+
  
-  內部連結是用兩組中括號包裹要連結的頁面名稱來產生。 +For details about namespaces see [[doku>namespaces]].
-  可以直接用 [[pagename]] 或加上該連結的說明 [[pagename|說明文字]]。  +
-  頁面名稱會被自動轉換成小寫英文字，並且不支援特殊符號。 +
-  （中文頁面名稱雖然支援，但在某些部份並不完善，仍建議盡量使用英文頁面名稱）+
  
 +Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
  
-也可以加上冒號「:」(colon)用來做 [[:zh-tw:namespaces]] (分類名稱) 的區分而互相連結。+  This links to [[syntax#internal|this Section]].
  
-  也可以加上冒號「:」(colon)用來做 [[namespaces]] (分類名稱) 的區分而互相連結。+Notes:
  
-若想深入瞭解分類名稱（namespaces，或稱命名空間）空間請見 [[:zh-tw:namespaces|這裏]]。+  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones. 
 +  * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled. 
 +  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
  
-您也可以直接連結某個頁面的某章節段落。就像 HTML 一樣，只要在該頁後面加上 #某章節 就可以囉。比如：+==== Interwiki ====
  
-這會連到 [[:zh-tw:syntax#內部連結|這一節(internal)]]。+DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
  
-  這會連到 [[syntax#internal|這一節(internal)]]。+  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. 
 +  For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
  
-請注意:+==== Windows Shares ====
  
-  * 連到 [[:zh-tw:syntax|已存在的頁面]] 跟 [[nonexisting|不存在的頁面]] 會以不同的方式呈現(看您的 style.css 中的 CSS 設定如何而定)。 +Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>Intranet]].
-  * 符合 [[wp>CamelCase|駝峰文字]] 的詞彙通常在 Wiki 環境內會自動轉換為連結，而 DokuWiki 預設是關閉，如有需要可在[[:zh-tw:config|設定選項]]中開啟。 +
-    - 駝峰文字（CamelCase）簡言之就是「幾個英文單字之間緊接著而沒有空格」所組成的詞彙，但每個單字的首字大寫，狀如駝峰([[dict>Camel]])，故名為 CamelCase。 +
-    - 如果在[[:zh-tw:config|設定選項]]中開啟駝峰文字功能的話，那麼在文章內打出駝峰文字（如：DokuWiki）就會自動成為連結了。 +
-  * 若章節所在的頁面標題改變了，那麼其連結也會跟着改變。因此請別過度依賴章節連結功能。 +
-  * 此外可參考 [[:zh-tw:pagename|DokuWiki網站有關 pagename 的說明]] 。 +
-==== Wiki間的互連 ====+
  
-DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。 +  Windows Shares like [[\\server\share|this]] are recognized, too.
-  DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如 +
-  要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。+
  
-此外還可運用：+Notes:
  
-^原始寫法^出現的結果^說明^ +  * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). 
-|%%[[%%google>Wiki%%]]%%|[[google>yahoo]] |請 Google 搜尋大神幫您找有關 Wiki 的網頁| +  * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): <code - conf/lang/en/lang.php> 
-|%%[[%%wp>Wiki%%]]%%|[[wp>Wiki]] |連到 Wikipedia(維基百科)的 Wiki 頁| +<?php 
-|%%[[Meatball>MeatballWiki]]%%|[[Meatball>MeatballWiki]] |連到 MeatBall Wiki 的 MeatballWiki 頁| +/** 
-|%%[[phpfn>phpinfo]]%%|[[phpfn>phpinfo]] |到 php 官網看 phpinfo function 的手冊說明| + * Customization of the english language file 
-|%%[[JspWiki>System.out.println]]%%|[[JspWiki>System.out.println]] |從 JSP Wiki 找 System.out.println 說明| + * Copy only the strings that needs to be modified 
-|%%[[FreeBSDman>uname]]%%|[[FreeBSDman>uname]] |到 FreeBSD 官網找 uname 的線上說明| + */ 
-|%%[[man>passwd]]%%|[[man>passwd]] |到 Linux Qustion 查 passwd 的用法| +$lang['js']['nosmblinks'] = ''; 
-|%%[[rfc>2010]]%%|[[rfc>2010]] |找 RFC #2010 文件| +</code>
-|%%[[amazon>Bible]]%%|[[amazon>Bible]] | 到亞馬遜書局找有關聖經(Bible)的書| +
-|%%[[dict>apple]]%%|[[dict>apple]] |從雅虎奇摩字典查 apple 單字| +
-|%%[[imdb>Titanic]]%%|[[imdb>Titanic]] |從 IMDB((IMDB->Internet Movie Database))電影資料庫尋找有關 鐵達尼(Titanic) 的資料 | +
-|%%[[GoogleGroups>FireBird BBS]]%%|[[GoogleGroups>FireBird BBS]] |用Google Newsgroup內找 FireBird BBS 文章(tw.bbs.*轉信文章亦可)| +
-|%%[[bug>4]]%%|[[bug>4]] | 察看 DOKUWIKI 編號 4 的 bug 回報| +
-備註：此外，還有多種變化，請自行參見下列有關 ''conf/interwiki.conf'' 的說明。+
  
-InterWiki 可透過 ''conf/interwiki.conf'' 檔來設定。DokuWiki內建包含了 [[http://usemod.com/intermap.txt]] 所列的每項 InterWiki，格式如下：+==== Image Links ====
  
-^捷徑名稱{NAME}^網址{URL}^ +You can also use an image to link to another internal or external page by combining the syntax for links and [[#images_and_other_files|images]] (see below) like this:
-|wp        |http://en.wikipedia.org/wiki/| +
-|wpzh      |http://zh.wikipedia.org/wiki/| +
-|wpjp      |http://jp.wikipedia.org/wiki/| +
-|wpde      |http://de.wikipedia.org/wiki/|+
  
-若不想用預設的圖示，那麼可在 ''interwiki'' 目錄內放跟捷徑名稱相同的圖檔。比如捷徑名稱為「wp」，那麼圖檔名稱應為「wp.gif」或「wp.png」才行。 +  [[http://php.net|{{wiki:dokuwiki-128.png}}]]
-而這些圖檔必須是 16x16 像素(pixels) 的 PNG 或 GIF 格式。+
  
-==== 網路芳鄰分享的連結 ====+[[http://php.net|{{wiki:dokuwiki-128.png}}]]
  
-MS Windows 主機使用 SMB((Server Message Block))協定，或稱為 CIFS((CommonInternet File System))的協定，可讓 MS Windows 主機可以將另一 MS Windows 主機目錄檔案當成是本機上的目錄檔案一般地使用，即所謂的網路芳鄰分享。而這個協定亦可以用於 Internet ，即位於不同網段的 Windows 主機也可使用此協定進行目錄檔案的分享(假如傳送過程中未有其他的網路設備阻擋時)。而其他 OS 像是 FreeBSD, Linux 也有相關 Samba 軟體來使用這項功能。+Please note: The image formatting is the only formatting syntax accepted in link names.
  
-網芳資源可用 [[\\server\share|這樣子]] 來進行連結。另外可參考[[wp>Intranet]]。+The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).
  
-  網芳資源可用 [[\\server\share|這樣子]] 來進行連結。+===== Footnotes =====
  
-千萬要注意:+You can add footnotes ((This is a footnote)) by using double parentheses.
  
-  * 為了系統安全，直接瀏覽「網路芳鄰」功能只限於 Microsoft Internet Explorer 。 +  You can add footnotes ((This is a footnote)) by using double parentheses.
-  * 請注意相關安全問題：鑒於 SMB 協定具有相當的便利性，但設定不夠完善的 Windows 主機(如密碼設定不夠安全或是未設定密碼)常讓外界使用者經此網路芳鄰分享，洩漏區域網路內相關檔案或系統上的機密資訊，甚至讓網路駭客完全控制該部主機。譬如 2001 年中的 Nimda 病毒就是經由網路芳鄰的方式散佈病毒至另一台保護不週的 Windows 主機上，以致造成感染病毒的速度加快。所以經由開放網路芳鄰分享於外界使用者，來增加與其他單位(如所屬機關、外部辦公室或駐外機構)的聯繫方便，同時亦可能形成安全上的漏洞，尤其是對保護不週的 Windows 主機而言。 +
-  * Mozilla和Firefox的使用者，可採用[[http://kb.mozillazine.org/Firefox_:_Issues_:_Links_to_Local_Pages_Don%27t_Work|Mozilla知識庫]]裏提及的不同解決方法，啟用此功能。唯在開啟網路芳鄰時，仍會彈出JavaScript警告。若要為所有使用者去除這個警告，請把下列文字增加至”conf/userscript.js”中：+
  
-  $lang['js']['nosmblinks'] = '';+===== Sectioning =====
  
-==== 圖片連結 ====+You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document.
  
-也可透過使用圖片來連到wiki內部的頁面，或者其他的 URL ，比如:+==== Headline Level 3 ==== 
 +=== Headline Level 4 === 
 +== Headline Level 5 ==
  
-  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+  ==== Headline Level 3 ==== 
 +  === Headline Level 4 === 
 +  == Headline Level 5 ==
  
-[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]+By using four or more dashes, you can make a horizontal line:
  
-注意：在%%[[%%網址%%|%%連結名稱%%]]%%的「連結名稱」處，若用「%%{{%%%%}}%%」的話，則只能輸入圖檔名稱。+----
  
-DokuWiki支援完整的圖像和連結語法，包括圖像大小調整、內部和外部的圖像與連結，以及wiki內連結。+===== Media Files =====
  
-===== 註解 =====+You can include external and internal [[doku>images|images, videos and audio files]] with curly brackets. Optionally you can specify the size of them.
  
-您可以任意增加註解 ((這是示範註解)) ，怎麼用呢？ +Real size:                        {{wiki:dokuwiki-128.png}}
-把要註解的文字用兩組括號類似包水餃一樣包起來就好囉。 +
-而註解的編號管理，請別擔心，DokuWiki 會自動幫您弄好。:-)+
  
-  您可以任意增加註解 ((這是示範註解)) ，怎麼用呢？ +Resize to given width:            {{wiki:dokuwiki-128.png?50}}
-  把要註解的文字用兩組括號類似包水餃一樣包起來就好囉。+
  
-===== 目錄的層次結構 ===== +Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}}
-一個層次分明的內容，加上有條不絮的說明文字，似乎總是最能令人消化吸收的。+
  
-我們可以透過設定最多至五種不同層次的標題，來完成目錄表的自動建構。 +Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
-若該頁內有至少三個層次的標題，那麼 DOKUWIKI 就會自動產生相對應的目錄表(table of contents, TOC)。 +
-不過若不想要「目錄表」的話，那麼只要在文章開頭打入%%~~NOTOC~~%%即可。+
  
-標題是在左右各以等號「=」標示， +  Real size:                        {{wiki:dokuwiki-128.png}} 
-從「%%==%%」到「%%======%%」，每多一個等號，則分別代表更高層次的標題。+  Resize to given width:            {{wiki:dokuwiki-128.png?50}} 
 +  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}} 
 +  Resized external image:           {{https://www.php.net/images/php.gif?200x50}}
  
-「%%======%%」有六個等號，是「第一級標題層次」， 
-而本節目前是「%%===== 目錄的節次結構 =====%%」，也就是「第二級標題層次」 
  
 +By using left or right whitespaces you can choose the alignment.
  
-==== 第三級標題層次 ==== +{{ wiki:dokuwiki-128.png}}
-=== 第四級標題層次 === +
-== 第五級標題層次 ==+
  
-  ==== 第三級標題層次 ==== +{{wiki:dokuwiki-128.png }}
-  === 第四級標題層次 === +
-  == 第五級標題層次 ==+
  
-而連續四個短折號「-」(dash)所組成的 %%----%% 即可產生水平線。 +{{ wiki:dokuwiki-128.png }}
-舉例： +
-　　　　↓ +
-----+
  
-===== 各種貼圖方式 =====+  {{ wiki:dokuwiki-128.png}} 
 +  {{wiki:dokuwiki-128.png }} 
 +  {{ wiki:dokuwiki-128.png }}
  
-=== 貼圖語法 === +Of course, you can add a title (displayed as a tooltip by most browsers), too.
-可以用兩組重疊的 %%{{}}%% 花括號來貼圖或檔案，詳情請見 [[doku>images]]。 +
-也可以在編輯時用工具列的按鈕來完成。+
  
-此外，還可指定圖檔的顯示大小。+{{ wiki:dokuwiki-128.png |This is the caption}}
  
-實際大小:             {{wiki:dokuwiki-128.png}}+  {{ wiki:dokuwiki-128.png |This is the caption}}
  
-縮放為自訂的寬度(50 pixel): {{wiki:dokuwiki-128.png?50}}+For linking an image to another page see [[#Image Links]] above.
  
-縮放為自訂的大小(200x50)((若指定的長寬比與圖片本身不一致，在調整圖片大小前，它將被裁剪到新的比例)):  {{wiki:dokuwiki-128.png?200x50}}+==== Supported Media Formats ====
  
-縮放以URL連結的影像(100x100): {{http://de3.php.net/images/php.gif?100x100}}+DokuWiki can embed the following media formats directly.
  
-  實際大小:             {{wiki:dokuwiki-128.png}} +| Image | ''gif'', ''jpg'', ''png''  | 
-  縮放為自訂的寬度(50 pixel): {{wiki:dokuwiki-128.png?50}} +| Video | ''webm'', ''ogv'', ''mp4'' | 
-  縮放為自訂的大小(200x50):  {{wiki:dokuwiki-128.png?200x50}} +| Audio | ''ogg'', ''mp3'', ''wav''  | 
-  縮放以URL連結的影像(100x100): {{http://de3.php.net/images/php.gif?100x100}}+| Flash | ''swf''                    |
  
-=== 圖檔位置的搭配變化 === +If you specify a filename that is not a supported media format, then it will be displayed as a link instead.
-也可運用 %%{{圖檔檔名}}%% 在括號與檔名之間插入空白的變化，來指定要放左、右或中間。+
  
-== 圖檔變化說明舉例 1 == +By adding ''?linkonly'' you provide a link to the media without displaying it inline
-{{ wiki:dokuwiki-128.png}}+
  
-  {{ wiki:dokuwiki-128.png}} +  {{wiki:dokuwiki-128.png?linkonly}}
-  這張會出現在右邊，注意到了嗎？ +
-  檔名跟左邊的括號隔了一個空白唷~ +
-  這代表靠右放 +
-  換言之， +
-  很簡單就可以把圖片靠右放置，對吧？+
  
-== 圖檔變化說明舉例 2 == +{{wiki:dokuwiki-128.png?linkonly}} This is just a link to the image.
-{{wiki:dokuwiki-128.png }}+
  
-  {{wiki:dokuwiki-128.png }} +==== Fallback Formats ====
-  這張會出現在左邊，注意到了嗎？ +
-  檔名跟右邊的括號隔了一個空白唷~ +
-  這代表靠左放 +
-  換言之， +
-  很簡單就可以把圖片靠左放置，對吧？+
  
-== 圖檔變化說明舉例 3 == +Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility.
-{{ wiki:dokuwiki-128.png }}+
  
-  {{ wiki:dokuwiki-128.png }} +For example consider this embedded mp4 video:
-  這張會出現在中間，注意到了嗎？ +
-  檔名跟左右兩邊的括號都隔了一個空白唷~ +
-  這代表往中間放 +
-  換言之， +
-  很簡單就可以把圖片居中放置，對吧？+
  
-=== 幫圖片加上說明 === +  {{video.mp4|A funny video}}
-當然還可在圖片上加上「說明文字(title)」(在多數的瀏覽器上，滑鼠移到該圖上則會顯示)。+
  
-{{ wiki:dokuwiki-128.png |這是該圖的說明}}+When you upload a ''video.webm'' and ''video.ogv'' next to the referenced ''video.mp4'', DokuWiki will automatically add them as alternatives so that one of the three files is understood by your browser.
  
-  {{ wiki:dokuwiki-128.png |這是該圖的說明}}+Additionally DokuWiki supports a "poster" image which will be shown before the video has started. That image needs to have the same filename as the video and be either a jpg or png file. In the example above a ''video.jpg'' file would work.
  
-若您所指定的檔案(無論是內部連結或外部URL)並不是圖檔(''gif,jpeg,png這三種圖檔類型'')，那麼「這是該圖的說明」那段文字會被顯示出來而當作連結，效果等同 HTML 中的 <img alt="這是該圖的說明" >。 +===== Lists =====
-===== 項目表 =====+
  
-DokuWiki 可使用項目表有兩種型態：數字及符號表。 +Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.
-要建立項目表的話，在該行前面先空出兩格，然後加上 ''*'' 即可產生符號項目表， +
-或者改用 ''-'' 的話則會產生數字項目表。+
  
-  *這是項目表 +  * This is a list 
-    * 然而 +  * The second item 
-      * 也可以用不同層次的項目表來表達 +    * You may have different levels 
-        * 其他+  * Another item
  
-  - 這也一樣是項目表，不過前面會加上編號 +  - The same list but ordered 
-    - 第二項 +  - Another item 
-      - 只要在 ''-'' 或 ''*'' 前面多加空白，就會內縮為更深(細微)的層次了。 +    - Just use indention for deeper levels 
-        - 第三項 +  - That's it
- +
-  - 空行，則會結束列表，重新起算編號。+
  
 <code> <code>
-  *這是項目表 +  * This is a list 
-    * 然而 +  * The second item 
-      * 也可以用不同層次的項目表來表達 +    * You may have different levels 
-        * 其他 +  * Another item
- +
-  - 這也一樣是項目表，不過前面會加上編號 +
-    - 第二項 +
-      - 只要在 ''-'' 或 ''*'' 前面多加空白，就會內縮為更深(細微)的層次了。 +
-        - 第三項+
  
-  - 空行，則會結束列表，重新起算編號。+  - The same list but ordered 
 +  - Another item 
 +    - Just use indention for deeper levels 
 +  - That's it
 </code> </code>
-===== 文本轉換 ===== 
  
-DokuWiki可以將預定義的字符或者字符串轉換成圖片、其他文本或HTML。+Also take a look at the [[doku>faq:lists|FAQ on list items]].
  
-文本到圖片的轉換，主要用作表情符號。文本到HTML的轉換，多用於顯示符號替換，但也可以配置為使用其他HTML。+===== Text Conversions =====
  
-==== 表情符號 ====+DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML.
  
-DokuWiki 支援 [[wp>emoticon]] 普遍常用的表情符號。表情符號圖檔都被放在 ''smiley'' 目錄內， +The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, but can be configured to use other HTML as well.
-並且可以用 ''conf 目錄下的 smileys.conf'' 檔案來做更多的設定， +
-以下是目前 DokuWiki 所內建的表情符號表。+
  
-^原始寫法^表情符號^ +==== Text to Image Conversions ====
-|%%8-)%%|8-)| +
-|%%8-O%%|8-O| +
-|%%:-(%%|:-(| +
-|%%:-)%%|:-)| +
-|%%=)%%|=)| +
-|%%:-/%%|:-/| +
-|%%:-\%%|:-\| +
-|%%:-?%%|:-?| +
-|%%:-D%%|:-D| +
-|%%:-P%%|:-P| +
-|%%:-O%%|:-O| +
-|%%:-X%%|:-X| +
-|%%:-|%%|:-|| +
-|%%;-)%%|;-)| +
-|%%:?:%%|:?:| +
-|%%:!:%%|:!:| +
-|%%LOL%%|LOL| +
-|%%FIXME%%|FIXME| +
-|%%DELETEME%%|DELETEME| +
-好用嗎？多介紹一個：「%%^_^%%」，它是很熟悉的笑臉：^_^。+
  
-==== 顯示符號 ====+DokuWiki converts commonly used [[wp>emoticon]]s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:
  
-^原始寫法^輸出的顯示符號(或結果)^ +  * 8-) %%  8-)  %% 
-|%%->%%|->| +  * 8-O %%  8-O  %% 
-|%%<-%%|<-| +  * :-( %%  :-(  %% 
-|%%<->%%|<->| +  * :-) %%  :-)  %% 
-|%%=>%%|=>| +  * =)  %%  =)   %% 
-|%%<=%%|<=| +  * :-/ %%  :-/  %% 
-|%%<=>%%|<=>| +  * :-\ %%  :-\  %% 
-|%%>>%%|>>| +  * :-? %%  :-?  %% 
-|%%<<%%|<<| +  * :-D %%  :-D  %% 
-|%%--%%|--| +  * :-P %%  :-P  %% 
-|%%---%%|---| +  * :-O %%  :-O  %% 
-|%%640x480%%|640x480| +  * :-X %%  :-X  %% 
-|%%(c)%%|(c)| +  * :-| %%  :-|  %% 
-|%%(tm)%%|(tm)| +  * ;-) %%  ;-)  %% 
-|%%(r)%%|(r)| +  * ^_^ %%  ^_^  %% 
-|%%"He thought 'It's a man's world'..."%%|"He thought 'It's a man's world'..."|+  * m(  %%  m(   %% 
 +  * :?: %%  :?:  %% 
 +  * :!: %%  :!:  %% 
 +  * LOL %%  LOL  %% 
 +  * FIXME %%  FIXME %% 
 +  * DELETEME %% DELETEME %%
  
-注意: 若您不想要這項功能的話，可以在[[config|設定選項]]中關閉。+==== Text to HTML Conversions ====
  
-您可以到[[doku>entities|模式文件]]裏添加顯示符號之轉換。+Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.
  
-然而，上述例子中，有三個符號並非來自模式文件。它們是：乘號(640×480)、單引號( 'Miku' )和雙引號( ”Miku” )。您可到[[doku>config:typography|設定選項]]裏關閉之。+-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
 +"He thought 'It's a man's world'..."
  
-===== 層次標示 =====+<code> 
 +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
 +"He thought 'It's a man's world'..." 
 +</code>
  
-有時候（特別是討論時）您想把某些文字（尤為各次的回覆）標示作不同的層次，您可以使用下列的語法：+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
  
-  我想我們應該這麼做 +There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]].
-   +
-  > 不，我們不該。 +
-   +
-  >> 嗯，我想我們應該。 +
-   +
-  > 真的嗎？ +
-   +
-  >> 當然！ +
-   +
-  >>> 那就做吧！+
  
-我想我們應該這麼做+===== Quoting =====
  
-> 不，我們不該。+Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
  
->> 嗯，我想我們應該。+<code> 
 +I think we should do it
  
-> 真的嗎？+> No we shouldn't
  
->> 當然！+>> Well, I say we should
  
->>> 那就做吧！+> Really?
  
-===== 表格 =====+>> Yes!
  
-DokuWiki建立表格的方式很簡單：+>>> Then lets do it! 
 +</code>
  
-^ 標題1        ^ 標題2         ^ 標題3        ^ +I think we should do it
-| (1,1)        | (1,2)         | (1,3)        | +
-| (2,1)        | 水平合併示範（注意兩條豎線）|| +
-| (3,1)        | (3,2)         | (3,3)        |+
  
-以「<nowiki>|</nowiki>」開始與結束的是「普通欄位」，而「<nowiki>^</nowiki>」則是「標題欄位」。+> No we shouldn't
  
-  ^ 標題1        ^ 標題2         ^ 標題3        ^ +>> Well, I say we should
-  | (1,1)        | (1,2)         | (1,3)        | +
-  | (2,1)        | 水平合併示範（注意兩條豎線）|| +
-  | (3,1)        | (3,2)         | (3,3)        |+
  
-要水平合併兩格或多格，只要把後方的設置為空即可，如上面所示。請確保每行都有相同數量的分隔符。+> Really?
  
-標題也可用於「垂直欄位」上：+>> Yes!
  
-|          ^ 標題1          ^ 標題2          ^ +>>> Then lets do it!
-^ 標題3    | (1,2)          | (1,3)          | +
-^ 標題4    | 這次不再合併了 |                | +
-^ 標題5    | (2,2)          | (2,3)          |+
  
-方法就是直接在「標題3、4、5」前面加上「<nowiki>^</nowiki>」即可。+===== Tables =====
  
-  |          ^ 標題1          ^ 標題2          ^ +DokuWiki supports a simple syntax to create tables.
-  ^ 標題3    | (1,2)          | (1,3)          | +
-  ^ 標題4    | 這次不再合併了 |                | +
-  ^ 標題5    | (2,2)          | (2,3)          |+
  
-您也可以垂直合併兩格或多格。只要在下面的格內輸入「<nowiki>:::</nowiki>」即可。+^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
 +| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
 +| Row 2 Col 1    | some colspan (note the double pipe) || 
 +| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
  
-^ 標題1 ^ 標題2             ^ 標題3 ^ +Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.
-|(1,1)| 這次示範垂直合併    |(1,3)| +
-|(2,1)| :::                 |(2,3)| +
-|(3,1)| :::                 |(2,3)|+
  
-除跨行合併語法「<nowiki>:::</nowiki>」外，單元格中不能包含其他內容。+  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^ 
 +  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        | 
 +  | Row 2 Col 1    | some colspan (note the double pipe) || 
 +  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
  
-  ^ 標題1 ^ 標題2             ^ 標題3 ^ +To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!
-  |(1,1)| 這次示範垂直合併    |(1,3)| +
-  |(2,1)| :::                 |(2,3)| +
-  |(3,1)| :::                 |(2,3)|+
  
-您還可以對齊表格的文字。只要在文本的相反方向添加至少兩個半型空格：如果要靠右對齊，在左邊添加兩個半型空格；反之，則在右邊添加。在兩邊均添加空格，即可以居中對齊。+Vertical tableheaders are possible, too.
  
-^           對齊了的表格                   ^^^ +|              ^ Heading 1            ^ Heading 2          ^ 
-|      靠右對齊|   居中對齊   |靠左對齊      | +^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
-|靠左對齊      |      靠右對齊|   居中對齊   |+^ Heading 4    | no colspan this time |                    | 
 +^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        | 
 + 
 +As you can see, it's the cell separator before a cell which decides about the formatting: 
 + 
 +  |              ^ Heading 1            ^ Heading 2          ^ 
 +  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        | 
 +  ^ Heading 4    | no colspan this time |                    | 
 +  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        | 
 + 
 +You can have rowspans (vertically connected cells) by adding ''%%:::%%'' into the cells below the one to which they should connect. 
 + 
 +^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +| Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +| Row 3 Col 1    | :::                        | Row 2 Col 3        | 
 + 
 +Apart from the rowspan syntax those cells should not contain anything else. 
 + 
 +  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^ 
 +  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        | 
 +  | Row 2 Col 1    | :::                        | Row 2 Col 3        | 
 +  | Row 3 Col 1    | :::                        | Row 2 Col 3        | 
 + 
 +You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. 
 + 
 +^           Table with alignment           ^^^ 
 +|         right|    center    |left          | 
 +|left          |         right|    center    |
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-下面是源文件中的樣子：+This is how it looks in the source:
  
-  ^           對齊了的表格                   ^^^ +  ^           Table with alignment           ^^^ 
-  |      靠右對齊|   居中對齊   |靠左對齊      | +  |         right|    center    |left          | 
-  |靠左對齊      |      靠右對齊|   居中對齊   |+  |left          |         right|    center    |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-注意：不支援垂直對齊。+Note: Vertical alignment is not supported.
  
-===== 無格式化 =====+===== No Formatting =====
  
-若有一段文字，您不要它作格式化處理，要顯示作原來的樣子，請用「%%<nowiki></nowiki>%%」標籤包圍這個區域。您也可以使用兩個百分號「<nowiki>%%</nowiki>」。+If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.
  
-<nowiki>正如本段示範裏，本來包含了網址：http://www.splitbrain.org，以及**加上格式的文字**，但它沒有給格式化。連表情符號;-)的轉換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki>+<nowiki> 
 +This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. 
 +</nowiki> 
 +The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-  <nowiki>正如本段示範裏，本來包含了網址：http://www.splitbrain.org， +  <nowiki> 
-  以及**加上格式的文字**，但它沒有給格式化。 +  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. 
-  連表情符號;-)的轉換，也與//__加上格式的文字__//一樣，全都失效了。</nowiki>+  </nowiki> 
 +  The same is true for %%//__this__ text// with a smiley ;-)%%.
  
-===== 代碼區塊 =====+===== Code Blocks =====
  
-在文字每一行的前方加上兩個半型空格，可使該段文字以「文字方塊」方式顯示出來。在文字方塊裏，所有文字都會無格式化。您也可以用 「%%<code></code>%%」或「%%<file></file>%%」這兩個標籤去做到相同效果。+You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''%%<code>%%'' or ''%%<file>%%''.
  
-  這是前方加上了兩個半型空格的文字。 +  This is text is indented by two spaces.
-  即使有**甚麼格式**標示了，它都不會[[格式化]]。+
  
 <code> <code>
-這是沒有格式化的代碼，所有空格都保留下來。就像              <-這樣+This is preformatted code all spaces are preserved: like              <-this
 </code> </code>
  
 <file> <file>
-這段也非常相似，但 +This is pretty much the same, but you could use it to show that you quoted a file.
-您可以用它來表明 +
-     您正在引述(Quote)別人的言論。+
 </file> </file>
  
-這些區塊由下面的源碼產生出來：+Those blocks were created by this source:
  
-    這是前方加上了兩個半型空格的文字。 +    This is text is indented by two spaces.
-    即使有**甚麼格式**標示了，它都不會[[格式化]]。+
  
   <code>   <code>
-  這是沒有格式化的代碼，所有空格都保留下來。就像              <-這樣+  This is preformatted code all spaces are preserved: like              <-this
   </code>   </code>
  
   <file>   <file>
-  這段也非常相似，但 +  This is pretty much the same, but you could use it to show that you quoted a file.
-  您可以用它來表明 +
-       您正在引述(Quote)別人的言論。+
   </file>   </file>
  
-===== 語法的高亮顯示 =====+==== Syntax Highlighting ====
  
-DokuWiki可把原始碼語法以高亮模式顯示，使它更易閱讀。它使用GeSHi通用語法高亮器，只要是GeSHi支援的，DokuWiki也支援。用法就類似前例的「%%<code>%%」標籤，不過您要在標籤內指定該原始碼所使用的語言。例如是「%%<code java>%%」或「%%<file java>%%」。示範如下：+[[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag, e.g. ''<nowiki><code java></nowiki>'' or ''<nowiki><file java></nowiki>''.
  
 <code java> <code java>
- +/**
-/** +
  * The HelloWorldApp class implements an application that  * The HelloWorldApp class implements an application that
  * simply displays "Hello World!" to the standard output.  * simply displays "Hello World!" to the standard output.
  */  */
- 
 class HelloWorldApp { class HelloWorldApp {
- 
     public static void main(String[] args) {     public static void main(String[] args) {
         System.out.println("Hello World!"); //Display the string.         System.out.println("Hello World!"); //Display the string.
行 496: 行 418:
 </code> </code>
  
-目前支援的語言有： //4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80//+The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// 
 + 
 +There are additional [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers.
  
-==== 可下載的代碼區塊 ====+==== Downloadable Code Blocks ====
  
-若您使用上述的「%%<code>%%」或「%%<file>%%」語法，您或許希望讓瀏覽者直接下載該段代碼。您可以在語言代碼後方指定一個文件名，方便瀏覽者下載：+When you use the ''%%<code>%%'' or ''%%<file>%%'' syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this:
  
 <code> <code>
行 512: 行 436:
 </file> </file>
  
-若您不想把語法高亮顯示出，但想方便瀏覽者下載，您可以用破折號「-」作語言代碼。例如：「%%<code - myfile.foo>%%」。+If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%<code - myfile.foo>%%''.
  
 +===== RSS/ATOM Feed Aggregation =====
 +[[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http://simplepie.org/|SimplePie]] is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:
  
-===== 在內容中嵌入 HTML 或 PHP 語法 =====+^ Parameter  ^ Description ^ 
 +| any number | will be used as maximum number items to show, defaults to 8 | 
 +| reverse    | display the last items in the feed first | 
 +| author     | show item authors names | 
 +| date       | show item dates | 
 +| description| show the item description. All HTML tags will be stripped | 
 +| nosort     | do not sort the items in the feed | 
 +| //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). |
  
-可以在文件裏透過加入 ''%%<%%html%%>%%'' or ''%%<%%php%%>%%'' 標籤來使用 HTML 或 PHP，比如:+The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki:DokuWiki]] will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells [[wiki:DokuWiki]] to re-render the page if it is more than //refresh period// since the page was last rendered.
  
-<html> +By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the ''reverse'' parameter, or display the feed as is with ''nosort''.
-這是一段用 <font color="red" size="+1">HTML 寫的紅色字(size=+1)</font> +
-</html>+
  
-<code> +**Example:**
-<html> +
-這是一段用 <font color="red" size="+1">HTML 寫的紅色字(size=+1)</font> +
-</html> +
-</code>+
  
-<php> +  {{rss>http://slashdot.org/index.rss 5 author date 1h }}
-echo '由 PHP 所產生的 Logo:'; +
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?= +
-                ' . php_logo_guid() . '"  +
-       alt="PHP Logo !" />'; +
-</php>+
  
-<code> +{{rss>http://slashdot.org/index.rss 5 author date 1h }}
-<php> +
-echo '由 PHP 所產生的 Logo:'; +
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?= +
-                ' . php_logo_guid() . '"  +
-       alt="PHP Logo !" />'; +
-</php> +
-</code>+
  
  
 +===== Control Macros =====
  
-**請特別注意**: HTML 及 PHP 語法可以在[[config|設定選項]]中決定支援與否。若您的 DOKUWIKI 設定不打開這兩項功能(可單獨打開兩者之一功能)那麼上面的例子就不會被執行，而是直接顯示出來原始寫法。 +Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:
- +
-**譯者建議**: HTML支援可以開啟，但不要開 PHP 支援，這會使有心人對您的 WIKI 系統甚至主機造成危險。 +
---- 譯者：//[[[email protected]|淡]] 2004/12/18 06:03// +
- +
-===== RSS/ATOM Feed聚合 ===== +
- +
-DokuWiki能從外部XML feed中聚合數據。為分析這些XML feed，DokuWiki使用了[[http://simplepie.org/|SimplePie]]。凡是SimplePie能理解的格式，都可用於DokuWiki中。您可以更改不同的參數，以改變其渲染。參數之間請用空格隔開： +
- +
-^ 參數  ^ 描述 ^ +
-| any number | 最多顯示多少項內容；預設值是8。 | +
-| reverse    | 將最新條目顯示在前面。 | +
-| author     | 顯示條目的作者名字。 | +
-| date       | 顯示條目數據。 | +
-| description| 顯示條目的描述；如果[[doku>config:htmlok|HTML]]被禁用，所有標籤將被過濾掉 | +
-| //n//[dhm] | 刷新周期，其中，d=日數，h=小時數，m=分。例如，12h=12小時。 | +
- +
-預設的刷新周期是4小時。小於10分鐘者亦視為10分鐘。DokuWiki通常會提供頁面的暫存版，但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴DokuWiki：若對上一次渲染時間已經過了//刷新周期//，就要重新渲染頁面。 +
- +
-**範例:** +
- +
-  {{rss>http://slashdot.org/index.rss 5 author date 1h }} +
- +
-{{rss>http://slashdot.org/index.rss 5 author date 1h }} +
  
-===== 控制巨集 =====+^ Macro           ^ Description | 
 +| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created | 
 +| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
  
-有些語法會影響DokuWiki對頁面的渲染，而自身不輸出任何內容。可用的控制巨集如下：+===== Syntax Plugins =====
  
-^ 巨集           ^ 描述| +DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:
-| %%~~NOTOC~~%%   | 如果頁面出現該控制巨集，將不會創建目錄。 | +
-| %%~~NOCACHE~~%% | DokuWiki預設會緩存所有的輸出。有時您並不希望這樣（例如您使用了上述的%%<php>%%語法），便可使用這控制巨集，強制DokuWiki在每次訪問時都重新渲染頁面。 |+
  
-===== 語法附加元件 =====+~~INFO:syntaxplugins~~
  
-運用[[doku>plugins|附加元件]]，可以擴充DokuWiki的語法。附加元件的安裝方法，請見其他相應頁面中說明。 
wiki/syntax.1358795922.txt.gz · 上一次變更: 2024/04/04 20:43 -0500 Thu. (13 個月前) (外部編輯)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki