如何将包含"include"节的 Asciidoc 文档编译成单个 adoc 文件



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

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

我正在使用 Spring 文档中描述的gradleasciidoc plugin

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

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

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