Используя документы 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
... но я не совсем понимаю, как применить это к моей ситуации.