html - Asciidoc 仅在 toc 中添加指向另一个 html 文件的链接

Question

我有一个基础 asciidoc 文件，我想在其中引用其他 html 文件。在我当前的解决方案中，我通过将它们全部包含在一个页面上并添加对 toc 的引用来呈现它们。这在一个非常长的可滚动页面中搞砸了。这通常很好，但我更喜欢以下内容：

对于每个附加的 html，我只想添加对 toc 的引用。当点击这个 ref 时，我只想渲染特定的 html。

有没有办法使用模板 toc 做到这一点，还是我必须使用自定义解决方案？

标签： htmlasciidocasciidoctor

Answer 1

您所要求的（我认为）是每个 Asciidoc 标记文件一个 HTML 页面，它们之间有一个共同的 TOC/导航。通常，这种能力称为“分块”，至少 DocBook 采用这种方式。

不幸的是，asciidoctor没有分块功能。如果您有多个 Asciidoc 文件，可以轻松地将它们转换为 HTML，但组装一个通用 TOC 是额外的工作。此外，不处理 Asciidoc 页面之间的交叉引用链接。

您可能有兴趣了解 Antora ( https://antora.org/ )。它从一个或多个包含 Asciidoc 标记文件的 Git 存储库生成一个静态 HTML 站点，每个 Asciidoc 页面都成为一个 HTML 页面，并且有一个通用的 TOC 和交叉引用链接。对于您当前的情况，这很可能是一个很好的解决方案。