Генерация статической документации для Hybris Custom REST API - PullRequest
Новая
       12

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

0 голосов
/ 26 октября 2018

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

[артефакт: mvn] [main] ОШИБКА org.apache.maven.cli.MavenCli - Не удалось выполнить цель io.github.swagger2markup: swagger2markup-maven-plugin: 1.2.0: convertSwagger2markup (default-cli) в проекте документация по swagger: выполнение default-cli цели io.github.swagger2markup: swagger2markup-maven-plugin: 1.2.0: ошибка convertSwagger2markup: плагин io.github.swagger2markup: swagger2markup-maven-plugin: 1.2.0 или одна из его зависимостей не удалось разрешить: не удалось разрешить следующие артефакты: nl.jworks.markdown_to_asciidoc: markdown_to_asciidoc: jar: 1.0, ch.netzwerg: paleo-core: jar: 0.10.1: ошибка с поиском nl.jworks.markdown_to_asciidoc: markdown_to_ascid jar: 1,0 в https://repo.maven.apache.org/maven2 было кэшировано в локальном хранилище, разрешение не будет предприниматься повторно до тех пор, пока не истечет интервал обновления центрального сервера или принудительные обновления -> [Помощь 1]

1 Ответ

0 голосов
/ 01 ноября 2018

ОБНОВЛЕНИЕ : библиотека markdown-to-asciidoc не синхронизируется с 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?

...