从 asciidoc 文件创建模块化站点的正确方法是什么？

Question

我有很多用 AsciiDoc 编写的文档并正确地分成文件夹。我使用带有自定义 CSS 的 asciidoctor 将我的文档呈现为 HTML。这样做的问题是它会生成一个单个 HTML 页面，该页面非常 长。我在网上冲浪，发现 atom docs 也是用 AsciiDoc 编写的，但是这些 docs 并没有把所有的信息放在一起，实际上它们被分成了不同的部分。

这里是 atom 文档：https://atom.io/docs/v0.201.0/getting-started-why-atom

我想知道是否有工具可以生成这个，一个标志或一个特定的语法。

我认为将所有信息放在一个长长的单页中并不是真正的用户友好。

Answer 1

我有一个使用asciidoctor-jekyll 插件和jekyll 生成静态内容的网站。

我还插入了 java 版本的 asciidoctor 以在某些时候使用播放框架生成视图，但我决定我更喜欢使用 asciidoctor 生成的内容是静态的并由 CDN 交付。

编辑：

另外，GitBookIO 支持 asciidoctor。