文档站演示→使用手册 →

HTML 原稿演示

使用手册 · 2026-09-28

这篇原稿本身就是 HTML。渲染时只取 <body> 内的部分,套上集合指定的壳; 上面那段 <style> 里的 .leak 规则不会进入成品页面, 所以下面这句应当是普通文字颜色。

如果你看到红色加粗,说明访问到的是原稿而不是成品 —— 那就是可达性泄漏,属于缺陷。

为什么不过 Markdown 引擎

Markdown 渲染器开着 breaks: true:源码里的单个换行会被转成 <br>。 手写 HTML 通常一行一个块元素,过一遍引擎就会平白多出大量换行、打乱排版。 所以 content_format='html' 的内容一律原样使用。

可达性对照

路径应否可达
/docs/plain.html是 —— 成品
/src/manual/plain.html否 —— 必须 404
/pages/docs/plain.html否 —— 内部 key,URL 里不该出现

回 欢迎页(相对链接会被改写成成品地址)。