====== 格式化语法 ======

[[doku>DokuWiki]] 支持一种简单的标记语言，它尽量让数据文件保持可读性。本页面包含你在编辑页面时可能用到的全部语法。点击「编辑本页」即可查看本页的源代码。如果你想练习，可以使用[[playground:playground|沙盒]]页面。更简单的标记可以通过[[doku>toolbar|快捷按钮]]直接插入。

===== 基础文本格式 =====

DokuWiki 支持**粗体**、//斜体//、__下划线__和''等宽''文本。当然你也可以**__//''组合''//__**使用它们。

  DokuWiki 支持**粗体**、//斜体//、__下划线__和''等宽''文本。
  当然你也可以**__//''组合''//__**使用它们。

注意：格式标记必须紧贴文本，因此''%%** bold **%%''这种标记内部带空格的写法不会被格式化。

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

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

你还可以把内容标记为<del>已删除</del>。

  你还可以把内容标记为<del>已删除</del>。

**段落**由空行分隔。如果你想在段落内**强制换行**，可以在行尾使用两个反斜杠（后面跟一个空格，或直接位于行末）。

这是包含换行的文字\\ 请注意，
两个反斜杠只在行尾\\或后面跟空格时生效，
或后面跟\\ 空格 \\没有空格就不会换行。

  这是包含换行的文字\\ 请注意，
  两个反斜杠只在行尾\\或后面跟空格时生效，
  或后面跟\\ 空格 \\没有空格就不会换行。

只有在确实需要时才应使用强制换行。

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

DokuWiki 支持多种创建链接的方式。

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

外部链接会被自动识别：http://www.google.com 或直接写 www.google.com 都可以。你也可以自定义链接文字：[[http://www.google.com|这个链接指向谷歌]]。电子邮件地址如 <andi@splitbrain.org> 同样会被识别。

  DokuWiki 支持多种创建链接的方式。外部链接会被自动识别：
  http://www.google.com 或直接写 www.google.com - 你也可以自定义链接
  文字：[[http://www.google.com|这个链接指向谷歌]]。电子邮件地址
  如 <andi@splitbrain.org> 同样会被识别。

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

内部链接使用方括号创建。你可以只写[[pagename]]，也可以附加[[pagename|链接文字]]。

  内部链接使用方括号创建。你可以只写[[pagename]]，
  也可以附加[[pagename|链接文字]]。

[[doku>pagename|Wiki 页面名]]会自动转换为小写，且不允许使用特殊字符。

在页面名中使用冒号即可引用[[some:namespaces|命名空间]]。

  在页面名中使用冒号即可引用[[some:namespaces|命名空间]]。

关于命名空间的详细信息参见[[doku>namespaces]]。

也可以链接到指定章节。只需像 HTML 中那样，在井号（#）后加上章节名。例如这个链接指向[[syntax#内部链接|本章节]]。

  这个链接指向[[syntax#内部链接|本章节]]。

注意：

  * 指向[[syntax|已存在页面]]的链接与指向[[nonexisting|不存在页面]]的链接显示样式不同。
  * 默认情况下 DokuWiki 不会使用[[wp>CamelCase]]自动创建链接，但可以在[[doku>config|配置文件]]中启用。提示：如果 DokuWiki 是链接，说明已启用。
  * 章节标题改变时，其锚点也会改变，因此不要太依赖章节链接。

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

DokuWiki 支持[[doku>Interwiki|跨 Wiki 链接]]，可以快速链接到其他 Wiki。例如这是指向维基百科「Wiki」词条的链接：[[wp>Wiki]]。

  DokuWiki 支持[[doku>Interwiki|跨 Wiki 链接]]，可以快速链接到其他 Wiki。
  例如这是指向维基百科「Wiki」词条的链接：[[wp>Wiki]]。

==== Windows 共享 ====

Windows 共享路径如[[\\server\share|这个]]也能被识别。请注意，这类链接只在同构的用户群体（如企业内部[[wp>Intranet|内网]]）中才有意义。

  Windows 共享路径如[[\\server\share|这个]]也能被识别。

注意：

  * 出于安全原因，默认情况下只有 Microsoft Internet Explorer 支持直接浏览 Windows 共享（且仅在「本地区域」内）。
  * 对于 Mozilla 和 Firefox，可以通过[[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla 知识库]]中提到的方法启用。但仍会有 JavaScript 警告提示正在打开 Windows 共享。若要（为所有用户）移除该警告，请在''conf/lang/en/lang.php''中加入以下内容（详见[[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|本地化]]）：<code - conf/lang/en/lang.php>
<?php
/**
 * Customization of the english language file
 * Copy only the strings that needs to be modified
 */
$lang['js']['nosmblinks'] = '';
</code>

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

你还可以将链接语法与[[#媒体文件|图片]]语法（见下文）结合，用图片链接到其他内部或外部页面，例如：

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

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

请注意：图片格式是链接名称中唯一被接受的格式化语法。

完整的[[#媒体文件|图片]]和[[#链接|链接]]语法均受支持（包括图片缩放、内部和外部图片、URL 以及跨 Wiki 链接）。

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

使用双括号即可添加脚注((这是一个脚注))。

  使用双括号即可添加脚注((这是一个脚注))。

===== 章节划分 =====

你可以使用最多五级标题来组织内容。如果页面中超过三个标题，会自动生成目录——在文档中加入''<nowiki>~~NOTOC~~</nowiki>''即可禁用此功能。

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

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

使用四个或更多短横线可以创建水平分隔线：

----

===== 媒体文件 =====

使用花括号可以嵌入外部和内部[[doku>images|图片、视频和音频文件]]。你还可以选择指定它们的大小。

原始大小：                        {{wiki:dokuwiki-128.png}}

指定宽度：                        {{wiki:dokuwiki-128.png?50}}

指定宽高((当指定的宽高比与图片原始比例不一致时，会先按新比例裁剪再缩放))： {{wiki:dokuwiki-128.png?200x50}}

缩放的远程图片：                   {{https://www.php.net/images/php.gif?200x50}}

  原始大小：                        {{wiki:dokuwiki-128.png}}
  指定宽度：                        {{wiki:dokuwiki-128.png?50}}
  指定宽高： {{wiki:dokuwiki-128.png?200x50}}
  缩放的远程图片：                   {{https://www.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 }}

你也可以用''?left''、''?right''或''?center''参数显式设置对齐方式。这优先于上面的空格对齐，并且可以与尺寸参数组合使用。

{{wiki:dokuwiki-128.png?100&right}}

  {{wiki:dokuwiki-128.png?100&right}}

当然，你也可以添加标题（大多数浏览器会以提示气泡显示）。

{{ wiki:dokuwiki-128.png |这是标题}}

  {{ wiki:dokuwiki-128.png |这是标题}}

将图片链接到其他页面的方法参见上文[[#图片链接]]。

==== 支持的媒体格式 ====

DokuWiki 可以直接嵌入以下媒体格式。

| 图片 | ''gif''、''jpg''、''png'' |
| 视频 | ''webm''、''ogv''、''mp4'' |
| 音频 | ''ogg''、''mp3''、''wav'' |
| Flash | ''swf'' |

如果你指定的文件名不是受支持的媒体格式，则会以链接形式显示。

添加''?linkonly''参数后，只提供媒体链接而不在页面中显示：

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

{{wiki:dokuwiki-128.png?linkonly}} 这只是指向图片的链接。

==== 备用格式 ====

遗憾的是并非所有浏览器都支持全部视频和音频格式。为缓解这一问题，你可以上传多种格式的文件以获得最大程度的浏览器兼容性。

例如，考虑这段嵌入的 mp4 视频：

  {{video.mp4|一段有趣的视频}}

当你在被引用的''video.mp4''旁边上传''video.webm''和''video.ogv''时，DokuWiki 会自动将它们作为备选加入，这样你的浏览器至少能识别其中一种格式。

此外，DokuWiki 还支持「海报」图片，会在视频开始播放前显示。该图片需要与视频同名，且为 jpg 或 png 格式。在上面的例子中，''video.jpg'' 即可满足要求。

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

DokuWiki 支持有序和无序列表。创建列表项时，先将文本缩进两个空格，然后用''*''表示无序列表、用''-''表示有序列表。

  * 这是一个列表
  * 第二个项目
    * 你可以使用不同层级
  * 另一个项目

  - 同样的列表，但有序
  - 另一个项目
    - 缩进越多层级越深
  - 就这样

<code>
  * 这是一个列表
  * 第二个项目
    * 你可以使用不同层级
  * 另一个项目

  - 同样的列表，但有序
  - 另一个项目
    - 缩进越多层级越深
  - 就这样
</code>

也可以看看[[doku>faq:lists|列表相关 FAQ]]。

===== 文本转换 =====

DokuWiki 可以将某些预定义的字符或字符串转换为图片、其他文本或 HTML。

文本转图片主要用于表情符号。文本转 HTML 则用于排版替换，也可以配置为输出其他 HTML。

==== 文本转图片 ====

DokuWiki 会将常用的[[wp>emoticon|表情符号]]转换为对应的图片。这些[[doku>Smileys|表情]]和其他图片都可以配置和扩展。以下是 DokuWiki 内置表情的概览：

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

==== 文本转 HTML ====

排版：[[DokuWiki]] 可以将简单的文本字符转换为排版正确的实体。以下是被识别字符的示例。

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
</code>

同样的机制也可以用来生成任意 HTML，只需将其加入[[doku>entities|模式文件]]。

有三个例外不来自该模式文件：乘号实体（640x480）、'单引号'和"双引号"。可以通过[[doku>config:typography|配置选项]]关闭它们。

===== 引用 =====

有时你想标记某段文字以表示这是回复或评论，可以使用以下语法：

<code>
我觉得我们应该这么做

> 不，我们不应该

>> 好吧，我觉得我们应该

> 真的吗？

>> 是的！

>>> 那我们就做吧！
</code>

我觉得我们应该这么做

> 不，我们不应该

>> 好吧，我觉得我们应该

> 真的吗？

>> 是的！

>>> 那我们就做吧！

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

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列    | :::                        | 第3行第3列        |

除跨行语法外，这些单元格不应包含其他内容。

  ^ 表头 1      ^ 表头 2                  ^ 表头 3          ^
  | 第1行第1列    | 这个单元格纵向合并    | 第1行第3列        |
  | 第2行第1列    | :::                        | 第2行第3列        |
  | 第3行第1列    | :::                        | 第3行第3列        |

你还可以对齐表格内容。只需在文字的另一端添加至少两个空格：左侧加两个空格右对齐，右侧加两个空格左对齐，两端都加至少两个空格则居中。

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

以下是它在源代码中的样子：

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

注意：不支持垂直对齐。

===== 不进行格式化 =====

如果需要原样显示文本（不进行任何格式化），可以将内容包在''%%<nowiki>%%''标签中，或更简单地使用双百分号''<nowiki>%%</nowiki>''。

<nowiki>
这是一段包含地址（如 http://www.splitbrain.org）和**格式化标记**的文本，但不会进行任何处理。
</nowiki>
对于%%//__这段文本__//加笑脸 ;-)%%同样如此。

  <nowiki>
  这是一段包含地址（如 http://www.splitbrain.org）和**格式化标记**的文本，但不会进行任何处理。
  </nowiki>
  对于%%//__这段文本__//加笑脸 ;-)%%同样如此。

===== 代码块 =====

你可以在文档中加入代码块：将内容至少缩进两个空格（如前面示例所示），或使用''%%<code>%%''、''%%<file>%%''标签。

  这段文本缩进了两个空格。

<code>
这是预格式化的代码，所有空格都会被保留：像这样              <-这里
</code>

<file>
这与上面基本相同，但你可以用它来表明引用了一个文件。
</file>

以上代码块由以下源代码创建：

    这段文本缩进了两个空格。

  <code>
  这是预格式化的代码，所有空格都会被保留：像这样              <-这里
  </code>

  <file>
  这与上面基本相同，但你可以用它来表明引用了一个文件。
  </file>

==== 语法高亮 ====

[[wiki:DokuWiki]] 可以对源代码进行高亮，使其更易阅读。它使用[[http://qbnz.com/highlighter/|GeSHi]]通用语法高亮器——因此 GeSHi 支持的所有语言它都支持。语法与上一节介绍的代码块和文件块相同，但需要在标签内写明要高亮的语言名，例如''<nowiki><code java></nowiki>''或''<nowiki><file 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>

目前可识别的语言字符串如下：//4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic//

语法高亮还有一些[[doku>syntax_highlighting|高级选项]]，例如高亮指定行或添加行号。

==== 可下载的代码块 ====

使用上面的''%%<code>%%''或''%%<file>%%''语法时，你可能还希望让显示的代码可以下载。在语言代码后指定文件名即可，例如：

<code>
<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
</code>

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>

如果不需要高亮但需要可下载的文件，用短横线（''-''）作为语言代码：''%%<code - myfile.foo>%%''。

===== RSS/ATOM 聚合 =====
[[DokuWiki]] 可以整合外部 XML 订阅源的数据。解析 XML 订阅源使用的是[[http://simplepie.org/|SimplePie]]。SimplePie 支持的所有格式 DokuWiki 也同样支持。你可以通过多个以空格分隔的附加参数控制渲染效果：

^ 参数  ^ 说明 ^
| 任意数字 | 作为显示的最大条目数，默认为 8 |
| reverse    | 从订阅源中最新的条目开始显示 |
| author     | 显示条目的作者名 |
| date       | 显示条目的日期 |
| description| 显示条目描述，所有 HTML 标签将被去除 |
| nosort     | 不对订阅源中的条目进行排序 |
| //n//[dhm] | 刷新周期，d=天、h=小时、m=分钟（例如 12h = 12 小时） |

刷新周期默认为 4 小时，小于 10 分钟的值按 10 分钟处理。[[wiki:DokuWiki]] 通常尽量提供页面的缓存版本，但当页面包含动态外部内容时这显然不合适。该参数会告诉[[wiki:DokuWiki]]：如果距上次渲染已超过//刷新周期//，则重新渲染页面。

默认情况下，订阅源按日期排序，最新的在前。使用''reverse''参数可以按从旧到新排序，使用''nosort''则按原样显示。

**示例：**

  {{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 在每次访问时重新渲染页面 |

===== 语法插件 =====

DokuWiki 的语法可以通过[[doku>plugins|插件]]扩展。除内置语法外，本站还安装了以下语法插件，下面逐一介绍其用途与语法。

==== 容器：Ad-Hoc Wrap（adhocwrap）====

**用途**：把一段内容包进带样式的容器框（提示框、警告框等），兼容原 WRAP 插件的写法。

**语法**：
<code>
<WRAP 类名>内容……</WRAP>
<block 类名>内容……</block>   块级容器
<inline 类名>内容……</inline>  行内容器
</code>

常用类名：''box''（普通框）、''tip''（提示）、''important''（重要）、''alert''（警告）、''help''（帮助）、''download''（下载）、''todo''（待办）。

**示例**：

<WRAP box>这是一个普通提示框。</WRAP>

<WRAP tip>这是一条提示。</WRAP>

<WRAP important>这是重要内容。</WRAP>

<WRAP alert>这是警告。</WRAP>

==== HTML 标签：Ad-Hoc HTML（adhoctags）====

**用途**：安全地插入白名单内的 HTML 标签，比「禁用 HTML」更灵活、比「允许 HTML」更安全。

**当前白名单**（可在配置管理器的 adhoctags 设置中修改）：''b''、''aside''、''i''、''section''、''s''、''figure''、''u''、''figcaption''、''q''、''abbr''、''mark''。

**语法**：
<code>
<mark>高亮文字</mark>
<q>短引用</q>
<abbr title="说明">缩写</abbr>
<figure><figcaption>图片说明</figcaption></figure>
</code>

**示例**：<mark>这是高亮</mark>，<q>这是短引用</q>，<abbr title="音乐游戏（Music Game）">MUG</abbr>。

==== 数学公式：Ad-Hoc MathML（adhocmathml）====

**用途**：插入 MathML 数学公式（依赖 adhoctags，公式在支持 MathML 的浏览器中渲染）。

**语法**：
<code>
<math display="block">
  <mfrac><mi>a</mi><mi>b</mi></mfrac>
</math>
</code>

**示例**：<math><msup><mi>x</mi><mn>2</mn></msup><mo>+</mo><msup><mi>y</mi><mn>2</mn></msup><mo>=</mo><msup><mi>z</mi><mn>2</mn></msup></math>

==== 相册：Gallery（gallery）====

**用途**：把某个媒体命名空间（或 RSS/ATOM 源）下的图片以缩略图网格展示，支持灯箱浏览。

**语法**：
<code>
{{gallery>命名空间?选项}}
{{gallery>arcade:maimai?lightbox}}
</code>

**常用选项**（用 ''?'' 或 ''&'' 分隔，可组合）：

^ 选项 ^ 说明 ^
| ''lightbox'' | 点击缩略图在灯箱中查看大图（本站默认开启） |
| ''crop'' | 缩略图按比例裁剪（本站默认开启） |
| ''cache'' | 缓存相册输出（本站默认开启） |
| ''left'' / ''right'' / ''center'' / ''full'' | 相册对齐方式 |
| 数字（如 ''3''） | 每行列数 |
| ''=20'' | 最多显示 20 张图片 |
| ''+5'' | 跳过前 5 张 |
| ''200x150'' | 缩略图尺寸（小写 x） |
| ''200X150'' | 灯箱大图尺寸（大写 X） |
| ''titlesort'' / ''datesort'' / ''modsort'' / ''random'' | 按标题 / 日期 / 修改时间 / 随机排序 |
| ''reverse'' | 倒序显示 |
| ''showtitle'' / ''showname'' / ''showcaption'' | 显示标题 / 文件名 / 图片说明 |
| ''*通配*'' | 只显示匹配的文件名 |

==== 信息框：Infobox（infobox）====

{{infobox>
name = 示例信息框
image1 = wiki:dokuwiki-128.png | 示例图片
类型 = 音乐游戏
发行时间 = 2024年1月1日
::: 子分组 :::
子字段 = 值
}}

**用途**：生成作品 / 角色资料卡，支持多图切换、分组、折叠、剧透模糊等，适合放在页面开头。

**语法**：
<code>
{{infobox>
name = 作品名
image1 = ns:图片.png | 图片说明
字段名 = 值
::: 子分组名 :::
子字段 = 值
divider = 分隔文字
= 全宽内容 =
}}
</code>

**说明**：
  * ''name'':信息框标题；''class'':自定义 CSS 类名；''header_image'':标题上方的大图
  * ''image1''、''image2''……：图片，多张时可点击切换，''|'' 后可加说明
  * 普通行：''字段名 = 值''，值内可使用 DokuWiki 语法
  * ''::: 子分组名 :::''：开始一个子分组
  * ''== 章节名 ==''：开始一个章节；''=== 章节名 ===''：开始一个默认折叠的章节
  * ''divider = 文字''：插入分隔条
  * ''= 全宽内容 =''：插入占一整行的内容
  * 字段名或值以 ''!'' 开头（如 ''!剧透字段 = !秘密值''）可做成点击显示的模糊（剧透）效果

==== 折叠区块：Folded（folded）====

**用途**：把大段内容折叠起来，点击标题展开/收起（适合长列表、剧透、补充说明等）。

**语法**：
<code>
++++ 点击展开的标题 |
被折叠的内容……
++++
</code>

**示例**：

++++ 点击展开示例 |
这是折叠起来的内容，点击上方标题即可展开。
++++

==== 系统信息宏：Info（info）====

**用途**：在页面中输出系统内部信息，多用于调试或自动生成列表。

**常用宏**：
<code>
~~INFO:syntaxplugins~~  语法插件列表
~~INFO:adminplugins~~   管理插件列表
~~INFO:actionplugins~~  动作插件列表
~~INFO:helperplugins~~  辅助插件列表
~~INFO:hooks~~          事件钩子列表
~~INFO:datetime~~       当前时间
</code>

==== 曲目一览：Song Info（songinfo）====

**用途**：每首歌渲染为一行卡片——**曲绘在最左边**，右侧依次是歌曲标题、曲师与难度标签。多个块连续排列即形成曲目一览表，适合做音游曲目列表。

**语法**（字段顺序可随意，''type'' 之后还可以继续写 ''collection''、''difficulties''、''date'' 等）：
<code>
{{songinfo>
name = 光
image = illustration:phigros:光.姜米條.0.png
artist = 姜米條
type = phigros
collection = 过去的章节
difficulties = EZ 2 | HD 7 | IN 12
date = 2019/08/31
}}
</code>

**示例**（真实歌曲渲染效果）：

{{songinfo>
name = 光
image = illustration:phigros:光.姜米條.0.png
artist = 姜米條
type = phigros
collection = 过去的章节
difficulties = EZ 2 | HD 7 | IN 12
date = 2019/08/31
}}

**字段说明**：
  * ''name''：歌曲名（加粗）
  * ''image''：曲绘图片（媒体命名空间路径，可省略；固定高度 90px、保持原始比例、直角）
  * ''artist''：曲师（可省略；位于标题右侧、弱化显示）
  * ''difficulties''：难度列表，用 ''|'' 分隔，每个难度显示为一个小标签（可省略）
  * ''date''：更新日期（可省略，格式如 ''0000/00/00''），显示在卡片右下角
  * ''collection''：所属作品集（可省略），显示在卡片右上角
  * ''type = phigros''（可省略）：启用 Phigros 风格——整行使用 Saira 字体；难度标签为带阴影的平行四边形，''AT'' 灰、''IN'' 红、''HD'' 蓝、''EZ'' 绿，其他未知难度与 AT 同色

==== 章节选择：Chapter Select（chaptersel）====
**用途**：每个章节渲染为一行卡片——**封面图在最左边**，右侧是章节名与副标题；**整张卡片可点击**跳转到章节页面。适合做章节索引页。

**语法**：
<code>
{{chaptersel>
name = 过去的章节
image = illustration:phigros:光.姜米條.0.png
subtitle = Chapter Legacy
count = 20 首
link = phigros:曲目一览:过去的章节
type = phigros
}}
</code>

**示例**（真实章节卡片渲染效果）：

{{chaptersel>
name = 过去的章节
image = illustration:phigros:光.姜米條.0.png
subtitle = Chapter Legacy
count = 20 首
link = phigros:曲目一览:过去的章节
type = phigros
}}

**字段说明**：
  * ''name''：章节名（加粗，样式与 songinfo 标题一致）
  * ''image''：封面图（媒体命名空间路径，可省略；固定高度 90px、保持原始比例）
  * ''subtitle''：副标题（可省略，如 ''Chapter 5''）
  * ''count''：曲目数量（可省略，如 ''7 首''），显示在卡片右下角
  * ''link''：目标页面（可省略）；填写后整张卡片（含封面图）都可点击跳转
  * ''type = phigros''（可省略）：整卡使用 Saira 字体