Next: Math formatting in ODT export, Previous: Tables in ODT export, Up: OpenDocument Text Export   [Contents][Index]

13.12.8 Images in ODT export ¶

Embedding images ¶

ODT 导出后端会处理 Org 文件中不含描述的图片链接，例如 ‘[[file:img.jpg]]’ 或 ‘[[./img.jpg]]’ ， 在最终输出中直接插入图片。以下两种写法均可生效：

[[file:img.png]]

[[./img.png]]

Embedding clickable images ¶

若要创建可点击的图片，需使用一个链接，其描述部分为指向图片文件的另一个链接。 例如，插入图片 ‘org-mode-unicorn.png’ ，点击后跳转到 https://orgmode.org 网站，写法如下：

[[https://orgmode.org][./org-mode-unicorn.png]]

Sizing and scaling of embedded images ¶

通过 ‘ATTR_ODT’ 属性控制嵌入图片的尺寸与缩放比例。

ODT 导出后端会先确定图片在最终文档中的尺寸，该尺寸以厘米为单位。 随后后端会查询图片文件的像素尺寸，此过程依赖 ImageMagick 的 identify 程序， 或 Emacs 的 create-image 与 image-size API。处理大文件或批量操作时，优先使用 ImageMagick。 后端会通过 org-odt-pixels-per-inch 将像素尺寸转换为常用的 72 dpi 或 96 dpi， 该变量默认值取自 display-pixels-per-inch ，可根据输出设备性能调整以获得更好效果。 常见的图片缩放操作如下：

显式指定图片尺寸

将 ‘img.png’ 以 10 厘米 × 10 厘米尺寸插入：

#+ATTR_ODT: :width 10 :height 10
[[./img.png]]

按比例缩放图片

将 ‘img.png’ 按原尺寸的一半插入：

#+ATTR_ODT: :scale 0.5
[[./img.png]]

按指定宽度缩放图片（保持宽高比）

将 ‘img.png’ 宽度设为 10 厘米，同时保持原始宽高比：

#+ATTR_ODT: :width 10
[[./img.png]]

按指定高度缩放图片（保持宽高比）

将 ‘img.png’ 高度设为 10 厘米，同时保持原始宽高比：

#+ATTR_ODT: :height 10
[[./img.png]]

Anchoring of images ¶

ODT 导出后端支持将图片锚定到 ‘as-char’ 、 ‘paragraph’ 或 ‘page’ 。 可通过 ‘ATTR_ODT’ 行中的 ‘:anchor’ 属性设置锚定方式。

创建锚定到页面的图片：

#+ATTR_ODT: :anchor page
[[./img.png]]