狸村 Mystic Web · 狸村
目录

AsciiDoc 由 Asciidoctor 渲染:标题、目录、admonition、表格、源码块都和 Markdown 那套写法不同。

文档头

第一行的等号标题是文档标题,getDocTitle() 优先读它;没有才回退到文件名。

目录

构建时开了 toc: leftsectids,Asciidoctor 会自己生成目录块, prebuild.js 把它抽出来塞进 {} 占位符,所以这一页的目录和 Markdown 页表现一致。

提示块

Note
这是 NOTE。
Tip
这是 TIP。
Warning
这是 WARNING。

表格

写法 说明

单星号包裹

粗体(Markdown 里是双星号)

单下划线包裹

斜体

双反引号包裹

等宽字体

源码块

// AsciiDoc 的源码块同样会被 code-copy.js 加上复制按钮
const answer = 42;
console.log(answer);

数学

构建时已经设好 stem: latexmath。行内公式用 E=mc2E = mc^2,块级写成:

n=11n2=π26\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}

交叉引用

交叉引用页 会被 Asciidoctor 渲染成指向 02_交叉引用.html 的链接。

如果 xref 的目标不存在,fixXrefPaths() 会依次尝试:按目标目录的默认页面回退、 再按本根目录的第一个页面回退,都不行才保持原样并在构建日志里打印警告。

要指向 Markdown 生成的页面,请直接写 基础写法, 因为 xref 只处理 AsciiDoc 之间的引用。