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

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
wiki:syntax [2014/01/02 02:43] – ShingChiwiki:syntax [2024/06/12 10:10] (当前版本) – 外部编辑 127.0.0.1
行 272: 行 272:
 ===== 无格式区块 ===== ===== 无格式区块 =====
  
-您可以在文章中插入无格式区块，在这些区块中Wiki语法将不起作用。可以有三种方法：在行前加两个以上的空格（前面做样例时用的方法），或者可以使用 ''Code'' 或 ''file'' 标记。+在一段文字的最前面加上 2 个空白，来直接作为「文本框」不对它做加工处理(就像前面那些说明一样)。或者也可以用 ''%%<%%code%%>%%'' 或 ''%%<%%file%%>%%'' 这两个标签(tag)都可以达到类似效果。
  
 <code> <code>
-这是一段被code包围的区块，其中的空格都被保留了：像              <-这样+这段是用 <code> 产生的，所有空格及所有原始格式都会照样显示，还其本色。 
 + 就像       <-这个 
 + 
 +或者 
 +    方与圆  似刚与柔 
 +    圆契合于方 
 +    方契合于圆 
 +    两心同一点
 </code> </code>
  
 <file> <file>
-和code是类似的。不过您可以用这个来表示您引用了一个文件的内容。  +这段跟上段很像，但是改用 <file> ，可以把它用在「引述名言(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'' 标签包围整个区块，或者也可以简单地使用双百分号标记 ''<nowiki>%%</nowiki>''。+若要略过某段内含 WIKI 语法，不对该段文字作任何处理， 
 +可以使用 ''%%<%%nowiki%%>%%'' 标签或更简单一点用 2 个 ''<nowiki>%%</nowiki>'' 放在该段文字的前后，请参考下面例子： 
 + 
 + ''%%<%%nowiki%%>%%''<nowiki>这段字不要用 [[WIKI]] 语法</nowiki>''%%<%%/nowiki%%>%%''  
 +或是''<nowiki>%%</nowiki>''%%这段字不要用 [[WIKI]] 语法%%''<nowiki>%%</nowiki>''
  
 <nowiki> <nowiki>
-这是一段完全没有Wiki语法解释的文字，例如：http://www.splitbrain.org ， **粗体**，虽然按照语法书写，但是它们并没有被解释。+这一段包含一些原本会在 WIKI 内有特殊处理，像是 http://www.splitbrain.org 及 **强调语气的文字** ，但是正如所看到的，这里什么都不做任何处理。
 </nowiki> </nowiki>
  
-如何使用这些标记，请查看这一段的源文件。+您可以看本页的原始写法来察看这一段是怎么写的。
  
 +===== 语法的高亮度显示 =====
  
-===== 语法 ===== +[[DokuWiki]] 可把原始码语法来做高亮度显示(Syntax Highlighting)，来更加具可读性。 
- +它采用的是 [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter —— 所以只要 GeSHi 有支持的，DokuWiki 亦可。 
-[[DokuWiki]] 可以将源代码作语法高亮以增加可读性。它使用称作 [[http://qbnz.com/highlighter/|GeSHi]] 的通用语法高亮工具（Generic Syntax Highlighter）——所有被GeSHi支持的语言都可以在DokuWiki中得到高亮。使用code标记的方法和上面是类似的，不过需要指定使用的语言，例如： ''<nowiki><code java></nowiki>''。 +  
 +用法就类似前例的 %%<code>%% ，但要在标签(tag)内指定该原始码所使用的语言。比如 ''<nowiki><code 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.
行 307: 行 333:
 </code> </code>
  
-现在，DokuWiki可以支持的语言有： //actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, objc, oobas, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml//+目前支持的语言有: //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//
  
 +==== 可下载的代码块 ====
  
-===== 嵌入HTML和PHP =====+若您使用上述的「%%<code>%%」或「%%<file>%%」语法，您或許希望让浏览者直接下载该段代码。您可以在语言代码后方指定一個文件名，方便浏览者下载：
  
-您可以使用 ''html'' 或者 ''php''标记在文档中嵌入HTML或PHP的代码。例如： 
 <code> <code>
-<html> +<file php myexample.php> 
-这是 <font color="red" size="+1">HTML</font> 代码。 +<?php echo "hello world!"; ?> 
-</html> +</file>
-</code> +
-<html> +
-这是 <font color="red" size="+1">HTML</font> 代码。 +
-</html> +
-<code> +
-<php> +
-echo '由PHP生成的logo：'; +
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +
-</php>+
 </code> </code>
  
-<php> +<file php myexample.php> 
-echo '由PHP生成的logo：'; +<?php echo "hello world!"; ?> 
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; +</file> 
-</php>+ 
 +若您不想把语法高亮显示出，但想方便浏览者下载，您可以用链接号「-」作语言代码。例如：「%%<code - myfile.foo>%%」。 
 + 
 +===== 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 }} 
 + 
 +===== 控制巨集 ===== 
 + 
 +有些語法會影響DokuWiki對頁面的渲染，而自身不輸出任何內容。可用的控制巨集如下： 
 + 
 +^ 巨集           ^ 描述| 
 +| %%~~NOTOC~~%%   | 如果頁面出現該控制巨集，將不會創建目錄。 | 
 +| %%~~NOCACHE~~%% | DokuWiki預設會緩存所有的輸出。有時您並不希望這樣（例如您使用了上述的%%<php>%%語法），便可使用這控制巨集，強制DokuWiki在每次訪問時都重新渲染頁面。 | 
 + 
 +===== 語法附加元件 ===== 
 + 
 +運用[[doku>zh-tw:plugins|附加元件]]，可以擴充DokuWiki的語法。附加元件的安裝方法，請見其他相應頁面中說明。本wiki系統使用了下列附加元件：
  
-**请注意**： HTML和PHP嵌入的功能默认情况下是被禁用的，因此，您可能无法看到上面的代码运行的结果而只能够看见源代码，这取决于DokuWiki站点的设置。(?)+~~INFO:syntaxplugins~~
打印/导出