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