使用Spring rest文档，您可以生成一系列不错的asciidocs作为单独的代码片段。
http://www.baeldung.com/spring-rest-docs在描述我遵循的过程方面做得很好。
生成代码片段后，按照教程，我使用asciidoctor-maven-plugin将它们组合为一个文档文件。
有没有一种方法可以生成单个.adoc文件而不是前面提到的html文件？
在配置中，它允许您使用以下命令指定“后端”：
<backend>html</backend>
http://asciidoctor.org/docs/convert-documents/#selecting-an-output-format
https://github.com/asciidoctor/asciidoctor-maven-plugin
...但是我想保留asciidoc作为最终文件格式。
我发现的最接近的评论是：https://github.com/asciidoctor/asciidoctor/issues/168#issuecomment-58861372
...但是我不太了解如何将其应用于我的情况。
最佳答案
如果我理解您的链接正确，则无法将提供的解决方案与maven插件一起使用。目前，它不支持导出asciidoctor文件。你必须
安装ruby和ascidoctor gem
下载脚本https://raw.githubusercontent.com/asciidoctor/asciidoctor-extensions-lab/master/scripts/asciidoc-coalescer.rb
使用ruby asciidoc-coalescer.rb your_file_name.adoc> single_file.adoc运行脚本
祈祷脚本能够正常工作，并且您不会遇到提到的发布线程的麻烦。您的输出应该在single_file.adoc中