Table 1. 文档属性和值
属性 示例语法 备注

imagesdir

空,文件系统路径,或基础URL

:imagesdir: images

加在相对图像目标前面,如果需要,使用文件分隔符加以连接。 如果图像目标是绝对URL或路径,则不使用。 默认值为空。

Table 2. 块级和内联图像的属性及其值
属性 值(们) 示例语法 评论

id

用户自定义文本

id=sunset-img
(或 [[sunset-img]][#sunset-img] 在块宏之上)

alt

属性列表第一位置的用户自定义文本或命名属性

image::sunset.jpg[Brilliant sunset]
(或 alt=Sunset

fallback

相对于`imagesdir`的图像路径或绝对路径或URL

image::tiger.svg[fallback=tiger.png]

仅适用于目标是SVG并且opts=interactive的情况

title

用户自定义文本

在attrlist中:title="A mountain sunset"(如果值包含逗号则只需要引号)+ 在块宏上方:.A mountain sunset

区块:标题显示在图像下方
内联:标题显示为工具提示

format

指定为子MIME类型的图像格式(SVG图像除外,指定为`svg`)。

format=svg

仅在转换器需要知道图像格式并且目标不以文件扩展名结束(或无法检测)时必须。

caption

用户自定义文本

caption="Figure 8: "

仅适用于块图像。

width

用户自定义的像素大小

image::sunset.jpg[Sunset,300]
(或 width=300

height

用户自定义的像素大小

image::sunset.jpg[Sunset,300,200]
(或 height=200

仅在设置宽度属性时才设置高度,并必须尊重图像的宽高比。

link

用户自定义的外部URI位置

link=https://www.flickr.com/photos/javh/5448336655

window

link 属性的用户自定义窗口目标

window=_blank

scale

应用于固有图像尺寸的缩放因子

scale=80

仅DocBook

scaledwidth

块图像的用户自定义宽度

scaledwidth=25%

仅DocBook和Asciidoctor PDF

pdfwidth

PDF中图像的用户自定义宽度

pdfwidth=80vw

仅Asciidoctor PDF

align

left, center, right

align=left

仅限块图像。 alignfloat 属性是互斥的。

float

left, right

float=right

仅限块图像。 floatalign 属性是互斥的。 要限定浮动范围,请使用浮动组

role

用户定义的,left, right, th, thumb, related, rel

role="thumb right"
(或在块宏上方使用 [.thumb.right]

赋予角色是指定图像浮动位置的首选方法。 角色简写(.)只能在块图像上方的块属性列表中使用。

opts

链接创建和SVG目标的附加选项。

image::sunset.jpg[Sunset, link=https://example.org, opts=nofollow]

image::chart.svg[opts=inline]

选项名包括:nofollow, noopener, inline(仅限SVG), interactive(仅限SVG)