如何将带有 "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[]
我正在使用 gradle
和 asciidoc plugin
,如 spring documentation 中所述。
有了这个,我可以 运行 gradle
任务来生成完整的文档并获得 html
输出。
我想做的是将此文档作为 asciidoc
包含到 github wiki
中,这就是为什么我需要将完整文档编译到 adoc
文件而不是 html
。有办法吗?
从 Asciidoctor 扩展实验室查看此脚本:https://github.com/asciidoctor/asciidoctor-extensions-lab/blob/master/scripts/asciidoc-coalescer.rb。它并不完美,但它是一个开始。
我正在使用 spring-restdocs 为项目生成文档。 asciidoc
主文档包含其他 adoc
片段,描述 request
/response
,例如:
include::{snippets}/projects/findOne_info/1/http-response.adoc[]
我正在使用 gradle
和 asciidoc plugin
,如 spring documentation 中所述。
有了这个,我可以 运行 gradle
任务来生成完整的文档并获得 html
输出。
我想做的是将此文档作为 asciidoc
包含到 github wiki
中,这就是为什么我需要将完整文档编译到 adoc
文件而不是 html
。有办法吗?
从 Asciidoctor 扩展实验室查看此脚本:https://github.com/asciidoctor/asciidoctor-extensions-lab/blob/master/scripts/asciidoc-coalescer.rb。它并不完美,但它是一个开始。