13.10.2 LaTeX specific export settings

LaTeX 导出后端提供若干额外关键字用于自定义 LaTeX 输出,使用方式与通用选项类似(参见 Export Settings)。

‘DESCRIPTION’

文档描述信息。hyperref 宏包会将描述、作者名、关键词及相关文件元数据插入输出文件。可通过 org-latex-hyperref-template 自定义元数据项,通过 org-latex-title-command 将描述排版到文档封面部分。长描述可使用多个 ‘DESCRIPTION’ 关键字。

‘LANGUAGE’

文档主语言的语言代码。未指定 ‘LANGUAGE’ 关键字时,使用 org-export-default-language 的值(默认为 =en=,美式英语)。

Org 支持的语言代码列表保存在变量 org-latex-language-alist 中。

该设置生效需根据所用 LaTeX 编译器加载 ‘babel’ 或 ‘polyglossia’ 宏包,并传入对应语言参数。可通过修改 org-latex-packages-alist 变量实现,示例如下(注意 ‘polyglossia’ 不兼容 pdfLaTeX):

(add-to-list 'org-latex-packages-alist
             '("AUTO" "babel" t ("pdflatex" "xelatex" "lualatex")))
(add-to-list 'org-latex-packages-alist
             '("AUTO" "polyglossia" t ("xelatex" "lualatex")))
‘LATEX_CLASS’

LaTeX 文档类,如 article 、 report 、 book 等,包含预设导言区与标题层级映射,供 LaTeX 导出后端使用。后端从 org-latex-default-class 变量读取默认类名,Org 默认文档类为 article 。合法的默认类必须是 org-latex-classes 中的元素。

‘LATEX_CLASS_OPTIONS’

LaTeX 导出后端调用文档类时使用的选项参数。

‘LATEX_COMPILER’

用于生成 PDF 的编译器,如 ‘pdflatex’ 、 ‘xelatex’ 、 ‘lualatex’ ,参见 org-latex-compiler 。

‘LATEX_HEADER’, ‘LATEX_HEADER_EXTRA’

向文档导言区添加的任意代码行,位于 hyperref 设置之前。可通过 org-latex-classes 调整 LaTeX 导言区的结构与顺序。

‘LATEX_CLASS_PRE’

在 LaTeX 导言区前添加的任意代码行。

‘KEYWORDS’

文档关键词。hyperref 宏包会将关键词与作者名、描述等元数据一同插入输出文件。可通过 org-latex-hyperref-template 自定义元数据项,通过 org-latex-title-command 将描述排版到文档封面。必要时可使用多行 ‘KEYWORDS’ 。

‘SUBTITLE’

文档副标题,按 org-latex-subtitle-format 格式排版。若 org-latex-subtitle-separate 非 nil ,副标题会排在 \title 宏之外。可通过 org-latex-hyperref-template 自定义元数据项,通过 org-latex-title-command 将描述排版到文档封面。

后续小节会提供更详细说明。