差異處

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

--- zh-tw:wiki:syntax [2012-09-03 22:51] – 外部編輯 127.0.0.1
+++ zh-tw:wiki:syntax [2023-09-06 11:02] (目前版本) – [表格] 27.105.113.28
@@ 行 1: / 行 1: @@
-====== Wiki 語法 ======
+====== DokuWiki 語法 ======
-[[DokuWiki]] 支援一些簡單的語法，務求使文檔更易讀。本頁包含了您在編輯頁面時可以使用的語法。點選在頁面頂端或底端的「編修本頁」按鈕，可觀看這一頁的原始檔。如要實驗，請移玉步至[[playground:playground]]。您可以使用[[toolbar|編輯按鈕]]，讓編輯過程更方便。
+[[doku>zh-tw:DokuWiki|DokuWiki]] 支援一些簡單的標記語法，務求使文檔更易讀。本頁包含了所有您在編輯頁面時可以使用的語法。藉著點選「編輯本頁」按鈕，你可以輕鬆的觀看這一頁的原始檔。如要實驗，請移玉步至[[playground:playground]]。您可以使用[[doku>toolbar|編輯按鈕]]，讓編輯過程更方便。
 譯者註：接下來就讓我們花點時間看一下吧，不一定要全懂，**建議**挑有用到、有興趣的先學，有其他問題或想學多點再來看這也可以。
@@ 行 8: / 行 8: @@
 ===== 基本文字格式 =====
+DokuWiki 支援**粗體**, //斜體//, __底線__和''等寬字體''。當然你可以 **__//''結合''//__** 上述所有的.
+  DokuWiki 支援**粗體**, //斜體//, __底線__和''等寬字體''。當然你可以 **__//''結合''//__** 上述所有的效果.
+你也可以使用<sub>下標</sub>和<sup>上標</sup>
+  你也可以使用<sub>下標</sub>和<sup>上標</sup>
+當然你也可以標記某些文字為<del>刪節線</del>
+  當然你也可以標記某些文字為<del>刪節線</del>
 DokuWiki 使用**空行**來區分段落((也就是 XHTML 語法中的 <p></p>))。例如：
@@ 行 31: / 行 43: @@
 您應該只在真正需要使用強制斷行的地方才用強制斷行。
-DokuWiki 支援以下基本語法，並且可以 **__//''組合''//__** 各種效果。
-|說明^原始寫法^輸出效果^
-^粗體|%%**粗體**%%|**粗體**|
-^斜體|%%//斜體//%%|//斜體//|
-^底線|%%__底線__%%|__底線__|
-^定距字體，或稱「等寬」字體((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>|
 ===== 連結 =====
@@ 行 62: / 行 63: @@
 內部連結是用兩組中括號包裹要連結的頁面名稱來產生。
-可以直接用 [[pagename]] 或加上該連結的說明 [[pagename|說明文字]]。
+可以直接用 [[:zh-tw:pagename]] 或加上該連結的說明 [[:zh-tw:pagename|說明文字]]。
 頁面名稱會被自動轉換成小寫英文字，並且不支援特殊符號。
 （中文頁面名稱雖然支援，但在某些部份並不完善，仍建議盡量使用英文頁面名稱 --- //[[reder.tseng@gmail.com|Reder]] 2008/06/05 04:58//）
@@ 行 72: / 行 73: @@
-也可以加上冒號「:」(colon)用來做 [[namespaces]] 的區分而互相連結。
+也可以在頁面名稱前加上冒號「:」(colon)[[some:namespaces]]來使用分類名稱。
-  也可以加上冒號「:」(colon)用來做 [[namespaces]] 的區分而互相連結。
+  也可以在頁面名稱前加上冒號「:」(colon)[[some:namespaces]]來使用分類名稱。
-若想深入瞭解分類空間（namespaces，或稱命名空間）空間請見 [[namespaces|這裏]]。
+若想深入瞭解分類名稱（namespaces，或稱命名空間）空間請見 [[doku>zh-tw:namespaces|這裏]]。
 您也可以直接連結某個頁面的某章節段落。就像 HTML 一樣，只要在該頁後面加上 #某章節 就可以囉。比如：
-這會連到 [[syntax#內部連結|這一節(internal)]]。
+這會連到 [[:zh-tw:syntax#內部連結|這一節(internal)]]。
-  這會連到 [[syntax#internal|這一節(internal)]]。
+  這會連到 [[:syntax#內部連結|這一節(internal)]]。
 請注意:
-  * 連到 [[syntax|已存在的頁面]] 跟 [[nonexisting|不存在的頁面]] 會以不同的方式呈現(看您的 style.css 中的 CSS 設定如何而定)。
+  * 連到 [[:zh-tw:syntax|已存在的頁面]] 跟 [[nonexisting|不存在的頁面]] 會以不同的方式呈現(看您的 style.css 中的 CSS 設定如何而定)。
-  * 符合 [[wp>CamelCase|駝峰文字]] 的詞彙通常在 Wiki 環境內會自動轉換為連結，而 DokuWiki 預設是關閉，如有需要可在[[config|設定選項]]中開啟。
+  * 符合 [[wp>CamelCase|駝峰文字]] 的詞彙通常在 Wiki 環境內會自動轉換為連結，而 DokuWiki 預設是關閉，如有需要可在[[:zh-tw:config|設定選項]]中開啟。
     - 駝峰文字（CamelCase）簡言之就是「幾個英文單字之間緊接著而沒有空格」所組成的詞彙，但每個單字的首字大寫，狀如駝峰([[dict>Camel]])，故名為 CamelCase。
-    - 如果在[[config|設定選項]]中開啟駝峰文字功能的話，那麼在文章內打出駝峰文字（如：DokuWiki）就會自動成為連結了。
+    - 如果在[[:zh-tw:config|設定選項]]中開啟駝峰文字功能的話，那麼在文章內打出駝峰文字（如：DokuWiki）就會自動成為連結了。
   * 若章節所在的頁面標題改變了，那麼其連結也會跟着改變。因此請別過度依賴章節連結功能。
-  * 此外可參考 [[pagename|DokuWiki網站有關 pagename 的說明]] 。
+  * 此外可參考 [[:zh-tw:pagename|DokuWiki網站有關 pagename 的說明]] 。
 ==== Wiki間的互連 ====
-DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。
+DokuWiki支援[[doku>zh-tw:Interwiki|wiki間的互連]]。例如要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。
-  DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如
+  DokuWiki支援[[doku>Interwiki|wiki間的互連]]。例如要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。
-  要連接到英文維基百科的 Wiki 頁，輸入[[wp>Wiki]]即可。
-此外還可運用：
-^原始寫法^出現的結果^說明^
-|%%[[%%google>Wiki%%]]%%|[[google>yahoo]] |請 Google 搜尋大神幫您找有關 Wiki 的網頁|
-|%%[[%%wp>Wiki%%]]%%|[[wp>Wiki]] |連到 Wikipedia(維基百科)的 Wiki 頁|
-|%%[[Meatball>MeatballWiki]]%%|[[Meatball>MeatballWiki]] |連到 MeatBall Wiki 的 MeatballWiki 頁|
-|%%[[phpfn>phpinfo]]%%|[[phpfn>phpinfo]] |到 php 官網看 phpinfo function 的手冊說明|
-|%%[[JspWiki>System.out.println]]%%|[[JspWiki>System.out.println]] |從 JSP Wiki 找 System.out.println 說明|
-|%%[[FreeBSDman>uname]]%%|[[FreeBSDman>uname]] |到 FreeBSD 官網找 uname 的線上說明|
-|%%[[man>passwd]]%%|[[man>passwd]] |到 Linux Qustion 查 passwd 的用法|
-|%%[[rfc>2010]]%%|[[rfc>2010]] |找 RFC #2010 文件|
-|%%[[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，格式如下：
-^捷徑名稱{NAME}^網址{URL}^
-|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」才行。
-而這些圖檔必須是 16x16 像素(pixels) 的 PNG 或 GIF 格式。
 ==== 網路芳鄰分享的連結 ====
@@ 行 254: / 行 226: @@
 若您所指定的檔案(無論是內部連結或外部URL)並不是圖檔(''gif,jpeg,png這三種圖檔類型'')，那麼「這是該圖的說明」那段文字會被顯示出來而當作連結，效果等同 HTML 中的 <img alt="這是該圖的說明" >。
+==== 可內嵌的檔案格式 ====
+DokuWiki 可以直接在網頁內嵌入以下格式
+| Image  | gif, jpg, png   |
+| Video  | webm, ogv, mp4  |
+| Audio  | ogg, mp3, wav   |
+| Flash  | swf             |
+如果連結檔案的副檔名，並非支援格式的話，則會顯示成連結。
+加上 ''?linkonly'' ，就只會顯示連結，而不在網頁上顯示內容。
+  {{wiki:dokuwiki-128.png?linkonly}}
+{{wiki:dokuwiki-128.png?linkonly}} 像是這樣。
+==== 備援檔案格式 ====
+並非所有的瀏覽器都有能力解析上述支援的檔案格式。要排除這個狀況，您可以上傳不同的檔案格式，以滿足各式瀏覽器的能力。
+假設我們有一個 .mp4 檔：
+  {{video.mp4|A funny video}}
+如果另外上傳了 video.webm 及 video.ogv 到與 video.mp4 相同的命名空間的話，DokuWiki會自動將其視為備援，並選擇一個最適合當前使用者瀏覽器的檔案格式。
+此外DokuWiki也支援「封面圖案」。可以在影片播放前，預先顯示指定的圖片。該圖片必須與影片的檔案名稱相同，且圖片要是 JPG 或 PNG 格式，則 video.jpg 即可和同名的影片配對。
 ===== 項目表 =====
@@ 行 476: / 行 476: @@
   </file>
-===== 語法的高亮顯示 =====
+==== 語法的高亮顯示 ====
 DokuWiki可把原始碼語法以高亮模式顯示，使它更易閱讀。它使用GeSHi通用語法高亮器，只要是GeSHi支援的，DokuWiki也支援。用法就類似前例的「%%<code>%%」標籤，不過您要在標籤內指定該原始碼所使用的語言。例如是「%%<code java>%%」或「%%<file java>%%」。示範如下：