差别

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

--- wiki:syntax [2026/08/17 08:58] – 外部编辑 127.0.0.1
+++ wiki:syntax [2026/08/17 13:24] (当前版本) – 外部编辑 127.0.0.1
@@ 行 479: / 行 479: @@
 ===== 语法插件 =====
-DokuWiki 的语法可以通过[[doku>plugins|插件]]扩展。已安装插件的用法在其各自的说明页中有介绍。以下语法插件可用于当前这个 DokuWiki 安装：
+DokuWiki 的语法可以通过[[doku>plugins|插件]]扩展。除内置语法外，本站还安装了以下语法插件，下面逐一介绍其用途与语法。
-~~INFO:syntaxplugins~~
+==== 容器：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 字体