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

How to compile Asciidoc document with "include" sections into a single adoc file

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

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

我正在使用 gradleasciidoc plugin,如 spring documentation 中所述。

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

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

从 Asciidoctor 扩展实验室查看此脚本:https://github.com/asciidoctor/asciidoctor-extensions-lab/blob/master/scripts/asciidoc-coalescer.rb。它并不完美,但它是一个开始。