路径困境：解决 AsciiDoctor PDF 和 Hugo 之间的图像渲染差异

Question

我使用 AsciiDoctor PDF 编写文档。 Hugo 还将为公司内部网站处理相同的 .adoc 文件。然而 Hugo 和 Asciidoctor 对图像路径的理解不同。

图像与 adoc 文件位于同一路径。

:imagedir:

没有值可以在使用 asciidoctor-pdf 创建的 PDF 中正确呈现图像，但不能在 Hugo 中呈现为网页。

:imagedir: ../

在 Hugo 网站中正确呈现图像，但不再在 PDF 中呈现图像。

网址是

http://localhost:1313/.../2024-04/protokoll-04-2024/

URL 的最后一部分是 adoc 文件的名称。因此，图像的路径更高一级也许是有道理的：

<img src="../image01">

。但这不适合 PDF 的创建。

我理解不正确的是什么？每次为 Hugo 或 PDF 设置 :imagedir: 值非常繁琐。

是否可以在调用 AsciiDoctor PDF 时将参数传递给它，以便 :imagedir: 的值会相应调整？

我还没有找到解决办法。当我将图像保存在子目录中时，也会出现同样的问题。 Hugo 和 AsciiDoctor 对路径的解释不同。 Hugo 总是需要更高的目录级别。

Answer 1

AsciiDoc 包含内在属性，用于定义调用哪个后端处理器来处理文件。 Hugo 将使用

html5

后端。

在使用 .adoc 后端时，您可以在

imagesdir

文件中使用

条件语句

来定义

html5

属性。

例如：

ifdef::backend-html5[]
:imagesdir: ../
endif::[]