格式语法说明

油画wiki支持一些简单的标记语言, 以尽最大可能使文档看上去更友好。本页面包含了所有你在编辑页面时可能用到的语法的说明。如果需要查看本页源码，只需要点击页面顶部或者底部的 编辑本页 按钮即可。如果您想尝试一些东西，请先到编辑测试页热身。通过快捷按钮，您可以更方便地使用这些标记。

脚注

您可以使用两个连续小括号来添加脚注¹⁾。

您可以使用两个连续小括号来添加脚注((这是一个脚注))。

图像和其它文件

您可以使用双大括号来在页面中加入图像。您还可以选择是否指定图像的显示大小。

原始大小：

指定宽度：

指定高度和宽度：

重新指定宽度和高度的外部图像：

原始大小：                        {{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 |这是一张图片}}

如果您指定的文件名（无论是外部的还是内部的）不是一个图像（gif，jpeg，png），那么它将被显示为一个链接。

如果让图像链接到其他页面，请查看图像链接

列表

Dokuwiki支持带编号或不带编号的列表。要使用列表，在文字前加入两个空格，然后使用*标志不带编号的列表，用-标志带编号的列表。

列表
第二项
- 下一层
第三项

带编号的列表
第二项
1. 用缩进表示更深的层
完了

  * 列表
  * 第二项
    * 下一层
  * 第三项

  - 带编号的列表
  - 第二项
    - 用缩进表示更深的层
  - 完了

表情符号

DokuWiki会将一些常用的表情符号转换为图像。除了默认的表情符号以外，您也可以在smiley文件夹中放入更多的表情图，然后在conf/smileys.conf中设置它们即可。下面是Dokuwiki已包含的表情图像：

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

表格

DokuWiki支持用简单的语法创建表格。

标题1	题2	题3
行1 列1	行1 列2	行1 列3
行2 列1	展宽的单元格
行3 列1	行2 列2	行2 列3

表格的每一行都以分隔符 | （普通行）或者 ^ （标题行）作为开头和结束。

^ 标题1      ^ 题2       ^ 题3          ^
| 行1 列1    | 行1 列2     | 行1 列3        |
| 行2 列1    | 展宽的单元格 |                |
| 行3 列1    | 行2 列2     | 行2 列3        |

要水平合并单元格，只需要将后一个单元格设置为空即可，如上面演示的一样。请确保每一行有相同数量的单元格分隔符！

竖直的标题列也是可以实现的：

	标题1	标题2
标题3	行1 列2	行1 列3
标题4	不再合并单元格
标题5	行2 列2	行2 列3

可以看到，单元格前面的分隔符决定了单元格的格式。

|              ^ 标题1            ^ 标题2          ^
^ 标题3    | 行1 列2          | 行1 列3        |
^ 标题4    | 不再合并单元格     |                |
^ 标题5    | 行2 列2          | 行2 列3        |

注：垂直合并单元格尚未实现。

你可以对齐表格的文字。只需要添加多余两个的空格在您需要对齐的方向的反向即可，如果需要右对齐，在左边添加两个空格；反之，则在右边添加。在两边均添加空格可以实现中间对齐。

对齐的表格
右对齐	居中	左对齐
左对齐	右对齐	居中
xxxxxxxxxxxx	xxxxxxxxxxxx	xxxxxxxxxxxx

源文件如下：

^           对齐的表格           ^^^
|          右对齐|    居中    |左对齐          |
|左对齐          |         右对齐|    居中    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

无格式区块

你可以在文章中插入无格式区块，在这些区块中Wiki语法将不起作用。可以有三种方法：在行前加两个以上的空格（前面做样例时用的方法），或者可以使用code或file标记。

这是一段被code包围的区块，其中的空格都被保留了：像              <-这样

和code是类似的。不过您可以用这个来表示您引用了一个文件的内容。

要让Wiki语法解释完全失效，可以用nowiki标签包围整个区块，或者也可以简单地使用双百分号标记%%.

这是一段完全没有Wiki语法解释的文字，例如：http://www.splitbrain.org ， **粗体**，虽然按照语法书写，但是它们并没有被解释。

如何使用这些标记，请查看这一段的源文件。

语法高亮

DokuWiki可以将源代码作语法高亮以增加可读性。它使用称作GeSHi的通用语法高亮工具——所有被GeSHi支持的语言都可以在DokuWiki中得到高亮。使用code标记的方法和上面是类似的，不过需要指定使用的语言，例如：<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.
    }
}

现在，DokuWiki可以支持的语言有：actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml

嵌入HTML和PHP

你可以使用html或者php标记在文档中嵌入HTML或PHP的代码，例如：

<html>
这是<font color="red" size="+1">HTML</font>代码。
</html>

这是HTML代码。

<php>
echo '由PHP生成的logo：';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

由PHP生成的logo： PHP Logo !

请注意：HTML和PHP嵌入的功能默认情况下是被禁用的。因此，你可能无法看到上面的代码运行的结果而只能够看见源代码，这取决于DokuWiki站点的设置。

不是吧，这是怎么回事？

语法插件

DokuWiki的语法可以通过插件的方式进行扩展。在相应插件的页面有安装说明。下列语法插件适用于当前版本中：

Info Plugin 2006-12-09 由 Andreas Gohr
Displays information about various DokuWiki internals

¹⁾ 这是一个脚注

格式语法说明

基本文本格式

链接

外部链接

内部链接

wiki间链接

Windows共享文件夹

图像链接

脚注

标题段落

H3标题

H4标题

H5标题