LaTeX 导出后端会将 Org 的前三层大纲转换为 LaTeX 标题,剩余层级导出为列表。如需全局修改层级与列表的分界点,参见 Export Settings。
默认情况下,LaTeX 导出后端使用 article 文档类。
如需全局修改默认文档类,编辑 org-latex-default-class ;如需在单个 Org 文件中本地修改,添加选项行 ‘#+LATEX_CLASS: myclass’ ;如需仅对文件部分内容修改,为子树设置属性 ‘EXPORT_LATEX_CLASS’ 。此处填写的类名必须是 org-latex-classes 中的合法成员。
该变量为每个类定义导言区模板,导出工具会将 org-latex-default-packages-alist 与 org-latex-packages-alist 的值填入其中。可使用这三个变量定义自定义章节结构或文档类。
LaTeX 导出后端会将 ‘LATEX_CLASS_OPTIONS’ 关键字与 ‘EXPORT_LATEX_CLASS_OPTIONS’ 属性作为选项传递给 LaTeX 的 \documentclass 宏。选项及其语法(包括方括号包裹)遵循 LaTeX 规范。
#+LATEX_CLASS_OPTIONS: [a4paper,11pt,twoside,twocolumn]
LaTeX 导出后端会将 ‘LATEX_HEADER’ 与 ‘LATEX_HEADER_EXTRA’ 关键字的值追加到 LaTeX 导言区。 org-latex-classes 的文档字符串有更详细说明。另外注意,预览 LaTeX 代码片段时,LaTeX 导出后端不会追加 ‘LATEX_HEADER_EXTRA’ (参见 Previewing LaTeX fragments)。
包含上述导言区设置的 Org 文件示例:
#+LATEX_CLASS: article
#+LATEX_CLASS_OPTIONS: [a4paper]
#+LATEX_HEADER: \usepackage{xyz}
* Headline 1
some text
* Headline 2
some more text
LaTeX 导出后端会将 ‘LATEX_CLASS_PRE’ 关键字的值添加在 LaTeX 导言区之前。当需要为文档类中包含的宏包设置传入参数时可使用该选项。例如,为 xcolor 宏包使用扩展颜色名称:
#+LATEX_CLASS_PRE: \PassOptionsToPackage{dvipsnames}{xcolor}
文档中也可加载 LaTeX 宏包 ‘babel’ 或 ‘polyglossia’ 。两种情况下,字符串“AUTO”都会被替换为文档中 ‘LANGUAGE’ 关键字的对应值(若存在),或 org-export-default-language 的值。下面分情况给出示例。
‘Babel’ 支持经典语法,同时也支持使用 ‘\babelprovide’ 命令的新语法,通过新的 ‘INI’ 文件方式加载语言。注意部分语言仅支持通过 babel 的 INI 文件提供,无法使用经典语法声明,只能通过 ‘\babelprovide’ 命令(参见 https://mirrors.ctan.org/macros/latex/required/babel/base/babel.pdf)。合法用法示例:
#+LATEX_HEADER: \usepackage[french,italian,AUTO]{babel}
其中 “AUTO” 为主要语言。也可使用 ‘\babelprovide’ 命令加载:
#+LATEX_HEADER: \usepackage[french,italian]{babel}
#+LATEX_HEADER: \babelprovide[import, main]{AUTO}
‘Polyglossia’ 生效需使用与 ‘babel’ 相同的经典语法(注意 这并非 polyglossia 原生语法)。例如,文档主语言为通用希腊语,次要语言为法语:
#+LANGUAGE: el-polyton
#+LATEX_HEADER: \usepackage[french,AUTO]{polyglossia}
导出后对应的 LaTeX 代码(使用 ‘polyglossia’ 原生语法):
\usepackage{polyglossia}
\setmainlanguage[variant=polytonic]{greek}
\setotherlanguage{french}
LaTeX 后端默认使用文档类或用户在 ‘LATEX_HEADER’ 中指定的罗马字体族。将选项 org-latex-use-sans 设置为 ‘t’ 可强制 LaTeX 编译器默认使用无衬线字体。也可在文档选项中添加:
#+OPTIONS: latex-use-sans:t