图像资源ID示例

大多数您使用图像宏引用的图像可能属于同一模块和组件版本与当前页面相同。在这种情况下，AsciiDoc图像宏只需要将目标图像的资源ID的文件坐标分配为一个值。

目标图像的文件坐标结构取决于目标图像是存储在images家族目录的根目录还是images目录的子目录中。

以下部分提供了显示不同文件坐标结构的示例。

当目标图像和当前页面不属于同一模块时，您必须在图像宏中指定目标图像的模块坐标和文件坐标。

让我们使用在示例 9中显示的组件版本中的文件作为本节示例的基础。

从colorado 5.2组件版本中，如上所示的示例 9，让我们将peak.svg图像插入到willow-creek.adoc页面中。这意味着源文件peak.svg是目标图像，willow-creek.adoc是当前页面。

willow-creek.adoc（当前页面）中的内联图像宏如示例 10所示，引用了图像文件peak.svg（目标图像）。目标图像的资源ID的模块和文件坐标被分配给图像宏。页面willow-creek.adoc属于la-garita模块。图像peak.svg属于ROOT模块。

如示例 10所示，目标图像的模块坐标为ROOT，文件坐标为peak.svg。

在示例 11中，让我们将skyline.jpg图像（目标图像）嵌入到ranges.adoc（当前页面）中。图像skyline.jpg属于la-garita模块，ranges.adoc属于ROOT模块。

如示例 11所示，目标图像的模块坐标为la-garita，文件坐标为aerial/skyline.jpg，因为它存储在images家族目录的aerial子目录中。

当目标图像和当前页面属于不同的文档组件时，您必须在图像宏中至少指定目标图像的组件、模块和文件坐标，通常也会指定版本坐标。

让我们使用属于组件版本 colorado 5.2 (示例 13) 和 wyoming 1.0 (示例 14) 的文件作为本节示例的基础。

使用来自 示例 13 和 示例 14 的文件，让我们将 panorama.png（目标图像）插入到 ranges.adoc（当前页面）中。图像 panorama.png 属于 wyoming 1.0 的 sierra-madre 模块。在 示例 15 中，分配给图像宏的资源 ID 指定了目标图像的版本、组件、模块和文件坐标，因为目标图像属于 wyoming 1.0 组件版本，而当前页面属于 colorado 5.2。

如 示例 15 所示，目标图像的版本坐标为 1.0，组件坐标为 wyoming，模块坐标为 sierra-madre，文件坐标为 panorama.png。

现在，在 示例 16 中，让我们将 peak.svg（目标图像）插入到 wilderness-areas.adoc（当前页面）中。 peak.svg 图像属于组件版本 colorado 5.2。 wilderness-areas.adoc 页面属于组件版本 wyoming 1.0。

请注意，在 示例 16 中，资源 ID 中似乎缺少模块坐标 ROOT。当在资源 ID 中指定组件坐标，并且目标图像属于 ROOT 模块时，模块坐标 ROOT 不必显式指定。但仍需输入紧随模块坐标之后的冒号（:）。您可以在文件坐标 peak.svg 之前直接看到这个 :。这种简写仅在指定组件坐标且目标图像的模块坐标为 ROOT 时有效。在其他所有需要模块坐标的情况下，必须指定模块的名称。

您可能已经注意到，在 示例 15 和 示例 16 中都指定了版本坐标。如果不指定版本，Antora 将在运行时使用目标图像最新组件版本的版本坐标来完成目标图像的资源 ID。

当当前页面和目标图像属于同一组件，但目标图像属于组件的不同版本时，您需要指定版本、模块（如果与当前页面的模块不同）和文件坐标。

让我们以本节示例的基础使用属于组件版本 colorado 5.2（示例 20）和组件版本 colorado 6.0（示例 21）的文件。

请注意，示例 20 中的 colorado 5.2 组件版本具有图像 wilderness-map.jpg。然而，示例 21 中的 colorado 6.0 没有这样的图像文件。

让我们引用属于 colorado 5.2 的图像 wilderness-map.jpg（目标图像），从属于 colorado 6.0 组件版本的 ridge.adoc 页面（当前页面）。这两个资源都属于 la-garita 模块。在 示例 22 中，图像 wilderness-map.jpg（目标图像）嵌入在页面 ridge.adoc（当前页面）中。

如示例 22所示，目标图像的版本坐标为 5.2，文件坐标为 wilderness-map.jpg。