图片目录的位置路径由 imagesdir 属性控制。

图片目录属性语法

imagesdir` 是一个文档属性。它的值会自动添加到每个图像宏目标的开始位置。图像的解析位置是:<imagesdir的值>
<图像宏目标>``
。因此,你在图像宏中永远不需要引用这个属性。你只需要在文档头部设置它。

不正确
image::{imagesdir}/name-of-image.png[]
正确
image::name-of-image.png[]

imagesdir`的值可以是绝对路径、相对路径或URL。默认情况下,`imagesdir`的值为空。这意味着图像的解析是相对于文档的。如果图像宏的目标是绝对路径或URL,则不会在目标路径前加上`imagesdir`的值。

处理器将`imagesdir`的值添加到所有图像目标的开头的好处是,你可以全局控制每个转换器定位图像的文件夹。我们将这个文件夹称为图像目录。由于不同的输出格式要求将图像存储在不同的位置,这个属性使得能够适应许多不同的场景。

我们建议在定义图像的目标时依赖`imagesdir`,以避免在每一个图像宏中硬编码那个公共路径。始终要考虑图像相对于图像目录的位置。

Tip
在文档中的多个地方可以设置`imagesdir`属性,只要它没有被API锁定。 如果您将文档的不同部分、章节或节的图像存储在不同位置,这种技术会非常有用。