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

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).