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.
59 lines
1.5 KiB
59 lines
1.5 KiB
4 years ago
|
////
|
||
|
|
Included in:
|
||
|
|
|
||
|
|
- user-manual: images
|
||
|
|
////
|
||
|
|
|
||
|
|
To include an image on its own line (i.e., a _block image_), use the `image::` prefix in front of the file name and square brackets after it.
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-image.adoc[tag=base]
|
||
|
|
----
|
||
|
|
|
||
|
|
====
|
||
|
|
include::ex-image.adoc[tag=base]
|
||
|
|
====
|
||
|
|
|
||
|
|
If you want to specify alt text, include it inside the square brackets:
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-image.adoc[tag=alt]
|
||
|
|
----
|
||
|
|
|
||
|
|
You can also give the image an id, a title, set its dimensions and make it a link.
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-image.adoc[tag=attr-co]
|
||
|
|
----
|
||
|
|
<1> Assigns an ID to the block; see <<anchordef>>.
|
||
|
|
<2> Defines the title of the block image, which gets displayed underneath the image when rendered.
|
||
|
|
<3> `link` makes the image a link (this can also be defined inside the attribute list of the block macro)
|
||
|
|
<4> The first positional attribute, _Sunset_, is the image's alt text.
|
||
|
|
<5> The second and third positional attributes define the width and height, respectively.
|
||
|
|
|
||
|
|
.A hyperlinked image with caption
|
||
|
|
====
|
||
|
|
include::ex-image.adoc[tag=attr]
|
||
|
|
====
|
||
|
|
|
||
|
|
Block images are prefixed by a caption label (Figure) and number automatically.
|
||
|
|
To turn off figure caption labels and numbers, add the `figure-caption` attribute to the document header and unset it.
|
||
|
|
|
||
|
|
:figure-caption!:
|
||
|
|
|
||
|
|
If you want to include an image inline, use the `image:` prefix instead (notice there is only one colon):
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::ex-image.adoc[tag=in]
|
||
|
|
----
|
||
|
|
|
||
|
|
====
|
||
|
|
include::ex-image.adoc[tag=in]
|
||
|
|
====
|
||
|
|
|
||
|
|
For inline images, the optional title is displayed as a tooltip.
|