AsciiDoc导航面板

Question

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

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

​

​

不是一份内容清单。

​

​

谢谢。

Answer 1

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

要做到这一点，您需要一个工具来处理许多Asciidoc文件并生成一个完整的站点。这种工具被称为静态站点生成器。有很多，也有相当多的支持Asciidoc标记，包括Hugo、Jekyll和11。

Asciidoctor文档是通过一个名为安托拉的工具生成的，该工具是由asciidoctor的作者创建的。它的目标是专门支持从Asciidoc标记生成技术文档网站(最终还包括PDF文档)。

许多拥有大量技术文档的公司使用Antora。此页列出了使用Antora的公司和站点，以及带有实现的公共repos (如果可用的话)。