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.
30 lines
952 B
30 lines
952 B
4 years ago
|
////
|
||
|
|
HTML output section
|
||
|
|
|
||
|
|
=== Managing images
|
||
|
|
|
||
|
|
This document is included in convert-documents and the user-manual.
|
||
|
|
////
|
||
|
|
|
||
|
|
Images are not embedded in the HTML output by default.
|
||
|
|
If you have image references in your document, you'll have to save the image files in the same directory as your converted document.
|
||
|
|
|
||
|
|
As an alternative, you can embed the images directly into the document by setting the `data-uri` document attribute.
|
||
|
|
|
||
|
|
$ asciidoctor -a data-uri mysample.adoc
|
||
|
|
|
||
|
|
[source]
|
||
|
|
----
|
||
|
|
include::mysample-data-uri.adoc[]
|
||
|
|
----
|
||
|
|
|
||
|
|
====
|
||
|
|
image::mysample-data-uri.png[]
|
||
|
|
====
|
||
|
|
|
||
|
|
If the target of one or more images in the document is a URI, you must also set the `allow-uri-read` attribute securely and run Asciidoctor in `SECURE` mode or less.
|
||
|
|
|
||
|
|
$ asciidoctor -a data-uri -a allow-uri-read mysample.adoc
|
||
|
|
|
||
|
|
The same is true when converting the document to PDF using Asciidoctor PDF, even if the `allow-uri-read` attribute is not set (since the behavior is implied).
|