从spring文档生成ascii docs文档

Question

使用Spring文档，您可以生成一系列不错的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

...but我想把asciidoc作为最终的文件格式。

我发现的最接近的评论是：https://github.com/asciidoctor/asciidoctor/issues/168#issuecomment-58861372

...but我不太明白如何把它应用到我的情况中。

Answer 1

如果我理解你的链接正确，你不能使用提供的解决方案与maven插件。目前，它不支持导出asciidoctor文件。你不得不

1. 安装ruby和ascidoctor宝石
2. 下载脚本https://raw.githubusercontent.com/asciidoctor/asciidoctor-extensions-lab/master/scripts/asciidoc-coalescer.rb
3. 使用ruby colecescer.rb your_file_name.adoc > single_file.adoc运行脚本
4. 祷告这个剧本行得通，不要遇到你发的帖子所提到的麻烦。您的输出应该在single_file.adoc中