生成的PDF文档中没有图像从Asciidoc到PDF

如何解决生成的PDF文档中没有图像从Asciidoc到PDF

我正在使用asciidoctor-web-pdf从asciidoc生成PDF文档。到目前为止，大多数任务都可以正常工作。

asciidoctor-web-pdf -a stylesheet="asciidoctor-pdf/css/asciidoctor.css,asciidoctor-pdf/css/document.css,assets/pdf-export/custom.css" \
                    -a stem \
                    --require asciidoctor-kroki \
                    docs/modules/ROOT/pdf.adoc

但是我的文档不包含图像或生成的图表（植物图）。

文件夹结构遵循Antora的布局，因为我主要使用Antora。 PDF只是必要的副产品。

我的文件夹结构如下所示（如antora-layout所示）：

project-folder
+ docs
| + modules
| | + ROOT
| | | + assets
| | | | + images
| | | | | - logo.png
| | | + pages
| | | | - index.adoc
| | | | - 01-intro.adoc
| | | | - some-other.adoc
| | | - nav.adoc
| | | - pdf.adoc

pdf.adoc只是包含项的列表，以确保每个所需的adoc文件都属于PDF。

根据文件夹结构，我的logo.png的正确路径是docs/modules/ROOT/assets/images/logo.png（或绝对/home/sebastian/work/workspace/workspace-p/jira-ops-manual/docs/modules/ROOT/assets/images/logo.png）。

使用上述命令生成PDf时，出现以下错误：

1. 正常图像

Failed to load resource: net::ERR_FILE_NOT_FOUND at file:///home/sebastian/work/workspace/workspace-provinzial/jira-ops-manual/docs/modules/ROOT/logo-provinzial.png:1

1. 植物图

asciidoctor: ERROR: pages/04-system-setup/index.adoc: line 8: include file not found: /home/sebastian/work/workspace/workspace-provinzial/jira-ops-manual/docs/modules/ROOT/pages/04-system-setup/image$04-system-setup/system-overview.puml

我想问题是asciidoctor-web-pdf不能替代路径的image$...部分，因此引用是错误的（或者通常无法解析这些引用）。图像和图表是这样嵌入的：

image::logo.png[logo,align="center"]

[plantuml,system-overview-plantuml-image,svg]
----
include::image$04-system-setup/system-overview.puml[]
----

有人提示如何解决我的问题吗？我也欢迎其他解决方案。也许使用antora可以有一种更简单的方法，所以我根本不需要asciidoctor-web-pdf？

---

编辑：我通过将图像路径设置在pdf-adoc的顶部来解决了普通图像的问题。

= Operations Manual
:imagesdir: ./assets/images

include::pages/index.adoc[]

include::page1.adoc[]

include::page2.adoc[]

...

But the problem with the plantuml images still exists.

：imagesdir：./assets/images

解决方法

首先，我会发表评论，但我没有50个声誉-所以我回答……有点：

您必须知道asciidoc-web-pdf仍在积极开发中，我无法想象它在Antora旁边没有得到很好的测试。在此讨论中，您将获得一些见解： https://discuss.asciidoctor.org/Single-PDF-and-multiple-HTML-from-same-sources-td7640.html

话虽这么说，我会减少复杂性（如果是Antora，则将其构建出来）并逐步进行构建。然后，继续下一步。