您在这里: Typecho文档站点 » wiki » DokuWiki格式语法说明

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

wiki:syntax [2014/01/02 02:55]
ShingChi 		wiki:syntax [2014/01/02 03:09] (当前版本)
ShingChi
行 157: 行 157:
 如果您指定的文件名（无论是外部的还是内部的）不是一个图像（''​gif,​jpeg,​png''​），那么它将被显示为一个链接。 如果您指定的文件名（无论是外部的还是内部的）不是一个图像（''​gif,​jpeg,​png''​），那么它将被显示为一个链接。
  
-===== 項目表 =====+===== 列表 =====
  
-DokuWiki可使用項目表有兩種型態：數字及符號表。要建立項目表的話，在該行前面先空出兩格，然後加上「%%*%%」即可產生符號項目表。若用「%%-%%」則會產生數字項目表。+Dokuwiki支持带编号或不带编号的列表。要使用列表，在文字前加入两个空格，然后使用''​*''​标志不带编号的列表，用''​-''​标志带编号的列表。
  
-  *這是項目表 +  * 列表 
-    * 然而 +  * 第二项 
-      * 也可以用不同層次的項目表來表達 +    * 下一层 
-        * 其他+  * 第三项
  
-  - 這也一樣是項目表，不過前面會加上編號 +  - 带编号的列表 
-    - 第二項 +  - 第二项 
-      - 只要在 ''​-''​ 或 ''​*''​ 前面多加空白，就會內縮爲更深（細微）的層次了。 +    - 用缩进表示更深的层 
-        - 第三項 +  - 完了
- +
-  - 空行，則會結束列表，重新起算編號。+
  
 <​code>​ <​code>​
-  *這是項目表 +  * 列表 
-    * 然而 +  * 第二项 
-      * 也可以用不同層次的項目表來表達 +    * 下一层 
-        * 其他+  * 第三项
  
-  - 這也一樣是項目表，不過前面會加上編號 +  - 带编号的列表 
-    - 第二項 +  - 第二项 
-      - 只要在 ''​-''​ 或 ''​*''​ 前面多加空白，就會內縮爲更深（細微）的層次了。 +    - 用缩进表示更深的层 
-        - 第三項 +  - 完了
- +
-  - 空行，則會結束列表，重新起算編號。+
 </​code>​ </​code>​
  
-更詳盡的說明，請看[[doku>​faq:​lists|DokuWiki上的FAQ on list items]]。+===== 表情符号 =====
  
-===== 文本轉換 =====+DokuWiki会将一些常用的 ​ [[wp>​emoticon|表情符号]] 转换为图像。除了默认的表情符号以外，您也可以在 ''​smiley'' ​文件夹中放入更多的表情图，然后在 ''​conf/​smileys.conf''​ 中设置它们即可。下面是Dokuwiki包含了的表情图像：
  
-DokuWiki可以將預定義的字符或者字符串轉換成圖片、其他文本或HTML。+  * 8-) %%  8-)  %% 
 +  * 8-O %%  8-O  %% 
 +  * :-( %%  :-(  %% 
 +  * :-) %%  :-)  %% 
 +  * =)  %%  =)   %% 
 +  * :-/ %%  :-/  %% 
 +  * :-\ %%  :-\  %% 
 +  * :-? %%  :-?  %% 
 +  * :-D %%  :-D  %% 
 +  * :-P %%  :-P  %% 
 +  * :-O %%  :-O  %% 
 +  * :-X %%  :-X  %% 
 +  * :-| %%  :-|  %% 
 +  * ;-) %%  ;-)  %% 
 +  * ^_^ %%  ^_^  %% 
 +  * :?: %%  :?:  %% 
 +  * :!: %%  :!:  %% 
 +  * LOL %%  LOL  %% 
 +  * FIXME %%  FIXME %% 
 +  * DELETEME %% DELETEME %%
  
-文本到圖片的轉換，主要用作表情符號。文本到HTML的轉換，多用於顯示符號替換，但也可以配置爲使用其他HTML。+===== 印刷样式 =====
  
-==== 文本到圖片的轉換 ====+[[DokuWiki]]可以将特定字符转换为印刷时所用的样式。下面是可以识别的这类字符的列表：
  
-DokuWiki支援一些[[doku>zh-tw:​Smileys|表情符號]]。表情符號圖片，都收錄於smiley目錄內。您可透過conf目錄下的smileys.conf檔案，來做更多的設定。+-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
 +"He thought '​It'​s a man's world'​..."
  
-Dokuwiki已內建了一些表情符號，例如輸入「%%^_^%%」，就會顯示出大家很熟悉的笑臉：^_^。以下是目前DokuWiki其他內建的表情符號列表： +<​code>​ 
- +-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
-^原始寫法^輸出效果^ +
-|%%8-)%%|8-)| +
-|%%8-O%%|8-O| +
-|%%:​-(%%|:​-(| +
-|%%:​-)%%|:​-)| +
-|%%=)%%|=)| +
-|%%:​-/​%%|:​-/​| +
-|%%:​-\%%|:​-\| +
-|%%:​-?​%%|:​-?​| +
-|%%:​-D%%|:​-D| +
-|%%:​-P%%|:​-P| +
-|%%:​-O%%|:​-O| +
-|%%:​-X%%|:​-X| +
-|%%:​-|%%|:​-|| +
-|%%;​-)%%|;​-)| +
-|%%:?:​%%|:?:​| +
-|%%:​!:​%%|:​!:​| +
-|%%LOL%%|LOL| +
-|%%FIXME%%|FIXME| +
-|%%DELETEME%%|DELETEME| +
- +
-==== 文本到顯示符號的轉換 ==== +
- +
-DokuWiki可將特定字符轉換爲顯示時所用的樣式。以下是部份可識別字符的例子： +
- +
-^原始寫法^輸出效果^ +
-|%%->%%|->| +
-|%%<-%%|<-| +
-|%%<->%%|<​->​| +
-|%%=>%%|=>| +
-|%%<=%%|<=| +
-|%%<=>%%|<=>| +
-|%%>>​%%|>>​| +
-|%%<<%%|<<​| +
-|%%--%%|--| +
-|%%---%%|---| +
-|%%640x480%%|640x480| +
-|%%(c)%%|(c)| +
-|%%(tm)%%|(tm)| +
-|%%(r)%%|(r)| +
- +
-DokuWiki也可以自動辨別英文引號的開關。例如這一句：+
 "He thought '​It'​s a man's world'​..."​ "He thought '​It'​s a man's world'​..."​
-它的原始碼就是： +</code>
- +
-  "He thought '​It'​s a man's world'​..."​ +
- +
-您可以到[[doku>zh-tw:​entities|模式文件]]裏添加顯示符號之轉換。 +
- +
-然而，上述例子中，有三個符號並非來自模式文件。它們是：乘號、英文單引號和英文雙引號。您可到[[doku>​config:​typography|設定選項]]裏關閉之。 +
- +
-===== 層次標示 ===== +
- +
-有時候（特別是討論時）您想把某些文字（尤爲各次的回覆）標示作不同的層次，您可以使用下列的語法： +
- +
-  我想我們應該這麼做 +
-   +
-  > 不，我們不該。 +
-   +
-  >> 嗯，我想我們應該。 +
-   +
-  > 眞的嗎？ +
-   +
-  >> 當然！ +
-   +
-  >>>​ 那就做吧！ +
- +
-那麼，DokuWiki便會顯示成： +
- +
-我想我們應該這麼做 +
- +
-> 不，我們不該。 +
- +
->> 嗯，我想我們應該。 +
- +
-> 眞的嗎？ +
- +
->> 當然！+
  
->>>​ 那就做吧！+请注意：在配置文件中可以禁用这类自动转换。
  
 ===== 表格 ===== ===== 表格 =====
  
-DokuWiki建立表格的方式很簡單：+DokuWiki可以用简单的语法创建表格。 
  
-^ 標題1        ^ 標題2         ​^ ​標題3        ^ +^ 标题1        ^ 标题2         ​^ ​标题3       ​^ 
-| (1,1)        | (1,2)         | (1,3)        | +| (1,1)        | (1,2)         | (1,3)       ​| 
-| (2,1)        | 水平合併示範（注意兩條豎線）|| +| (2,1)        | 展宽的单元格 ​              || 
-| (3,1)        | (3,2)         | (3,3)        |+| (3,1)        | (3,2)         | (3,3)       ​|
  
-以「%%|%%」開始與結束的是「普通欄位」，而「%%^%%」則是「標題欄位」。+表格的每一行都以分隔符 ''​|''​ （普通行）或者 ''​^''​ （标题行）作为开头和结束。
  
-  ^ 標題1 ​       ^ 標題2 ​        ^ 標題3 ​       ^ 
-  | (1,1)        | (1,2)         | (1,3)        | 
-  | (2,1)        | 水平合併示範（注意兩條豎線）|| 
-  | (3,1)        | (3,2)         | (3,3)        | 
  
-要水平合併兩格或多格，只要把後方的設置爲空即可，如上面所示。請確保每行都有相同數量的分隔符。+  ^ 标题1 ​       ^ 标题2 ​        ^ 标题3 ​      ^ 
 +  | (1,1)        | (1,2)         | (1,3)       | 
 +  | (2,1)        | 展宽的单元格 ​              || 
 +  | (3,1)        | (3,2)         | (3,3)       | 
 +要水平合并单元格，只需要将后一个单元格设置为空即可，如上面演示的一样。请确保每一行有相同数量的单元格分隔符！
  
-標題也可用於「垂直欄位」上：+竖直的标题列也是可以实现的：
  
-|          ^ 標題1          ^ 標題2          ^ +|          ^ 标题1          ^ 标题2          ^ 
-^ 標題3    | (1,2)          | (1,3)          | +^ 标题3    | (1,2)          | (1,3)          | 
-^ 標題4    | 這次不再合併了 ​|                | +^ 标题4    | 不再合并单元格 ​|                | 
-^ 標題5    | (2,2)          | (2,3)          |+^ 标题5    | (2,2)          | (2,3)          |
  
-方法就是直接在「標題3、4、5」前面加上「%%^%%」即可。+可以看到，单元格前面的分隔符决定了单元格的格式。
  
-  |          ^ 標題1          ^ 標題2          ^ +  |          ^ 标题1          ^ 标题2          ^ 
-  ^ 標題3    | (1,2)          | (1,3)          | +  ^ 标题3    | (1,2)          | (1,3)          | 
-  ^ 標題4    | 這次不再合併了 ​|                | +  ^ 标题4    | 不再合并单元格 ​|                | 
-  ^ 標題5    | (2,2)          | (2,3)          |+  ^ 标题5    | (2,2)          | (2,3)          |
  
-您也可以垂直合併兩格或多格。只要在下面的格內輸入「%%:::​%%」即可。+注：垂直合并单元格尚未实现。
  
-^ 標題1 ^ 標題2 ​            ^ 標題3 ^ +您可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可：如果需要右对齐，在左边添加两个空格；反之，则在右边添加。在两边均添加空格可以实现中间对齐。
-|(1,1)| 這次示範垂直合併 ​   |(1,3)| +
-|(2,1)| :::                 ​|(2,​3)| +
-|(3,1)| :::                 ​|(2,​3)|+
  
-除跨行合併語法「%%:::​%%」外，單元格中不能包含其他內容。 +^           有对齐的表格 ​                  ^^^ 
- +|        右对齐|     ​居中 ​    ​|左对齐 ​       ​| 
-  ^ 標題1 ^ 標題2 ​            ^ 標題3 ^ +|左对齐 ​       ​|        右对齐|     ​居中 ​    ​|
-  |(1,1)| 這次示範垂直合併 ​   |(1,3)| +
-  |(2,1)| :::                 ​|(2,​3)| +
-  |(3,1)| :::                 ​|(2,​3)| +
- +
-您還可以對齊表格的文字。只要在文本的相反方向添加至少兩個半形空格：如果要靠右對齊，在左邊添加兩個半形空格；反之，則在右邊添加。在兩邊均添加空格，即可以居中對齊。 +
- +
-^           對齊了的表格 ​                  ^^^ +
-|      靠右對齊|   ​居中對齊 ​  |靠左對齊 ​     ​| +
-|靠左對齊 ​     ​|      靠右對齊|   ​居中對齊 ​  |+
 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-下面是源文件中的樣子：+下面是源文件中的格式：
  
-  ^           對齊了的表格 ​                  ^^^ +  ^           有对齐的表格 ​                  ^^^ 
-  |      靠右對齊|   ​居中對齊 ​  |靠左對齊 ​     ​| +  |        右对齐|     ​居中 ​    ​|左对齐 ​       ​| 
-  |靠左對齊 ​     ​|      靠右對齊|   ​居中對齊 ​  |+  |左对齐 ​       ​|        右对齐|     ​居中 ​    ​|
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-注意：不支援垂直對齊。+===== 无格式区块 =====
  
-===== 無格式化 =====+在一段文字的最前面加上 2 个空白，来直接作为「文本框」不对它做加工处理(就像前面那些说明一样)。或者也可以用 ''​%%<​%%code%%>​%%''​ 或 ''​%%<​%%file%%>​%%''​ 这两个标签(tag)都可以达到类似效果。
  
-若有一段文字，您不要它作格式化處理，要顯示作原來的樣子，請用「%%<​nowiki></​nowiki>​%%」標籤包圍這個區域。您也可以使用兩個百分號「<nowiki>​%%</​nowiki>​」。+<​code>​ 
 +这段是用 <​code>​ 产生的，所有空格及所有原始格式都会照样显示，还其本色。 
 + ​就像 ​      <-这个
  
-<​nowiki>​正如本段示範裏，本來包含了網址：http://​www.splitbrain.org，以及**加上格式的文字**，但它沒有給格式化。連表情符號;​-)的轉換，也與//​__加上格式的文字__//​一樣，全都失效了。</​nowiki>​ +或者 
- +    ​方与圆 ​ 似刚与柔 
-  ​<​nowiki>​正如本段示範裏，本來包含了網址：http://​www.splitbrain.org， +    ​圆契合于方 
-  ​以及**加上格式的文字**，但它沒有給格式化。 +    方契合于圆 
-  連表情符號;​-)的轉換，也與//​__加上格式的文字__//​一樣，全都失效了。</​nowiki>​ +    ​两心同一点
- +
-===== 代碼區塊 ===== +
- +
-在文字每一行的前方加上兩個半形空格，可使該段文字以「文字方塊」方式顯示出來。在文字方塊裏，所有文字都會無格式化。您也可以用「%%<​code></​code>​%%」或「%%<​file></​file>​%%」這兩個標籤去做到相同效果。 +
- +
-  這是前方加上了兩個半形空格的文字。 +
-  ​即使有**甚麼格式**標示了，它都不會[[格式化]]。 +
- +
-<​code>​ +
-這是沒有格式化的代碼，所有空格都保留下來。就像 ​             <-這樣+
 </​code>​ </​code>​
  
 <​file>​ <​file>​
-這段也非常相似，但 +这段跟上段很像，但是改用 <​file>​ ，可以把它用在「引述名言(Quote)」效果上。   
-您可以用它來表明 +   
-     ​您正在引述(Quote)別人的言論。+        remember, information is not knowledge,​ 
 +                  knowledge is not wisdom 
 +                  wisdom is not truth 
 +                  truth is not beauty 
 +                  beauty is not love 
 +                  love is not music 
 +                  music is the best 
 +   
 +                                                -- frank zappa
 </​file>​ </​file>​
  
-這些區塊由下面的源碼產生出來：+若要略过某段内含 WIKI 语法，不对该段文字作任何处理， 
 +可以使用 ''​%%<​%%nowiki%%>​%%''​ 标签或更简单一点用 2 个 ''<​nowiki>​%%</​nowiki>''​ 放在该段文字的前后，请参考下面例子：
  
-    這是前方加上了兩個半形空格的文字。 + ''​%%<​%%nowiki%%>​%%''<​nowiki>​这段字不要用 [[WIKI]] 语法</​nowiki>''​%%<​%%/​nowiki%%>​%%'' ​ 
-    ​即使有**甚麼格式**標示了，它都不會[[格式化]]。+或是''<​nowiki>​%%</​nowiki>''​%%这段字不要用 ​[[WIKI]] 语法%%''<​nowiki>​%%</​nowiki>''​
  
-  ​<code> +<nowiki> 
-  ​這是沒有格式化的代碼，所有空格都保留下來。就像 ​             <-這樣 +这一段包含一些原本会在 WIKI 内有特殊处理，像是 http://​www.splitbrain.org 及 **强调语气的文字** ​，但是正如所看到的，这里什么都不做任何处理。 
-  </code>+</nowiki>
  
-  <​file>​ +您可以看本页的原始写法来察看这一段是怎么写的。
-  這段也非常相似，但 +
-  ​您可以用它來表明 +
-       ​您正在引述(Quote)別人的言論。 +
-  </​file>​+
  
-===== 語法的高亮顯示 ===== +===== 语法的高亮度显示 =====
- +
-DokuWiki可把原始碼語法以高亮模式顯示，使它更易閱讀。它使用GeSHi通用語法高亮器，只要是GeSHi支援的，DokuWiki也支援。用法就類似前例的「%%<​code></​code>​%%」標籤，不過您要在標籤內指定該原始碼所使用的語言。例如是「%%<​code java></​code>​%%」或「%%<​file java></​file>​%%」。示範如下：+
  
 +[[DokuWiki]] 可把原始码语法来做高亮度显示(Syntax Highlighting)，来更加具可读性。
 +它采用的是 [[http://​qbnz.com/​highlighter/​|GeSHi]] Generic Syntax Highlighter —— 所以只要 GeSHi 有支持的，DokuWiki 亦可。
 + 
 +用法就类似前例的 %%<​code>​%% ，但要在标签(tag)内指定该原始码所使用的语言。比如 ''<​nowiki><​code java></​nowiki>''​
 +举例：
 <code java> <code java>
  
行 405: 行 333:
 </​code>​ </​code>​
  
-目前支援的語言有： //4cs, 6502acme, 6502kickass,​ 6502tasm, 68000devpac,​ abap, actionscript-french, actionscript,​ actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, ​diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas,​ lotusscript,​ lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief,​ ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender,​ pli, plsql, postgresql, povray, powerbuilder,​ powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, 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, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog,​ whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//+目前支持的语言有: //​actionscript,​ ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, ​html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro,​ xml//
  
-==== 可下載的代碼區塊 ​====+==== 可下载的代码块 ​====
  
-若您使用上述的「%%<​code>​%%」或「%%<​file>​%%」語法，您或許希望讓瀏覽者直接下載該段代碼。您可以在語言代碼後方指定一個文件名，方便瀏覽者下載：+若您使用上述的「%%<​code>​%%」或「%%<​file>​%%」语法，您或許希望让浏览者直接下载该段代码。您可以在语言代码后方指定一個文件名，方便浏览者下载：
  
 <​code>​ <​code>​
行 421: 行 349:
 </​file>​ </​file>​
  
-若您不想把語法高亮顯示出，但想方便瀏覽者下載，您可以用短折號「-」作語言代碼。例如：「%%<​code - myfile.foo>​%%」。 +若您不想把语法高亮显示出，但想方便浏览者下载，您可以用链接号「-」作语言代码。例如：「%%<​code - myfile.foo>​%%」。
- +
-===== 在內容中嵌入HTML或PHP語法 ===== +
- +
-您可以在文件裏加入「''​%%<​%%html%%>​%%''​」或「''​%%<​%%php%%>​%%''​」標籤，來使用HTML或PHP語法，比如:​ +
- +
-<​html>​ +
-這是<​font color="​red"​ size="​+1">​用HTML寫的紅色字(size=+1)</​font>​。 +
-</​html>​ +
- +
-<​code>​ +
-<​html>​ +
-這是<​font color="​red"​ size="​+1">​用HTML寫的紅色字(size=+1)</​font>​。 +
-</​html>​ +
-</​code>​ +
- +
-<​php>​ +
-echo '由 PHP 所產生的 Logo:';​ +
-echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?= +
-                ' . php_logo_guid() . '"​  +
-       ​alt="​PHP Logo !" />';​ +
-</​php>​ +
- +
-<​code>​ +
-<​php>​ +
-echo '由 PHP 所產生的 Logo:';​ +
-echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?= +
-                ' . php_logo_guid() . '"​  +
-       ​alt="​PHP Logo !" />';​ +
-</​php>​ +
-</​code>​ +
- +
-**請特別注意**：您可以在[[doku>​zh-tw:​config|設定選項]]中，選擇是否支援HTML及PHP語法。若您的DokuWiki設定爲不開啟這兩項功能，那麼上面的例子就無法正常顯示，只會直接顯示出來原始寫法。您也可選擇只開啟兩項功能之一。開啟了這兩項功能後，可能會爲有心破壞的人提供機會，對您的wiki系統甚至主機造成危險。+
  
 ===== RSS/ATOM Feed聚合 ===== ===== RSS/ATOM Feed聚合 =====
打印/导出