Создание документации ascii doc api из документов весеннего отдыха

Используя документы 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

... но я не совсем понимаю, как применить это к моей ситуации.


person Joseph    schedule 04.01.2018    source источник


Ответы (1)


Если я правильно понимаю вашу ссылку, вы не можете использовать предоставленное решение с плагином maven. На данный момент он не поддерживает экспорт asciidoctor-файлов. Вы должны

  1. установить рубин и гем ascidoctor
  2. загрузите скрипт https://raw.githubusercontent.com/asciidoctor/asciidoctor-extensions-lab/master/scripts/asciidoc-coalescer.rb
  3. запустите скрипт с ruby ​​asciidoc-coalescer.rb your_file_name.adoc > single_file.adoc
  4. молитесь, чтобы скрипт работал, и вы не столкнулись с проблемами, упомянутыми в теме, которую вы разместили. Ваш вывод должен быть в single_file.adoc
person EhmKah a.k.a. Michael Krauße    schedule 04.01.2018
comment
Благодарю за ваш ответ. Стало ясно, что нужно искать другое решение. - person Joseph; 08.01.2018