Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| zh-cn:wiki:syntax [2012/04/28 18:21] – [RSS/ATOM Feed 聚合] haobug | zh-cn:wiki:syntax [2026/11/06 04:12] (current) – removed kevinbowen | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== 格式化语法 ====== | ||
| - | |||
| - | [[doku> | ||
| - | ===== 基本文字格式 ===== | ||
| - | DokuWiki支持**粗体**,// | ||
| - | |||
| - | DokuWiki支持**粗体**,// | ||
| - | |||
| - | 您也可以使用< | ||
| - | |||
| - | 您也可以使用< | ||
| - | |||
| - | 同时也可以使用< | ||
| - | |||
| - | 同时也可以使用< | ||
| - | |||
| - | **段落**是由空行所建立的。如果您想**强制换行**而不建立段落,您可以使用两个连续的反斜杠接空格或换行符作为标记。请看样例: | ||
| - | |||
| - | 这是一些有着换行标记的文字。\\ 请注意 | ||
| - | 双反斜杠只在回车符之前\\ | ||
| - | 或者接在\\ 一个空格之前的时候才有效。\\而这样就并不起作用。 | ||
| - | |||
| - | 这是一些有着换行标记的文字。\\ 请注意 | ||
| - | 双反斜杠只在回车符之前\\ | ||
| - | 或者接在\\ 一个空格之前的时候才有效。\\而这样就并不起作用。 | ||
| - | |||
| - | 请仅在必须的时候使用强制换行标记。 | ||
| - | ===== 链接 ===== | ||
| - | |||
| - | DokuWiki 支持以多种创建链接方法。 | ||
| - | |||
| - | ==== 外部链接 ==== | ||
| - | |||
| - | 外部链接会被自动地识别: http:// | ||
| - | |||
| - | DokuWiki 支持以多种创建链接方法。外部链接会被自动地识别: http:// | ||
| - | ==== 内部链接 ==== | ||
| - | |||
| - | 内部链接可以用方括号创建。您可以只给出[[页面名]],或附加[[页面名|链接文本]]。 | ||
| - | |||
| - | 内部链接可以用方括号创建。您可以只给出 | ||
| - | [[页面名]],或附加[[页面名|链接文本]]。 | ||
| - | |||
| - | [[doku> | ||
| - | |||
| - | 您可以通过在页面名中添加冒号的方式来使用[[某目录: | ||
| - | |||
| - | 您可以通过在页面名中添加冒号的方式来使用[[某目录: | ||
| - | |||
| - | 如果您需要更多有关“命名空间(namespaces)”的详细信息,请参见[[doku> | ||
| - | |||
| - | 链接到一个特定章节也是可能的。只需要在# | ||
| - | |||
| - | 这是一个指向[[syntax# | ||
| - | |||
| - | 注意: | ||
| - | * 指向[[syntax|已存在页面]]的和[[nonexisting|不存在页面]]的链接,其外观是不同的。 | ||
| - | * 默认情况下,DokuWiki不使用[[wp> | ||
| - | * 当一节的标题改变时,它的书签也会改变。因此,请不要过于依赖章节链接。 | ||
| - | ==== Wiki间链接 ==== | ||
| - | |||
| - | DokuWiki支持[[doku> | ||
| - | |||
| - | DokuWiki支持[[doku> | ||
| - | 例如,这是一个指向Wikipedia上Wiki条目的链接:[[wp> | ||
| - | |||
| - | ==== Windows 共享文件夹 ==== | ||
| - | |||
| - | Windows 共享文件夹,例如[[\\server\share|这个]]也可以被识别。请注意,这只在企业[[wp> | ||
| - | |||
| - | Windows共享文件夹,例如[[\\server\share|这个]]也可以被识别。 | ||
| - | |||
| - | 注意: | ||
| - | |||
| - | * 出于安全原因,只有在微软IE浏览器上才能够直接访问Windows共享文件夹(并且仅在“本地区域”)。 | ||
| - | * 对于Mozilla和Firefox可以通过[[http:// | ||
| - | |||
| - | $lang[' | ||
| - | |||
| - | ==== 图像链接 ==== | ||
| - | |||
| - | 您也可以通过结合链接和[[# | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | 请注意:图像的格式化语法是链接文本唯一接受的格式化语法。 | ||
| - | |||
| - | 所有的图像 [[# | ||
| - | |||
| - | ===== 脚注 ===== | ||
| - | |||
| - | 您可以使用两个连续小括号(英文)来添加脚注((这是一个脚注))。 | ||
| - | |||
| - | 您可以使用两个连续小括号(英文)来添加脚注((这是一个脚注))。 | ||
| - | |||
| - | ===== 分节 ===== | ||
| - | |||
| - | 您可以使用多达5层的标题来组织您的内容。如果您使用了三个以上的标题,将自动生成目录 -- 这可以通过在页面加入 ''< | ||
| - | |||
| - | ==== 3级标题 ==== | ||
| - | === 4级标题 === | ||
| - | == 5级标题 == | ||
| - | |||
| - | ==== 3级标题 ==== | ||
| - | === 4级标题 === | ||
| - | == 5级标题 == | ||
| - | |||
| - | 您可以通过4个以上连续的“-”号来创建一条水平分割线: | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ===== 图像和其它文件 ===== | ||
| - | |||
| - | 您可以用两个大括号在页面中加入外部或内部的 [[doku> | ||
| - | |||
| - | 实际大小: | ||
| - | |||
| - | 调整为指定宽度: | ||
| - | |||
| - | 调整为指定宽度和高度((当指定的长宽比与图像本身的长宽比不一致,在调整图像大小前,其将先被裁切到新的比例)):{{wiki: | ||
| - | |||
| - | 调整外部图像大小: | ||
| - | |||
| - | 实际大小: | ||
| - | 调整为指定宽度: | ||
| - | 调整为指定宽度和高度: | ||
| - | 调整外部图像大小: | ||
| - | |||
| - | |||
| - | 通过使用左空格或右空格,您可以选择对齐方式。 | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | {{wiki: | ||
| - | {{ wiki: | ||
| - | |||
| - | 当然,您也可以指定一个标题(多数浏览器显示为提示文本)。 | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | 如果您指定的文件名(无论是外部的还是内部的)不是一个图像(gif, | ||
| - | |||
| - | 对于将图像链接到其他页面,参见上面的 [[# | ||
| - | |||
| - | ===== 列表 ===== | ||
| - | |||
| - | Dokuwiki 持带编号或不带编号的列表。 要创建列表,在文字前加入两个空格,然后使用 '' | ||
| - | |||
| - | * 这是一个列表 | ||
| - | * 第二项 | ||
| - | * 您可以有不同的层次 | ||
| - | * 另一项 | ||
| - | |||
| - | - 带编号的列表 | ||
| - | - 另一项 | ||
| - | - 用缩进表示更深的层 | ||
| - | - 就这样 | ||
| - | |||
| - | < | ||
| - | * 这是一个列表 | ||
| - | * 第二项 | ||
| - | * 您可以有不同的层次 | ||
| - | * 另一项 | ||
| - | |||
| - | - 带编号的列表 | ||
| - | - 另一项 | ||
| - | - 用缩进表示更深的层 | ||
| - | - 就这样 | ||
| - | </ | ||
| - | |||
| - | 请参看下 [[doku> | ||
| - | |||
| - | ===== 文本转换 ===== | ||
| - | |||
| - | DokuWiki 可以将预定义的字符或者字符串转换成图像、其他文本或HTML。 | ||
| - | |||
| - | 文本转换为图像主要用于表情符号。文本到HTML的转换用于排版的字符替换,但也可以配置为使用其他HTML。 | ||
| - | |||
| - | ==== 文本到图像的转换 ==== | ||
| - | |||
| - | DokuWiki 会将一些常用的 [[wp> | ||
| - | |||
| - | * 8-) %% 8-) %% | ||
| - | * 8-O %% 8-O %% | ||
| - | * :-( %% :-( %% | ||
| - | * :-) %% :-) %% | ||
| - | * =) %% =) %% | ||
| - | * :-/ %% :-/ %% | ||
| - | * :-\ %% :-\ %% | ||
| - | * :-? %% :-? %% | ||
| - | * :-D %% :-D %% | ||
| - | * :-P %% :-P %% | ||
| - | * :-O %% :-O %% | ||
| - | * :-X %% :-X %% | ||
| - | * :-| %% :-| %% | ||
| - | * ;-) %% ;-) %% | ||
| - | * ^_^ %% ^_^ %% | ||
| - | * :?: %% :?: %% | ||
| - | * :!: %% :!: %% | ||
| - | * LOL %% LOL %% | ||
| - | * FIXME %% FIXME %% | ||
| - | * DELETEME %% DELETEME %% | ||
| - | |||
| - | ==== 文本到HTML的转换 ==== | ||
| - | |||
| - | 印刷:[[DokuWiki]] 可以将特定字符转换为印刷时所用的样式。这是可识别的字符示例。 | ||
| - | |||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | " | ||
| - | |||
| - | < | ||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | " | ||
| - | </ | ||
| - | |||
| - | 同样的做法可以产生任何类型的HTML,只需要添加到 [[doku> | ||
| - | |||
| - | 有三个例外,它们并非来自模式文件:乘法(640×480)、' | ||
| - | |||
| - | ===== 引用 ===== | ||
| - | |||
| - | 有时您想将某些文本标记为回复或者评论。您可以使用下列语法: | ||
| - | |||
| - | 我想我们应该做这件事 | ||
| - | > 不,我们不应该 | ||
| - | >> 好吧,我说我们应该 | ||
| - | > 真的? | ||
| - | >> 是! | ||
| - | >>> | ||
| - | |||
| - | 我想我们应该做这件事 | ||
| - | > 不,我们不应该 | ||
| - | >> 好吧,我说我们应该 | ||
| - | > 真的? | ||
| - | >> 是! | ||
| - | >>> | ||
| - | ===== 表格 ===== | ||
| - | |||
| - | 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 | 行 2 列 2 | 行 2 列 3 | | ||
| - | |||
| - | 可以看到,单元格前面的分隔符决定了单元格的格式: | ||
| - | |||
| - | | ^ 标题 1 ^ 标题 2 ^ | ||
| - | ^ 标题 3 | 行 1 列 2 | 行 1 列 3 | | ||
| - | ^ 标题 4 | 没有跨列合并 | | | ||
| - | ^ 标题 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 | | ||
| - | |||
| - | 注意:不支持垂直对齐方式。 | ||
| - | |||
| - | ===== 无格式化 ===== | ||
| - | |||
| - | 如果您需要文本完全显示为它键入的样子(没有任何格式化), 用 '' | ||
| - | |||
| - | < | ||
| - | 这是一些包含像这样的地址文字:http:// | ||
| - | </ | ||
| - | |||
| - | 对于带有表情符号的 %%; | ||
| - | |||
| - | < | ||
| - | 这是一些包含像这样的地址文字:http:// | ||
| - | </ | ||
| - | |||
| - | 对于带有表情符号的 %%; | ||
| - | |||
| - | ===== 代码块 ===== | ||
| - | |||
| - | 您可以将代码块包含到文档中,可以通过缩进两个空格(像前面例子中所用的那样) 或者使用标 '' | ||
| - | |||
| - | 这是缩进了两个空格的文本。 | ||
| - | |||
| - | < | ||
| - | 这是预格式化的代码,所有空格都被保留:像 | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | 这非常相似,但您可以用它来表明您引用了一个文件。 | ||
| - | </ | ||
| - | |||
| - | 这些区块由下面的源码创建: | ||
| - | |||
| - | 这是缩进了两个空格的文本。 | ||
| - | |||
| - | < | ||
| - | 这是预格式化的代码,所有空格都被保留:像 | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | 这非常相似,但您可以用它来表明您引用了一个文件。 | ||
| - | </ | ||
| - | |||
| - | ==== 语法高亮 ==== | ||
| - | |||
| - | [[wiki: | ||
| - | |||
| - | <code java> | ||
| - | /** | ||
| - | * HelloWorldApp 类实现一个向到标准输出显示 "Hello World!" | ||
| - | */ | ||
| - | class HelloWorldApp { | ||
| - | public static void main(String[] args) { | ||
| - | System.out.println(" | ||
| - | } | ||
| - | } | ||
| - | </ | ||
| - | |||
| - | 下列字符串为当前可以识别语言:// | ||
| - | |||
| - | ==== 可下载的代码块 ==== | ||
| - | |||
| - | 当你使用上面的'' | ||
| - | |||
| - | < | ||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | |||
| - | 如果您不想要任何高亮,但想要一个可下载的文件,指定破折号('' | ||
| - | ===== 内嵌 HTML 和 PHP ===== | ||
| - | |||
| - | 您可以嵌入原始HTML或PHP代码到文件中,通过使用 '' | ||
| - | |||
| - | HTML 例子: | ||
| - | |||
| - | < | ||
| - | < | ||
| - | 这是一些 <span style=" | ||
| - | </ | ||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | 这是一些 <span style=" | ||
| - | </ | ||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | PHP 例子: | ||
| - | |||
| - | < | ||
| - | <php> | ||
| - | echo 'PHP 生成的logo:'; | ||
| - | echo '< | ||
| - | echo ' | ||
| - | </ | ||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <php> | ||
| - | echo 'PHP 生成的logo:'; | ||
| - | echo '< | ||
| - | echo ' | ||
| - | </ | ||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | |||
| - | **注意**:HTML 和 PHP 在配置中默认是禁用的。如果禁用了,就会显示它们代码,而不会执行它们。 | ||
| - | |||
| - | ===== RSS/ATOM Feed 聚合 ===== | ||
| - | 所有的能够被SimplePie理解的格式都可以在DokuWiki中使用。您可以通过多个参数来改变渲染,参数之间用空格隔开: | ||
| - | |||
| - | |||
| - | [[DokuWiki]] 能够从外部的XML feed中聚合数据。用[[http:// | ||
| - | |||
| - | ^ 参数 | ||
| - | | 任何数字 | 最多显示多少内容项;默认是8 | | ||
| - | | reverse | ||
| - | | author | ||
| - | | date | 显示条目日期 | | ||
| - | | description| 显示条目的描述;如果 [[doku> | ||
| - | | //n//[dhm] | 刷新周期,其中,d=天,h=小时,m=分。例如,12h=12个小时。| | ||
| - | |||
| - | 刷新周期默认是4小时。小于或者等于10分钟均视为10分钟。[[wiki: | ||
| - | |||
| - | |||
| - | **举例:** | ||
| - | |||
| - | {{rss> | ||
| - | |||
| - | |||
| - | ===== 控制宏 ===== | ||
| - | |||
| - | 一些语法会影响DokuWiki对页面的解释,而自身不输出任何内容。可用的控制宏如下: | ||
| - | |||
| - | ^ 宏 ^ 描述 | | ||
| - | | %%~~NOTOC~~%% | ||
| - | | %%~~NOCACHE~~%% | DokuWiki 默认会缓存所有的输出。有时并不希望这样(例如,当使用了上面的 %%< | ||
| - | |||
| - | ===== 语法插件 ===== | ||
| - | |||
| - | DokuWiki 的语法可以通过 [[doku> | ||
| - | |||
| - | ~~INFO: | ||