Up: Images and link previews   [Contents][Index]

12.7.1 Images ¶

图片是不带描述部分的图片文件链接¹²⁴，例如：

./img/cat.jpg

若要为图片定义标题（见 Captions）及内部交叉引用标签（见 Internal Links），确保链接独占一行，并在其前添加 ‘CAPTION’ 和 ‘NAME’ 关键字：

#+CAPTION: This is the caption for the next figure link (or table)
#+NAME:   fig:SED-HR4049
[[./img/a.jpg]]

当链接预览以图片显示时，可进一步自定义图片尺寸与对齐方式。

默认情况下，Org mode 按图片实际宽度显示行内图片，但最大宽度不超过 fill-column 字符数。

你可以通过变量 org-image-actual-width （全局）或 ‘ORG-IMAGE-ACTUAL-WIDTH’ 属性（子树级别）¹²⁵调整显示宽度，取值如下：

• （默认）非 nil ：插入图片时使用实际宽度，若过宽则按 org-image-max-width 限制。
• 设为数字：使用 ImageMagick（若可用）将图片宽度设为该值。
• 设为列表中的数字：优先从匹配宽度规范的 ‘#+ATTR.*’ 关键字中获取宽度，例如：

  #+ATTR_HTML: :width 300px
  

  未找到则使用该数字。

• 设为 nil ：优先从 ‘#+ATTR.*’ 关键字获取宽度，未找到则使用原始宽度或 org-image-max-width 。

org-image-max-width 限制图片最大显示宽度，仅在未显式设置图片宽度时生效。可选设置：

• （默认）~fill-column~：限制宽度为 fill-column 字符数。
• window ：限制宽度为当前窗口宽度。
• 整数：限制宽度为指定像素数。
• nil ：不限制宽度。

Org mode 可对行内图片左对齐、居中或右对齐，该设置由 org-image-align （全局）控制，仅影响独立图片（段落中除空白外无周围文本的链接）。取值如下：

• （默认）符号 left ：在链接所在位置显示图片。
• 符号 center ：在 Emacs 窗口中居中预览链接。
• 符号 right ：在 Emacs 窗口中右对齐预览链接。

行内图片对齐方式可通过 ‘#+ATTR.*’ 关键字为单个链接指定，例如：

#+ATTR_HTML: :align center

Org 会读取任意 ‘#+ATTR.*’ 关键字的对齐设置，如 ‘#+ATTR_HTML’ 或 ‘#+ATTR_LATEX’ ，而 ‘#+ATTR_ORG’ （若存在）会覆盖其他设置。例如以下链接：

#+ATTR_HTML: :align right
#+ATTR_ORG: :align center
[[/path/to/image/file.png]]

在 Emacs 中居中显示，导出为 HTML 时右对齐。

若未设置 ‘#+ATTR_ORG’ ，行内图片对齐方式也会读取部分导出后端（如 HTML、LaTeX 和 Beamer）支持的 ‘:center’ 属性。