如何通过位于不同文件夹中的许多 .adoc 文件正确引用图像

Question

我正在使用 Atom Editor + 关于 asciidoctor 的两个 plugins/packages。

所有工作都按预期进行。但是我遇到以下情况：

我的目录结构如下：

xml
  figures
     findOneXml.adoc
     findOneXml.png
  urls
     findOne.adoc

其中 findOneXml.adoc（在 figures 文件夹中）有

[[findOneXml]]
image::findOneXml.png[caption="Figure - " title="findOneXml"]

通过实时预览，我可以看到图像及其相应的描述

现在 findOne.adoc（在 url 文件夹中）包含以下行：

include::../figures/findOneXml.adoc[]

我认为路径参考没问题。如果我使用其他，实时预览会显示有关无效或错误路径的错误消息。

但是通过实时预览，我看到图像损坏了，但我可以看到描述。

有什么错误或缺失？

即使include::./../figures/findOneXml.adoc[]失败

注意：在sub/child文档中我需要添加其他数据如何注释，提示（Admonition），child文档将被多次重复使用其他 parents。所以我只需要参考图像就可以了。

谢谢

Answer 1

图像是相对于 asciidoc 渲染引擎的内部基本路径解析的。在您的情况下，我假设引擎采用呈现的（主，父）文档的路径。因此，图像是相对于此解析的。尝试：

image::../figures/findOneXml.png[]

这应该适用于两个 adoc 文档，因为路径向上移动到父目录，然后明确向下移动到图形目录。

如果您希望图像有一个通用的绝对基址，您还可以将 :imagesdir: 属性设置为图像目录的基址 url。这应该也适用于实时预览：

How reference correctly images through many .adoc files located in different folders