Неразрешенная ошибка директивы при использовании плагина Asciidoctor Maven для публикации документации API в формате HTML

Question

Я успешно использую Spring RestDocs, чтобы написать тест и сгенерированные фрагменты.

Когда я использую Asciidoctor Maven plugin для публикации документации API в формате HTML генерируется документ HTML.

Тем не менее, HTML показывает следующую ошибку. Кажется, что мое включение не работает, как ожидалось. Интересно, что может быть не так.

Неразрешенная директива в api-guide.adoc - включает::/opt/caweb/ мысленные работы /go-agent/pipelines/xxx_Build/xxx-source/target/generate-snippets / creation-grouping/curl-request.adoc[]

Вот разделы asciidoctor-maven-plugin и maven-resources-plugin в POM.xml:

<plugin> 
            <groupId>org.asciidoctor</groupId>
            <artifactId>asciidoctor-maven-plugin</artifactId>
            <version>1.5.2</version>
            <executions>
                <execution>
                    <id>generate-docs</id>

                    <phase>prepare-package</phase> 
                    <goals>
                        <goal>process-asciidoc</goal>
                    </goals>
                    <configuration>
                        <backend>html</backend>
                        <doctype>book</doctype>
                        <attributes>
                            <snippets>${project.build.directory}/generated-snippets</snippets>
                        </attributes>
                    </configuration>
                </execution>
            </executions>
        </plugin>

        <plugin>
            <artifactId>maven-resources-plugin</artifactId>
            <version>2.7</version>
            <executions>
                <execution>
                    <id>copy-resources</id>
                    <phase>prepare-package</phase>
                    <goals>
                        <goal>copy-resources</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${project.build.outputDirectory}/static/docs</outputDirectory>
                        <resources>
                            <resource>
                                <directory>${project.build.directory}/generated-docs</directory>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>

Вот раздел включения моего api-guide.adoc:

include::{snippets}/create-grouping/curl-request.adoc[]

Спасибо за помощь!

Answer 1

Я решил это, изменив фазу асцицидора с prepare-package на package

Answer 2

Вы настраиваете свой верный плагин для включения файлов документации?

https://github.com/spring-projects/spring-restdocs/blob/master/docs/src/docs/asciidoc/getting-started.adoc

Проверьте здесь