====== 格式规则 ======

[[wiki:DokuWiki]] 支持一些能尽量地使资料具有较强的可读性的简单的标记语言。这个页面归纳了在你编辑页面时可能使用的所有格式。只要点击页顶或页底的 //编辑本页// 按钮，就可以查看本页的源代码。如果你想尝试编写一些东西，请到 [[playground:playground|playground]] 页面。这种简易的标记语言也可通过 [[doku>wiki:quickbuttons|quickbuttons]] 查看。

===== 文档基础格式 =====

DokuWiki 支持 **加粗**, //斜体//, __下划线__ 和 ''加宽'' 的文本。当然你也可以 **__//''综合使用''//__** 这些格式

  DokuWiki 支持 **加粗**, //斜体//, __下划线__ 和 ''加宽'' 的文本。
  当然你也可以 **__//''综合使用''//__** 这些格式。

你也可以使用 <sub>下标</sub> 和 <sup>上标</sup>。

  你也可以使用 <sub>下标</sub> 和 <sup>上标</sup>。

你也可以用 <del>删除号</del> 进行标记。

  你也可以用 <del>删除号</del> 进行标记。

**段落** 从空白行开始。如果你想不回车便 **另起一行** ，你可以在句末使用两个反斜杠，后面加上一个空格。

这是有换行的一段话\\ 请注意，两个反斜杠只是被认为是一行的结束\\
后面要有\\ 一个空格 \\没有空格就会这样

  这是有换行的一段话\\ 请注意，
  两个反斜杠只是被认为是一行的结束\\
  后面要有\\ 一个空格 \\没有空格就会这样。

如果真的需要的话，你可以这样强制换行。

===== 链接 =====

DokuWiki 支持许多创建链接的方法。

==== 外部链接 ====

外部链接可以被自动识别： http://www.google.com 或者仅仅是 www.google.com —— 你也可以设置链接名： [[http://www.google.com|这个链接指向google]]。像这样的Email地址： <andi@splitbrain.org> 也能被识别。

  DokuWiki 支持许多创建链接的方法。外部链接可以被
  自动识别： http://www.google.com 或者仅仅是 www.google.com —— 你也可以
  设置链接名: [[http://www.google.com|这个链接指向google]]。像这样的
  Email地址： <andi@splitbrain.org> 也能被识别。

==== 内部链接 ====

内部链接用方括号创建。你可以使用 [[doku>wiki:页面名]] 或者使用 [[doku>wiki:页面名|页面标题]]。Wiki的页面名称会自动转为小写体，但不支持特殊字符。

  内部链接用方括号创建。你可以使用
   [[doku>wiki:页面名]] 或者使用 [[doku>wiki:页面名|页面标题]]。Wiki的页面名称
  会自动转为小写提，但不支持特殊字符

你可以在这个页面使用一个冒号表示 [[wiki:命名空间]] 。

  你可以在这个页面使用一个冒号表示 [[wiki:命名空间]] 。

命名空间的详细说明请看 [[doku>wiki:namespaces]]。

也可以创建指向某一小节的链接。只需如HTML语言一样在#号后面写上小节名称。这个链接指向 [[syntax#内部链接|这一小节]]。

  这个链接指向 [[syntax#内部链接|这一小节]].

注意：

  * 指向 [[wiki:syntax|存在的页面]] 的链接与 [[wiki:不存在的页面]] 的表现方式不同。
  * DokuWiki 不使用 [[wp>骆驼拼写法]] 来创建链接，但是可以通过 [[doku>config]] 来启用这种拼写方式。注意：如果 DokuWiki 是一个链接，那么这是允许的。
  * 当一个小节的标题改变时，它的书签也需要改变。所以不能太过于依赖书签。

==== 跨Wiki链接 ====

DokuWiki支持 [[doku>wiki:interwiki|跨Wiki链接]] 。这些链接可以迅速的连向其它的Wiki。比如，这是一个连向 Wikipedia's 的关于Wiki的链接： [[wp>Wiki]]。

  DokuWiki支持 [[doku>wiki:interwiki|跨Wiki链接]] 。这些链接可以迅速的连向其它的Wiki。
  比如，这是一个连向 Wikipedia 的关于Wiki的链接： [[wp>Wiki]]。

==== 共享 ====

像 [[\\server\share|这样]] 的共享也能被识别。请注意，这只在像公司的 [[wp>Intranet]] 这样的同性质用户组里才能生效。

  像 [[\\server\share|这样]] 的共享也能被识别。

注意：

  * 因为安全原因，对共享的直接浏览只能通过Microsoft Internet Explorer进行（仅在“本地区域”）。
  * 对于Mozilla和Firefox浏览器，可以通过 [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] 的设置开启，不过不建议这样做。
  * 点击 [[bug>151]] 查看更多信息。

==== 图片链接 ====

你也可以通过综合运用常规链接和 [[#images_and_other_files|片句法]] 规则来建立通往内部或者外部页面的图片链接（如下）：

  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

请注意：图片句法是链接名中唯一允许的句法格式。

DokuWiki支持 [[#图片和其他文件|图片句法]] 和 [[#链接|链接]] 格式（包括图片大小调整，内部和外部图片，超链接以及跨Wiki链接）。

===== 脚注 =====

你可以通过双括号加入脚注 ((这是脚注)) 。

  你可以通过双括号加入脚注 ((这是脚注)) 。

===== 小节 =====

你可以使用五种不同级别的标题来构建你的文章。如果你有三个以上的标题，就会自动生成列表——这可以通过在文档种加入 ''<nowiki>~~NOTOC~~</nowiki>'' 字符串来取消。

==== 三级标题 ====
=== 四级标题 ===
== 五级标题 ==

  ==== 三级标题 ====
  === 四级标题 ===
  == 五级标题 ==

使用四个以上的破折号，你可以创建一条分割线：

----

===== 图片和其他文件 =====

你可以通过花括号显示 [[doku>images]] 。你还可以设定图片的尺寸。

实际尺寸：                        {{wiki:dokuwiki-128.png}}

重设宽度：                        {{wiki:dokuwiki-128.png?50}}

重设宽度和高度：                  {{wiki:dokuwiki-128.png?200x50}}

重设尺寸的外部图片：              {{http://de3.php.net/images/php.gif?200x50}}

  实际尺寸：                        {{wiki:dokuwiki-128.png}}
  重设宽度：                        {{wiki:dokuwiki-128.png?50}}
  重设宽度和高度：                  {{wiki:dokuwiki-128.png?200x50}}
  重设尺寸的外部图片：              {{http://de3.php.net/images/php.gif?200x50}}


通过左右空格，你可以设置对齐方式

{{ wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{ wiki:dokuwiki-128.png }}

  {{ wiki:dokuwiki-128.png}}
  {{wiki:dokuwiki-128.png }}
  {{ wiki:dokuwiki-128.png }}

当然，你也可以加入说明文字（作为给浏览者提供的提示）。

{{ wiki:dokuwiki-128.png |这是说明文字}}

  {{ wiki:dokuwiki-128.png |这是说明文字}}

如果你使用的是非图片（''gif,jpeg,png''）的文件名（外部或者内部）那么它会被作为一个链接。

对于把图片链接向另外一个页面的运用，请见上面的 [[syntax#图片链接|图片链接]] 。

===== 列表 =====

Dokuwiki支持有序和无序列表。为了创建一个列表条目，你需要在文本前面加入两个空格和一个''*''来表示无序列表，或者用''-''表示有序列表。

  * 这是个列表
  * 第二条
    * 可以设置不同的级别
  * 另外一条

  - 同样的列表，有序的
  - 第二条
    - 使用缩进表示深层级别
  - 这就是了

<code>
  * 这是个列表
  * 第二条
    * 可以设置不同的级别
  * 另外一条

  - 同样的列表，有序的
  - 第二条
    - 使用缩进表示深层级别
  - 这就是了
</code>

===== 表情 =====

DokuWiki包含了常用的表情（[[wp>emoticon]]）。可以在''smiley''文件夹里添加更多表情并在''conf/smileys.conf''文件中进行配置。这是DokuWiki的表情综览。

  * 8-) %%  8-)  %%
  * 8-O %%  8-O  %%
  * :-( %%  :-(  %%
  * :-) %%  :-)  %%
  * =)  %%  =)   %%
  * :-/ %%  :-/  %%
  * :-\ %%  :-\  %%
  * :-? %%  :-?  %%
  * :-D %%  :-D  %%
  * :-P %%  :-P  %%
  * :-O %%  :-O  %%
  * :-X %%  :-X  %%
  * :-| %%  :-|  %%
  * ;-) %%  ;-)  %%
  * ^_^ %%  ^_^  %%
  * :?: %%  :?:  %%
  * :!: %%  :!:  %%
  * LOL %%  LOL  %%
  * FIXME %%  FIXME %%
  * DELETEME %% DELETEME %%

===== 样式 =====

[[DokuWiki]]可以通过简单的文本符号来表示特殊符号。这是能够被识别的符号的例子。

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"他想道'这是人类的世界'..."

<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"他想道'这是人类的世界'..."
</code>

请注意：这些变化可以通过 [[doku>wiki:config#typography|配置选项]]和 [[doku>wiki:entities|模式文件]]关闭。

===== 应用 =====

有时你想表明一些话是回答或者评论，你可以使用这样的格式：

  I think we should do it
  
  > No we shouldn't
  
  >> Well, I say we should

  > Really?
  
  >> Yes!
  
  >>> Then lets do it!

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

===== 表格 =====

DokuWiki支持简易制表。

^ 标题 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      ^
^ 标题 3   | 1 行 2 列       | 1 行 3 列   |
^ 标题 4   | 这次不进行列合并|             |
^ 标题 5   | 3 行 2 列       | 3 行 3 列   |

正如你所见，单元格的格式由它前面的单元格分隔号决定：

  |          ^ 标题 1          ^ 标题 2      ^
  ^ 标题 3   | 1 行 2 列       | 1 行 3 列   |
  ^ 标题 4   | 这次不进行列合并|             |
  ^ 标题 5   | 3 行 2 列       | 3 行 3 列   |

注意：不支持行合并

你也可以设置对其方式，只要在文本的两面加入两个以上的空格：左面加入两个空格进行右对齐，右面加入两个空格进行右对齐，两边至少两个空格进行居中。

^           表格对齐方式                   ^^^
|        右对齐|     居中     |左对齐        |
|左对齐        |        右对齐|     居中     |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

这是源代码的表示：

  ^           表格对齐方式                   ^^^
  |        右对齐|     居中     |左对齐        |
  |左对齐        |        右对齐|     居中     |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

===== 无编译区块 =====

你可以通过在行首加入两个以上的空格（就像上面的例子）或者使用''code''或''file''的标签来表示无编译区块。

<code>
这是所有内容都保留的代码：就像              <-这样
</code>

<file>
这个非常类似，但是你可以用它来表示你引用了一个文件
</file>

为了让解析器完全忽略一块区域（也就是说不对其进行编译），可以附上''nowiki''的标签，或者更简单的是，使用两个百分号''<nowiki>%%</nowiki>''。

<nowiki>
这是一段包含这样的地址的文字：：http://www.splitbrain.org 和 **编译**，但是它们没被编译。
</nowiki>

请查看这段内容的源代码来查看如何使用这些手段。

===== 高亮格式 =====

[[DokuWiki]]可以将一段代码高亮，使它更易阅读。这是使用 [[http://qbnz.com/highlighter/|GeSHi]] 通用格式高亮器——支持GeSHi的语言都支持它。这个格式和前面一小节的代码区段很像，但是这次使用的语言标志是插入到标签内，比如''<nowiki><code java></nowiki>''。

<code java>
/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}
</code>

以下字符串都能被正确识别：//actionscript, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, tsql, robots, ruby, vb, vbnet, vhdl, visualfoxpro, xml//

===== HTML与PHP代码嵌入 =====

你可以通过使用''html'' or ''php''标签来向文档内嵌入HTML或PHP代码：
<code>
<html>
This is some <font color="red" size="+1">HTML</font>
</html>
</code>

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

<code>
<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
</code>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

**请注意**：HTML和PHP嵌入在配置里面默认关闭。如果关闭，代码会被显示而不是被编译。

===== 格式插件 =====

DokuWiki的格式可以通过 [[doku>wiki:plugins|插件]] 扩展。使用说明里有如何使用已安装的插件的描述。以下格式插件在这个版本的DokuWiki上是可用的：

~~INFO:syntaxplugins~~