差異處

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

--- zh-tw:wiki:syntax [2013-01-06 20:12] – [內部連結] IchirouUchiki
+++ 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>|
 ===== 連結 =====
@@ 行 72: / 行 73: @@
-也可以加上冒號「:」(colon)用來做 [[:zh-tw:namespaces]] (分類名稱) 的區分而互相連結。
+也可以在頁面名稱前加上冒號「:」(colon)[[some:namespaces]]來使用分類名稱。
-  也可以加上冒號「:」(colon)用來做 [[namespaces]] (分類名稱) 的區分而互相連結。
+  也可以在頁面名稱前加上冒號「:」(colon)[[some:namespaces]]來使用分類名稱。
-若想深入瞭解分類名稱（namespaces，或稱命名空間）空間請見 [[:zh-tw:namespaces|這裏]]。
+若想深入瞭解分類名稱（namespaces，或稱命名空間）空間請見 [[doku>zh-tw:namespaces|這裏]]。
 您也可以直接連結某個頁面的某章節段落。就像 HTML 一樣，只要在該頁後面加上 #某章節 就可以囉。比如：
@@ 行 82: / 行 83: @@
 這會連到 [[:zh-tw:syntax#內部連結|這一節(internal)]]。
-  這會連到 [[syntax#internal|這一節(internal)]]。
+  這會連到 [[:syntax#內部連結|這一節(internal)]]。
 請注意:
@@ 行 92: / 行 93: @@
   * 若章節所在的頁面標題改變了，那麼其連結也會跟着改變。因此請別過度依賴章節連結功能。
   * 此外可參考 [[: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 格式。
 ==== 網路芳鄰分享的連結 ====
@@ 行 253: / 行 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 即可和同名的影片配對。
 ===== 項目表 =====
@@ 行 475: / 行 476: @@
   </file>
-===== 語法的高亮顯示 =====
+==== 語法的高亮顯示 ====
 DokuWiki可把原始碼語法以高亮模式顯示，使它更易閱讀。它使用GeSHi通用語法高亮器，只要是GeSHi支援的，DokuWiki也支援。用法就類似前例的「%%<code>%%」標籤，不過您要在標籤內指定該原始碼所使用的語言。例如是「%%<code java>%%」或「%%<file java>%%」。示範如下：