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

Question

我有很多文档在asciidoc中写入并正确分成文件夹，我使用带有自定义css的asciidoctor解析器将我的文档呈现为HTML。这个问题是它生成了一个非常（非常）长的单个HTML页面，我在网上冲浪并发现原子文档也是用asciidoc编写的，但是这个文档并没有将所有信息放在一起，实际上它们在不同的部分分开。

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

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

我认为在长单页中包​​含所有信息并不是真的用户友好。

提前致谢。胡安

Answer 1

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

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

编辑：

此外，GitBookIO支持asciidoctor。