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

Question

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

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

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

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

Answer 1

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

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

编辑：

此外，GitBookIO支持 asciidoctor。