默认情况下,图像不会嵌入到HTML输出中。如果你的文档中有图像引用,你需要将图像文件保存在与你转换后的文档相同的目录中。
使用data-uri属性嵌入图片
作为一种选择,您可以通过设置`data-uri`文档属性,直接将图像嵌入到文档中。
在文档头部设置的 data-uri 属性
Unresolved directive in manage-images.adoc - include::example$my-document.adoc[tag=title] :imagesdir: my-images :data-uri: Unresolved directive in manage-images.adoc - include::example$my-document.adoc[tags=body;image]
您也可以使用API或CLI(如下所示)来设置`data-uri`。
asciidoctor -a data-uri my-document.adoc
当你在浏览器中查看HTML文件时,你应该会看到图片显示在页面上。
允许URI读取属性
如果文档中一个或多个图像的目标是一个URI,你还必须安全地设置`allow-uri-read`属性,并在`SECURE`模式或更低级别下运行Asciidoctor。
$ asciidoctor -a data-uri -a allow-uri-read my-document.adoc
将文档使用Asciidoctor PDF转换为PDF时情况也是如此,无论是否设置了`data-uri`属性,因为这种行为是隐含的。