如何将带有“include”部分的Asciidoc文档编译到单个adoc文件中

Question

我正在使用spring-restdocs为项目生成文档。主要的asciidoc文件包括描述adoc / request的其他response片段：

include::{snippets}/projects/findOne_info/1/http-response.adoc[]

我正在使用gradle中描述的asciidoc plugin和spring documentation。

有了这个，我可以运行gradle任务来生成完整的文档并获得html输出。

我想要做的是，我想将此文档作为github wiki包含在asciidoc中，这就是为什么我需要将完整的文档编译到adoc文件而不是html。有没有办法做到这一点？

Answer 1

请参阅Asciidoctor扩展实验室的这个脚本：https://github.com/asciidoctor/asciidoctor-extensions-lab/blob/master/scripts/asciidoc-coalescer.rb。它并不完美，但它是一个开始。