Ascii-Doc插件(通过https包括资源)

Question

是否有方法将asciidoc plugin配置为包含https-资源？我做了一些研究，发现这些有趣的信息，但是，不能解决问题，根据提供的提示：

• https://github.com/asciidoctor/asciidoctor/issues/1049
• https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/153

后一个链接似乎解决了我所遇到的确切问题，但是升级/更改版本没有任何影响。

下面的pom.xml文件是允许您复制问题的最小工作示例：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>de.myproject</groupId>
  <artifactId>my-project</artifactId>
  <version>${revision}</version>
  <packaging>pom</packaging>

  <properties>
    <revision>1.0.0-SNAPSHOT</revision>
    <asciidoctor.maven.plugin.version>2.2.1</asciidoctor.maven.plugin.version>
    <asciidoctorj.diagram.version>2.2.0</asciidoctorj.diagram.version>
    <asciidoctorj.version>2.5.2</asciidoctorj.version>
    <jruby.version>9.2.17.0</jruby.version>
  </properties>

  <build>

    <plugins>
      <plugin>
        <groupId>org.asciidoctor</groupId>
        <artifactId>asciidoctor-maven-plugin</artifactId>
        <version>${asciidoctor.maven.plugin.version}</version>
        <executions>
          <execution>
            <id>output-html5</id> 
            <phase>generate-resources</phase>
            <goals>
              <goal>process-asciidoc</goal>
            </goals>
            <configuration>
              <sourceDirectory>src/main/docs</sourceDirectory>
              <outputDirectory>target/docs</outputDirectory>
              <backend>html5</backend>
              <doctype>book</doctype>
              <attributes>
                <safe-mode>UNSAFE</safe-mode>
                <allow-uri-read>true</allow-uri-read>
              </attributes>
            </configuration>
          </execution>
        </executions>
        <dependencies>
          <dependency>
            <groupId>org.asciidoctor</groupId>
            <artifactId>asciidoctorj</artifactId>
            <version>${asciidoctorj.version}</version>
          </dependency>
          <dependency>
            <groupId>org.jruby</groupId>
            <artifactId>jruby-complete</artifactId>
            <version>${jruby.version}</version>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
    
  </build>
  
</project>

现在，如果我将下面的..adoc文件保存到src/main/docs文件夹并运行mvn clean install，我只会在我的-project.adoc-包含而不是实际文档中得到一个未解决的通知指令：

= my-project
include::https://raw.githubusercontent.com/asciidoctor/asciidoctor/master/README.adoc[]

但是，如果我不加载上述文档(README.adoc)并在本地引用它，我将得到所需的结果。但这不是我想通过先下载文件，然后在本地引用文档的方式。

有人有主意吗？

Answer 1

其想法是只管理一个Maven项目，该项目包含所有文档，包括来自Gitlab存储库中的相关项目的文档。这就是为什么我想使用include::https://concreteURLToAdocFile在这些相关项目中引用..adoc文件的原因。

但是，我们意识到，最好使用maven-dependency-plugin首先从其他项目复制..adoc文件，然后在本地引用它们。

这个解决办法解决了我们的具体问题，但没有回答我原来的问题。