13.10.6 Images in LaTeX export

LaTeX 导出后端会将 Org 文件中无描述的图片链接(如 ‘[[file:img.jpg]]’ 或 ‘[[./img.jpg]]’ )直接作为图片嵌入最终 PDF 输出,在 PDF 中不再是链接,而是页面上的实际图片。 LaTeX 导出后端使用 ‘\includegraphics’ 宏插入图片。对于 TikZ(https://sourceforge.net/projects/pgf/)图片,后端会在 tikzpicture 环境中使用 \input 宏引入。

指定图片 ‘:width’ 、 ‘:height’ 、 ‘:scale’ 及其他 ‘:options’ 语法如下:

#+ATTR_LATEX: :width 5cm :options angle=90
[[./img/sed-hr4049.pdf]]

:scale’ 属性会同时覆盖 ‘:width’ 与 ‘:height’ 。

自定义标题可使用 ‘:caption’ 属性,覆盖默认的 ‘#+CAPTION’ 值:

#+ATTR_LATEX: :caption \bicaption{HeadingA}{HeadingB}
[[./img/sed-hr4049.pdf]]

若按 Captions 中的方式设置标题,LaTeX 导出后端会将图片包裹在浮动 ‘figure’ 环境中。如需不设置标题也使图片浮动,可将 ‘:float’ 属性设为以下值之一:

t

使用默认 ‘figure’ 环境。

multicolumn

使图片跨页面多栏,后端使用 ‘figure*’ 环境包裹。

wrap

文字环绕在图片右侧,图片占据页面左半部分。

sideways

在新页面以旋转 90 度的横向方式显示,使用 ‘sidewaysfigure’ 环境,会覆盖 ‘:placement’ 设置。

nil

即使使用标题,也避免 ‘:float’ 。

任意自定义值

例如通过 LaTeX 的 ‘float’ 宏包定义的自定义浮动类型。

使用 ‘placement’ 属性修改浮动环境的位置参数。

#+ATTR_LATEX: :float wrap :width 0.38\textwidth :placement {r}{0.4\textwidth}
[[./img/hst.png]]

LaTeX 导出后端默认将所有图片居中。将 ‘:center’ 设为 ‘nil’ 可关闭居中。全局关闭居中可将 org-latex-images-centered 设为 ‘nil’ 。

将 ‘:comment-include’ 属性设为非 nil 值,LaTeX 导出后端会将 ‘\includegraphics’ 宏注释掉。