Создание статической документации для Hybris Custom REST API

Как указано @ https://help.hybris.com/1808/hcd/99783546e09949e2b4bf27795b889464.html В разделе «Создание статической документации» я попытался использовать команду ant wsStaticDoc для создания статической документации созданных пользовательских API-интерфейсов, но она продолжает работать с ошибкой, приведенной ниже. Может ли кто-нибудь помочь мне выяснить, как я могу решить эту ошибку:

[artifact:mvn] [main] ERROR org.apache.maven.cli.MavenCli - Failed to execute goal io.github.swagger2markup:swagger2markup-maven-plugin:1.2.0:convertSwagger2markup (default-cli) on project swagger-documentation: Execution default-cli of goal io.github.swagger2markup:swagger2markup-maven-plugin:1.2.0:convertSwagger2markup failed: Plugin io.github.swagger2markup:swagger2markup-maven-plugin:1.2.0 or one of its dependencies could not be resolved: The following artifacts could not be resolved: nl.jworks.markdown_to_asciidoc:markdown_to_asciidoc:jar:1.0, ch.netzwerg:paleo-core:jar:0.10.1: Failure to find nl.jworks.markdown_to_asciidoc:markdown_to_asciidoc:jar:1.0 in https://repo.maven.apache.org/maven2 was cached in the local repository, resolution will not be reattempted until the update interval of central has elapsed or updates are forced -> [Help 1]

swagger hybris

26.10.2018 21:01

Документирование API с помощью Swagger на Springboot

В предыдущей статье мы уже узнали, как создать Rest API с помощью Springboot и MySql .

818

Ответы 1

ОБНОВИТЬ: markdown-to-asciidoc lib не синхронизируется с Maven Central

Выпуск - https://github.com/bodiam/markdown-to-asciidoc/issues/26

Возможное решение - https://github.com/bodiam/markdown-to-asciidoc/issues/26#issuecomment-371997400

Задача wsStaticDoc использует плагины maven для создания документации.

        <artifact:mvn pom = "@{templateDir}/pom.xml" fork = "true" failonerror = "true" mavenVersion = "3.2.5">
            <arg value = "io.github.swagger2markup:swagger2markup-maven-plugin:convertSwagger2markup" />
            <arg value = "org.asciidoctor:asciidoctor-maven-plugin:process-asciidoc" />
            <arg value = "-Dswagger.input=@{swaggerInput}" />
            <arg value = "-Ddoc.generated=@{tempDir}" />
            <arg value = "-Dasciidoctor.input.directory=@{templateDir}/asciidoc" />
            <arg value = "-Ddoc.output=@{outputDir}" />
            <jvmarg line = "${env.MAVEN_OPTS} ${env.JAVA_OPTS}" />
        </artifact:mvn>

Неразрешенный артефакт действительно доступен (https://repo.maven.apache.org/maven2/ca/szc/thirdparty/nl/jworks/markdown_to_asciidoc/markdown_to_asciidoc/1.0/) Скорее всего, у вас возникли проблемы с сетью с maven central.

Есть ли у вас особые настройки в ~ / .m2 / settings.xml?

Кажется, я нашел на своей машине любую папку .m2. :(

— 01.11.2018 16:35

Убедитесь, что в вашем редакторе файлов отображаются скрытые файлы. В любом случае, настоящая причина, по которой это не работает для вас, описана здесь - github.com/bodiam/markdown-to-asciidoc/issues/26 Проверьте комментарий github.com/bodiam/markdown-to-asciidoc/issues/… для возможного решения.

— 02.11.2018 10:56

01.11.2018 15:11