AsciiDoc 导航面板

Question

我如何在 AsciiDoc 中创建左侧导航面板？

就像这里的https://docs.asciidoctor.org/asciidoc/latest/

不是内容列表。

谢谢。

Answer 1

屏幕截图中的导航窗格包含许多 HTML 文件的链接。 asciidoctor 没有任何用于从 Asciidoc 标记文件生成多个 HTML 文件的内置工具。

要为您自己的 Asciidoc 内容执行此操作，您需要一个能够处理许多 Asciidoc 文件并生成整个站点的工具。此类工具称为静态站点生成器。有很多，相当多的支持 Asciidoc 标记，包括 Hugo、Jekyll 和 Eleventy。

Asciidoctor 文档是使用名为Antora 的工具生成的，该工具由asciidoctor 的作者创建。它的目标是专门支持从 Asciidoc 标记生成技术文档网站（以及最终的 PDF 文档）。

许多拥有大量技术文档的公司都使用 Antora。 This page 列出了使用 Antora 的公司和站点，以及带有实现的公共回购协议（如果可用）。