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

Question

我正在使用 Atom Editor + 关于 asciidoctor 的两个插件/包。

• asciidoc 预览
• 语言-asciidoc

一切都按预期工作。但我有以下情况：

我的目录结构如下：

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[] 失败

注意：在子/子文档中，我需要添加其他数据如何注释、提示（警告），该子文档将被其他父母多次重复使用。所以我只需要参考图像。

谢谢

Answer 1

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

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

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

如果您想为图像建立一个共同的绝对基础，您还可以将:imagesdir: 属性设置为图像目录的基础 url。这也应该适用于实时预览：

• Asciidoctor Documentation Site