配置AsciiDoctor Maven插件以生成单个PDF文件

Question

有没有一种方法可以配置AsciDoctor Maven插件，从许多.adoc文件中生成一个PDF文件？

目前，它只是简单地将ASCII文件的结构转换为相同的结构，但使用PDF。我想要一个单独的文件，当我点击链接时，它会将我移动到同一PDF中的目标位置。使用Maven插件这可能吗？

我当前的pom.xml：

...
<plugin>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctor-maven-plugin</artifactId>
<version>2.2.2</version>
<dependencies>
<dependency>
<groupId>org.asciidoctor</groupId>
<artifactId>asciidoctorj-pdf</artifactId>
<version>2.1.4</version>
</dependency>
</dependencies>
<configuration>
<sourceDirectory>documentation</sourceDirectory>
<outputDirectory>target/pdf-doc</outputDirectory>
<backend>pdf</backend>
<preserveDirectories>true</preserveDirectories>
</configuration>
<executions>
<execution>
<id>generate-pdf-doc</id>
<phase>generate-resources</phase>
<goals>
<goal>process-asciidoc</goal>
</goals>
<configuration>
<backend>pdf</backend>
<attributes>
<source-highlighter>rouge</source-highlighter>
<icons>font</icons>
<pagenums/>
<toc/>
<idprefix/>
<idseparator>-</idseparator>
</attributes>
</configuration>
</execution>
</executions>
</plugin>
...

Answer 1

您需要将单个文章聚合为单个文章，如：

:toc: macro
:toclevels: 3
:toc-title: Contents
:doctype: book
:chapter-label:
toc::[]
:doctype: book
include::article1.adoc[]
include::article2.adoc[]
...

并设置maven插件来编译单个adoc:

<configuration>
<sourceDocumentName>single.adoc</sourceDocumentName>
</configuration>

---

似乎Q更多地是关于asciidoc而不是maven。。。

我相信为了支持文档链接，我们需要创建具有唯一名称的锚点，比如：

building-toool.adoc:

[#building_tool]
= Building tool
== Status
Accepted

cloud.adoc:

[#cloud]
= Cloud
== Status
Accepted

adr-log.adoc:

| 08/07/2022
| xref:adr/building-tool.adoc#building_tool[Building tool]
| Accepted
| 08/07/2022
| xref:adr/cloud.adoc#cloud[Cloud]
| Accepted