13.1 The Export Dispatcher

导出调度器是 Org 导出功能的主界面。它以层级菜单展示当前已配置的导出格式,选项以直观开关形式在同一界面显示。

Org 还为导出调度器提供极简提示界面。当变量 org-export-dispatch-use-expert-ui 设为非 nil 值时,Org 会在小缓冲区进行提示。按 ? 可切回层级菜单。

C-c C-e (org-export-dispatch)

调用导出调度器界面,选项显示为默认设置。C-u 前缀会保留上一次导出的选项,包括子树选择范围。

Org 默认导出整个缓冲区。若 Org 缓冲区中有激活区域,则只导出该区域。

在调度器界面内,以下组合键可进一步调整导出内容与方式。

C-a

切换异步导出。异步导出使用外部 Emacs 进程及专用初始化文件在后台完成导出,不阻塞当前 Emacs。导出长文档时尤其有用。

异步导出的输出会保存在 导出栈(export stack) 中。使用双重 C-u 前缀调用导出调度器可查看该栈;若已在导出菜单中,按 & 可显示栈内容。

可以通过设置 org-export-in-background ,将异步导出设为默认行为。

可通过 org-export-async-init-file 设置后台进程使用的初始化文件。

C-b

切换仅导出正文。常用于在导出时排除页眉页脚,仅对 HTML 中 ‘<head>...</head>’ 等带头部区域的格式生效。

org-export-body-only 设为默认可永久开启仅导出正文。

C-f

切换强制发布导出。发布功能通常只发布变更文件(见 Triggering Publication);强制发布会忽略时间戳,直接发布所有文件。

org-export-force-publishing 设为默认可永久开启强制发布(与 org-publish-use-timestamps-flag 类似,但仅影响导出调度器)。

C-s

切换仅导出子树。开启后,Org 只导出调用调度器时光标所在位置起始的子树,并以该子树顶层标题作为文档标题。若光标不在标题上,使用最近的上层标题;若在文档前言部分则报错并中止导出。

org-export-initial-scope 设为默认可永久开启子树导出。

C-v

切换仅导出可见内容。通过调整标题可见性,只导出文档特定部分,非常实用。另见 Sparse Trees

org-export-visible-only 设为默认可永久开启仅导出可见内容。