You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
87 lines
1.9 KiB
87 lines
1.9 KiB
////
|
|
Included in:
|
|
|
|
- user-manual: images: Summary
|
|
////
|
|
|
|
.Block and inline image attributes and values
|
|
[cols="1m,1,2,2"]
|
|
|===
|
|
|Attribute |Value(s) |Example Syntax |Comments
|
|
|
|
|imagesdir
|
|
|empty, absolute path, relative path or base URL
|
|
|`:imagesdir: media`
|
|
|If the image target is a URL or an absolute path, the `imagesdir` prefix is _not_ added; Default is empty value
|
|
|
|
|id
|
|
|User defined text
|
|
|`id=sunset-img` +
|
|
(or `+[[sunset-img]]+` or `[#sunset-img]` above block macro)
|
|
|
|
|
|
|
|alt
|
|
|User defined text in first position of attribute list or named attribute
|
|
|`image::sunset.jpg[Brilliant sunset]` +
|
|
(or `alt=Sunset`)
|
|
|
|
|
|
|
|title
|
|
|User defined text
|
|
|`title="A mountain sunset"` +
|
|
(or `.A mountain sunset` above block macro)
|
|
|Blocks: title displayed below image; Inline: title displayed as tooltip
|
|
|
|
|caption
|
|
|User defined text
|
|
|`caption="Figure 8: "`
|
|
|Only applies to block images.
|
|
|
|
|width
|
|
|User defined size in pixels
|
|
|`image::sunset.jpg[Sunset,300]` +
|
|
(or `width=300`)
|
|
|
|
|
|
|
|height
|
|
|User defined size in pixels
|
|
|`image::sunset.jpg[Sunset,300,200]` +
|
|
(or `height=200`)
|
|
|
|
|
|
|
|link
|
|
|User defined location of external URI
|
|
|`link=https://www.flickr.com/photos/javh/5448336655`
|
|
|
|
|
|
|
|scale
|
|
|A scaling factor to apply to the intrinsic image dimensions
|
|
|`scale=80`
|
|
|DocBook only
|
|
|
|
|scaledwidth
|
|
|User defined width for block images
|
|
|`scaledwidth=25%`
|
|
|DocBook only
|
|
|
|
|pdfwidth
|
|
|User defined width for images in a PDF
|
|
|`pdfwidth=80vw`
|
|
|Asciidoctor PDF only
|
|
|
|
|align
|
|
|left, center, right
|
|
|`align=left`
|
|
|Block images only; Align and float attributes are mutually exclusive
|
|
|
|
|float
|
|
|left, right
|
|
|`float=right`
|
|
|Block images only; float and align attributes are mutually exclusive; to scope the float, use a <<control-the-float,float group>>.
|
|
|
|
|role
|
|
|left, right, th, thumb, related, rel
|
|
|`role="thumb right"` +
|
|
(or `[.thumb.right]` above block macro)
|
|
|Inline images can use role to float images left and right; Role shorthand (`.`) can not be used on images
|
|
|===
|
|
|