翻译: Org 手册 ¶

Next: Installation, Up: Introduction   [Contents][Index]

1.1 Summary ¶

Org mode 是面向 GNU Emacs 的文档创作工具与待办事项管理器。 它基于轻量级纯文本标记语言，文件后缀名为 ‘.org’ 。

在 Emacs 中编辑 Org 文件可获得最佳支持，但你也可使用任意文本编辑器查看、理解与修改文件内容。

作为创作工具，Org 可帮助你编写结构化文档并提供导出能力。Org 文件同样适用于文学式编程与可复现研究。作为待办事项管理器，Org 可灵活组织各类任务，从日常事务到详细项目规划均可覆盖，支持日志记录、多视角查看任务、导出日程安排等功能。

Org 模式基于大纲模式(Outline mode)实现，可让大型文件内容保持清晰结构。可见性循环与结构编辑功能便于操作树形内容。内置表格编辑器可快速创建表格。类 URL 格式的纯文本链接可指向网页、邮件、新闻组消息、BBDB 条目及项目相关的任意文件。

Org 围绕包含列表或项目纯文本信息的笔记文件完成各类组织任务。项目规划与任务管理使用元数据，元数据隶属于大纲节点。基于这些数据，可通过查询提取特定条目，生成动态 日程视图 ，并与 Emacs 日历和日记功能集成。Org 可实现多种项目规划方法，例如戴维·艾伦的 GTD 体系(David Allen’s GTD system)。

Org 文件可作为单一源创作系统，导出为 HTML、LaTeX、开放文档格式、Markdown 等多种格式。新的导出后端可基于现有后端扩展，也可从零定义。

Org 文件可嵌入源代码块，使其特别适合编写包含代码示例的技术文档。Org 源代码块功能完整，可就地执行并将结果保存至文件中，从而实现单文件可复现研究汇编。

Org 坚持简单事务简单处理的设计理念。初次使用时，它是一款直观易用的大纲编辑器，不会强加复杂操作，但在需要时可提供丰富功能。Org 如同一个工具箱，许多用户仅使用符合自身习惯的部分功能，同时知晓更多能力可随时启用。

所有功能均基于纯文本文件实现，这是最具可移植性且面向未来的文件格式。Org 运行于 Emacs 之上，而 Emacs 是移植范围最广的软件之一，因此 Org 模式可在所有主流平台使用。

Org 设有官方网站，提供最新版本、补充资料、常见问题解答（FAQ）、教程链接等内容，网址为 https://orgmode.org。

本手册早期版本（7.3）曾由 Network Theory Ltd. 出版公司发行平装本，该公司已于 2009 年停业。

Next: Activation, Previous: Summary, Up: Introduction   [Contents][Index]

1.2 Installation ¶

Org 已内置在 GNU Emacs 发行版中，通常无需额外安装。大多数用户只需启用 Org 即可开始使用其功能。

若因特殊原因需要在预装版本之外另行安装 Org，可使用 Emacs 包管理器或克隆 Org 的 Git 仓库。我们 强烈建议 仅使用一种安装方式。

在预装版本之上安装 Org 时请注意：Org 稳定版与最近三个 Emacs 稳定版完全兼容，但不支持更早版本的 Emacs。

部分 Org 组件依赖包仓库提供的第三方软件包，Org 仅保证与这些第三方包的最新稳定版兼容。

Using Emacs packaging system ¶

新版 Emacs 内置包管理器，可安装 Elisp 库。你可通过 M-x list-packages 打开 “包菜单(package menu)” 安装 Org，详见 Package Menu。

Important: 请在未打开任何 ‘.org’ 文件的 Emacs 会话中执行此操作，即尚未加载任何 Org 内置函数的环境。否则自动加载的 Org 函数会导致安装异常。

为避免与内置 Org 模式冲突，可使用命令行安装（需 Emacs 30 及以上版本）：

emacs -Q -batch -eval "(progn (require 'package) (package-initialize) (package-refresh-contents) (package-upgrade 'org))"

该方式可将升级过程与运行中的 Emacs 会话隔离，避免出现版本冲突。

Using Org’s Git repository ¶

可克隆 Org 仓库并按以下步骤安装：

$ cd ~/src/
$ git clone https://https.git.savannah.nongnu.org/git/org-mode.git
$ # 也可使用镜像仓库
$ # git clone https://git.sr.ht/~bzg/org-mode
$ cd org-mode/
$ make autoloads

注意此场景下 ‘make autoloads’ 为必需步骤：它会在 ‘org-version.el’ 中定义 Org 版本，并在 ‘org-loaddefs.el’ 中生成自动加载配置。

请在 Emacs 初始化文件中正确配置加载路径：

(add-to-list 'load-path "~/src/org-mode/lisp")

你还可使用 ‘make’ 编译、 ‘make doc’ 生成文档、 ‘make config’ 创建本地配置、 ‘make install’ 安装 Org。执行 ‘make help’ 可查看完整编译与安装选项。

如需更详细的 Org 构建系统说明，可查阅 Worg 上的 Org Build System 页面。

Installing Org’s contributed packages ¶

Org 仓库曾包含 ‘contrib/’ 目录，用于存放社区贡献的扩展。自 Org 9.5 起，该目录已迁移至独立的 org-contrib 仓库，可作为 package 包从 NonGNU ELPA 单独安装。

Org 仓库外有许多优质扩展包，Worg 网站提供 org-contrib 与外部扩展包 列表，该列表并未完全收录所有相关项目。

Next: Feedback, Previous: Installation, Up: Introduction   [Contents][Index]

1.3 Activation ¶

Org 模式缓冲区需要启用字体锁定功能，这是 Emacs 的默认设置¹。

Org 模式与部分 Elisp 包存在兼容问题（见 Packages that conflict with Org mode），建议查阅相关列表。

为提升使用体验， org-store-link 、 org-capture 与 org-agenda 三个核心命令应可在 Emacs 全局环境调用，而非仅限 Org 缓冲区。为此需要将其绑定到全局快捷键，例如用户自定义保留按键（见 (elisp)Key Binding Conventions）。以下为推荐配置，可在 个人初始化文件 中根据习惯修改。

(global-set-key (kbd "C-c l") #'org-store-link)
(global-set-key (kbd "C-c a") #'org-agenda)
(global-set-key (kbd "C-c c") #'org-capture)

后缀为 ‘.org’ 的文件默认启用 Org 模式。若要在非 ‘.org’ 后缀文件中启用 Org 模式，可将文件首行设置为：

MY PROJECTS    -*- mode: org; -*-

无论文件名如何，该写法都会为当前缓冲区启用 Org 模式。相关配置可参考变量 org-insert-mode-line-in-empty-file 。

Org 中许多命令会在区域处于 激活 状态时作用于该区域。此功能需要开启瞬态标记模式(Transient Mark mode)，该模式为 Emacs 默认设置。若不喜欢该模式，可通过鼠标选择区域，或在移动光标前按两次 C-SPC 激活区域。

Next: Typesetting Conventions Used in this Manual, Previous: Activation, Up: Introduction   [Contents][Index]

1.4 Feedback ¶

如果你在使用 Org 时发现问题，或有相关疑问、意见与建议， 请发送邮件至 Org 邮件列表 mailto:[email protected]。 你可以通过该网页订阅该邮件列表。 若你并非邮件列表成员，你的邮件需经管理员审核后才会发布至列表²。 在该邮件列表发言时，请阅读并遵守GNU 友好交流准则。 反馈后请耐心等待最长一个月的回复时间，若错误报告未收到回应可再次跟进。

提交错误报告时，请先使用最新版本的 Org 尝试复现问题— 如果你使用的是过时版本，该问题很可能已被修复。 若问题仍然存在，请准备报告并尽可能提供详细信息， 包括 Emacs 版本信息（M-x emacs-version）、 Org 版本信息（M-x org-version）， 以及 Emacs 初始化文件中与 Org 相关的配置。 完成此事最简单的方式是执行命令：

M-x org-submit-bug-report <RET>

该命令会将所有相关信息填入 Emacs 邮件缓冲区， 你只需补充问题描述即可。 若你并非在 Emacs 内发送邮件，请将相关内容复制粘贴到你的邮件客户端中。

有时你遇到的问题可能源于 Emacs 或 Org 模式的配置错误。 提交错误报告前，以最小化自定义配置启动 Emacs 并复现问题会很有帮助。 这样做通常能帮你判断问题出自你的自定义配置还是 Org 模式本身。 你可以通过类似下方示例的命令启动典型的最小化会话。

$ emacs -Q -l /path/to/minimal-org.el

但如果你使用的是 Emacs 自带的 Org 模式版本，则无需最小化配置， 直接以 ‘emacs -Q’ 启动 Emacs 即可。 ‘minimal-org.el’ 配置文件可包含如下内容：

;;; 用于加载最新 `org-mode' 的最小化配置

;; 启用调试
(setq debug-on-error t
      debug-on-signal nil
      debug-on-quit nil)

;; 将最新 Org 模式加入加载路径
(add-to-list 'load-path (expand-file-name "/path/to/org-mode/lisp"))

若你使用的是 Git 仓库中的 Org 模式版本， 可通过 ‘make’ 启动最小化会话。

# 纯净 Emacs
make repro
# 或传入额外参数
make repro REPRO_ARGS="-l /path/to/minimal/config.el /tmp/bug.org"

若出现错误，“调用栈回溯(backtrace)” 信息会非常有用— 下文会说明如何生成该信息。 通常一份小型示例文件会很有帮助，同时请清晰说明以下内容：

1. 你具体执行了什么操作？
2. 你期望发生什么结果？
3. 实际发生了什么？

若你感受到性能下降，可录制一份 “性能剖析文件(profile)” 并分享至 Org 邮件列表。 下文会说明如何生成有效的性能剖析数据。

感谢你帮助改进这款程序。

How to create a useful backtrace ¶

若使用 Org 时出现无法理解的错误提示，你可能遇到了程序缺陷。 报告此类问题的最佳方式是，除上述信息外，额外提供一份调用栈回溯信息。 该信息来自内置调试器，记录了错误发生的位置与原因。 以下是生成有效调用栈回溯信息的方法：

1. 重新加载所有未编译的 Org 模式 Lisp 文件。 使用未编译代码生成的回溯信息会丰富得多。 执行此操作的命令为：

   C-u M-x org-reload <RET>
   

   或通过菜单操作：Org → 刷新/重新加载 → 以未编译形式重新加载 Org。

2. 随后启用调试器：

   M-x toggle-debug-on-error <RET>
   

   或通过菜单：选项 → 出错时进入调试器。

3. 执行触发错误的操作，并记得记录操作步骤。
4. 触发错误后，屏幕会出现 ‘*Backtrace*’ 缓冲区。 将该缓冲区保存为文件（例如使用 C-x C-w）， 并附加到错误报告中。

How to profile Org performance ¶

有时 Org 会无故运行缓慢。 这类卡顿通常由第三方包与 Org 模式的交互导致， 但定位根本原因并非总是易事。

Emacs 可以记录性能统计数据， 借此找出执行耗时最长的函数。 记录统计数据需要使用性能剖析器。 使用 Emacs 剖析器建议按以下步骤操作：

1. 确保当前无剖析器正在运行：

   M-x profiler-stop <RET>
   

2. 启动新的 CPU 性能剖析会话：

   M-x profiler-start <RET> cpu <RET>
   

3. 正常使用 Emacs，执行那些感觉卡顿的操作。
4. 查看并分析记录的性能统计数据：

   M-x profiler-report <RET>
   

   该命令会显示 profiler-start 与 profiler-report 执行期间所运行的命令与函数摘要，耗时最长的命令会显示在顶部。

   可在剖析器缓冲区中按 ‘<TAB>’ 键折叠或展开行。 展开后显示的子项即为被展开父项所调用的函数与命令。

   根本原因通常深藏在剖析器的子项中。 你可以按 ‘B’ (profiler-report-render-reversed-calltree) 快速定位实际耗时最长的函数/命令。

   按 ‘C’ profiler-report-render-calltree 可恢复原始视图。

5. 若需要进一步帮助，可分享统计数据。

   保存数据的命令为：

   M-x profiler-report-write-profile <RET>
   /path/to/profile-file-to-be-saved <RET>
   

   随后将保存的文件附加到发送至 Org 邮件列表的邮件中， 并详细说明触发卡顿的操作。

   注意：保存的统计数据仅包含函数名与执行耗时， 不会记录任何隐私数据。

Previous: Feedback, Up: Introduction   [Contents][Index]

1.5 Typesetting Conventions Used in this Manual ¶

TODO keywords, tags, properties, etc. ¶

Org 使用多种语法元素：TODO 关键字、标签、属性名、关键字、块等。 本手册使用以下约定：

‘TODO’, ‘WAITING’

TODO 关键字全部使用大写书写，即使用户自定义也是如此。

‘boss’, ‘ARCHIVE’

标签区分大小写。用户自定义标签通常使用小写； 具有特殊含义的内置标签按其在文档中的实际形式书写，一般为全大写。

‘Release’, ‘PRIORITY’

用户自定义属性首字母大写； 具有特殊含义的内置属性全部使用大写。

‘TITLE’, ‘BEGIN’ … ‘END’

关键字与代码块使用大写以提升可读性， 但你在自己的 Org 文件中可以使用小写。

Key bindings and commands ¶

本手册会同时列出功能对应的快捷键与命令。 Org 模式常会根据上下文，将同一个快捷键用于不同功能。 绑定到这类快捷键的命令通常使用通用名称，例如 org-metaright 。 手册会尽可能给出该通用命令内部实际调用的函数。 例如，在文档结构章节中，M-RIGHT 会标注为调用 org-do-demote ， 而在表格章节中，该快捷键则标注为调用 org-table-move-column-right 。

Next: Visibility Cycling, Up: Document Structure   [Contents][Index]

2.1 Headlines ¶

标题定义了大纲树的结构。Org 标题从行首³开始，由一个或多个星号后跟空格构成。示例如下：

* 第一级（顶层）标题
** 第二级
*** 第三级
    一些文本
*** 第三级
    更多文本
* 另一个第一级（顶层）标题

org-footnote-section 中定义的名称为保留名称，请勿将其用作自定义标题。

部分用户觉得大量星号显得杂乱，希望大纲标题标记为空白加单个星号的形式。这可以通过 Org 缩进次要模式实现，更多信息详见 A Cleaner Outline View。

标题默认不编号，但你可以对部分或全部标题进行动态编号，详见 Dynamic Headline Numbering。

子树末尾的空行会被视为该子树的一部分，子树折叠时会一同隐藏。若保留至少两个空行，折叠子树后会保留一个空行可见，用于规整折叠后的视图。可通过变量 org-cycle-separator-lines 修改该行为。

Next: Motion, Previous: Headlines, Up: Document Structure   [Contents][Index]

2.2 Visibility Cycling ¶

• Global and local cycling
• Initial visibility
• Catching invisible edits

#+STARTUP: overview
#+STARTUP: content
#+STARTUP: showall
#+STARTUP: show2levels
#+STARTUP: show3levels
#+STARTUP: show4levels
#+STARTUP: show5levels
#+STARTUP: showeverything

Next: Structure Editing, Previous: Visibility Cycling, Up: Document Structure   [Contents][Index]

2.3 Motion ¶

下列命令可在缓冲区中跳转到其他标题。

C-c C-n (org-next-visible-heading) ¶

下一个标题。

C-c C-p (org-previous-visible-heading) ¶

上一个标题。

C-c C-f (org-forward-heading-same-level) ¶

同层级下一个标题。

C-c C-b (org-backward-heading-same-level) ¶

同层级上一个标题。

C-c C-u (outline-up-heading) ¶

向上跳转到更高层级标题。

C-c C-j (org-goto) ¶

跳转到其他位置，同时不改变当前大纲的显示状态。在临时缓冲区中显示文档结构， 可使用以下按键定位目标位置：

TAB	循环切换显示状态。
DOWN / UP	下一个/上一个可见标题。
RET	选中当前位置。
/	执行稀疏树搜索

关闭 org-goto-auto-isearch 后，以下按键生效。

n / p	下一个/上一个可见标题。
f / b	同层级下一个/上一个标题。
u	向上提升一级。
0 … 9	数字前缀参数。
q	退出。

另请参阅变量 org-goto-interface 。

Next: Sparse Trees, Previous: Motion, Up: Document Structure   [Contents][Index]

2.4 Structure Editing ¶

M-RET (org-meta-return) ¶

插入新标题、列表项或表格行。

若在 行首 执行该命令，且光标处为标题或普通列表项（见 Plain Lists）， 新标题/项将插入到当前行 之前 。在普通文本行首执行时，会将该行转为标题。

在行中间执行时，会拆分该行，后半部分成为新的列表项或标题。 若不希望拆分行，可自定义 org-M-RET-may-split-line 。

搭配 C-u 前缀执行时，将无条件在当前子树末尾插入新标题， 保留原有内容。搭配双重前缀 C-u C-u 时，新标题将创建在父级子树末尾。

C-RET (org-insert-heading-respect-content) ¶

在当前子树末尾插入新标题。

M-S-RET (org-insert-todo-heading) ¶

插入与当前标题同级的新 TODO 条目。另请参阅变量 org-treat-insert-todo-heading-as-state-change 。

C-S-RET (org-insert-todo-heading-respect-content) ¶

插入与当前标题同级的新 TODO 条目。与 C-RET 类似， 新标题将插入到当前子树之后。

TAB (org-cycle) ¶

在尚无内容的新条目中，首次按下 TAB 会将该条目降级为前一条目的子项。 再次按下 TAB 会将其升级为父级，依此类推直至最顶层。 继续按下 TAB 则会回到初始层级。

M-LEFT (org-do-promote), M-RIGHT (org-do-demote) ¶

将当前标题提升或降级一级。

当存在激活区域—即瞬时标记模式激活时—提升与降级操作会作用于区域内所有标题。 选择标题区域时，建议将标记设在首个标题开头，光标置于最后一个待修改标题的下一行。

M-S-LEFT (org-promote-subtree) ¶

将当前子树整体提升一级。

M-S-RIGHT (org-demote-subtree) ¶

将当前子树整体降级一级。

M-UP (org-move-subtree-up) ¶

将子树上移，即与同层级上一个子树交换位置。

M-DOWN (org-move-subtree-down) ¶

将子树下移，即与同层级下一个子树交换位置。

C-c @ (org-mark-subtree) ¶

标记光标处的子树。重复按键可依次标记与已标记子树同级的后续子树。

C-c C-x C-w (org-cut-subtree) ¶

剪切子树，即从缓冲区移除并保存至剪切环。 搭配数字前缀参数 N 时，剪切连续 N 个子树。

C-c C-x M-w (org-copy-subtree) ¶

复制子树至剪切环。搭配数字前缀参数 N 时，复制连续 N 个子树。

C-c C-x C-y (org-paste-subtree) ¶

从剪切环粘贴子树。会自动调整子树层级，使其适配粘贴位置。 粘贴层级也可通过数字前缀参数指定，或粘贴在类似 ‘****’ 的标题标记之后。 搭配 C-u 前缀时，强制作为同级节点插入。 搭配 C-u C-u 前缀时，强制作为子节点插入。

C-y (org-yank) ¶

根据变量 org-yank-adjusted-subtrees 与 org-yank-folded-subtrees 的设置， Org 内置的 yank 命令会以折叠状态智能粘贴子树，逻辑与 C-c C-x C-y 一致。 默认设置下不调整层级，但粘贴的子树会折叠，除非此举会遮挡原本可见的文本。 该命令的任何前缀参数都会强制执行普通 yank 并传递前缀。 强制普通粘贴的常用方式为 C-u C-y。 粘贴后使用 yank-pop 时，会直接粘贴之前的剪切内容，不做调整与折叠。

C-c C-x c (org-clone-subtree-with-time-shift) ¶

克隆子树，创建多个同级副本。系统会提示输入副本数量， 并可选择是否偏移条目中的时间戳。 例如可用于快速创建一系列备课相关任务。 更多细节请参阅该命令的文档字符串 org-clone-subtree-with-time-shift 。

C-c C-w (org-refile) ¶

将条目或区域归档至其他位置。见 Refile and Copy。

C-c ^ (org-sort) ¶

对同层级条目排序。存在激活区域时，对区域内所有条目排序； 否则对当前标题的子项排序。命令会提示选择排序方式， 可按字母、数字、时间（优先首个激活时间戳、创建时间、计划时间、截止时间）、 优先级、TODO 关键字（按配置中定义顺序）或属性值排序。也支持反向排序， 还可自定义提取排序键的函数。搭配 C-u 前缀时，排序区分大小写。

C-x n s (org-narrow-to-subtree) ¶

将缓冲区限制显示为当前子树。

C-x n b (org-narrow-to-block) ¶

将缓冲区限制显示为当前块。

C-x n w (widen) ¶

取消限制，恢复显示整个缓冲区。

C-c * (org-toggle-heading) ¶

将普通行或普通列表项转为标题，即在当前位置成为子标题； 也可移除标题星号，将标题还原为普通行。 存在激活区域时，将区域内所有行转为标题。 若区域首行为列表项，则仅将列表项行转为标题。 若区域首行为标题，则移除区域内所有标题的星号。

注意，当光标位于表格内时（见 Tables），Meta+方向键功能不同。

Next: Plain Lists, Previous: Structure Editing, Up: Document Structure   [Contents][Index]

2.5 Sparse Trees ¶

Org 模式的一项重要功能是可为大纲树中的指定内容构建 稀疏树(sparse trees) ， 使整个文档尽可能折叠，但选中内容及其上方的标题结构保持可见⁷。 实际操作一次即可直观理解其工作方式。

Org 模式提供多个创建稀疏树的命令，均可通过调度器调用：

C-c / (org-sparse-tree) ¶

提示输入额外按键，选择创建稀疏树的对应命令。

C-c / r 或 C-c / / (org-occur) ¶

提示输入正则表达式（见 Regular Expressions）并显示包含所有匹配项的稀疏树。 若匹配项在标题中，则显示该标题；若在条目正文中，则显示标题与正文。 为提供基础上下文，匹配项上方的完整标题层级及匹配项后的标题也会显示。 每个匹配项会高亮显示；执行编辑操作修改缓冲区或按下 C-c C-c 后高亮消失⁸。 搭配 C-u 前缀执行时，会保留之前的高亮，可多次叠加执行该命令。

M-g n 或 M-g M-n (next-error) ¶

跳转到当前缓冲区中下一个稀疏树匹配项。

M-g p 或 M-g M-p (previous-error) ¶

跳转到当前缓冲区中上一个稀疏树匹配项。

对于常用的特定搜索字符串稀疏树，可通过变量 org-agenda-custom-commands 定义快捷键快速访问。这些命令可通过日程调度器调用（见 The Agenda Dispatcher）。 示例：

(setq org-agenda-custom-commands
      '(("f" occur-tree "FIXME")))

该配置将按键 f 设为创建匹配 ‘FIXME’ 字符串稀疏树的快捷方式。

其他稀疏树命令可根据 TODO 关键字、标签或属性筛选标题，将在手册后续章节介绍。

打印稀疏树时，可使用 Emacs 命令 ps-print-buffer-with-faces ， 该命令不会打印文档中不可见部分。也可使用命令 C-c C-e C-v 仅导出文档可见部分并打印生成的文件。

Next: Drawers, Previous: Sparse Trees, Up: Document Structure   [Contents][Index]

2.6 Plain Lists ¶

在大纲树的条目内部，手动格式化的列表可提供额外结构， 也可用于创建复选框列表（见 Checkboxes）。 Org 支持编辑此类列表，所有导出器（见 Exporting）均可解析并格式化。

Org 支持有序列表、无序列表与描述列表。

• 无序(unordered) 列表项以 ‘-’ 、 ‘+’ 或 ‘*’ 作为项目符号⁹。
• 有序(ordered) 列表项以数字后跟句点或右括号开头¹⁰， 如 ‘1.’ 或 ‘1)’¹¹。若希望列表从其他数值开始（如 20）， 可在项文本开头使用 ‘[@20]’¹²。该写法可用于列表任意项，强制指定编号。
• 描述(description) 列表项为无序列表项，使用分隔符 ‘::’ 区分描述 术语(term) 与描述文本。

同属一个列表的项，首行缩进必须一致。 特别地，有序列表编号达到 ‘10.’ 时，两位数字需与列表中其他数字左对齐。 当某行缩进小于或等于项目符号/数字的缩进时，当前项结束。

当所有项均结束时，即遇到缩进小于或等于顶层项缩进的行时，列表结束。 连续两个空行也会结束列表，此时所有项均视为闭合。示例如下：

* Lord of the Rings
My favorite scenes are (in this order)
1. The attack of the Rohirrim
2. Eowyn's fight with the witch king
   + this was already my favorite scene in the book
   + I really like Miranda Otto.
3. Peter Jackson being shot by Legolas
   - on DVD only
   He makes a really funny face when it happens.
8. [@8] <favorite scenes 4 to 8 are skipped for brevity>
But in the end, no individual scenes matter but the film as a whole.
Important actors in this film are:
- Elijah Wood :: He plays Frodo
- Sean Astin :: He plays Sam, Frodo's friend.  I still remember him
     very well from his role as Mikey Walsh in /The Goonies/.

Org 通过优化填充与自动换行命令适配列表，并正确导出（见 Exporting）。 由于缩进决定列表结构，许多结构块（如 ‘#+BEGIN_’ 块）可通过缩进表明归属某一项。

若希望子列表使用与当前层级不同的项目符号以提升可读性， 可自定义变量 org-list-demote-modify-bullet 。 若希望项与子项缩进差异更大，可自定义 org-list-indent-offset 。

下列命令在光标位于项首行（含项目符号或数字的行）时生效。 部分命令会应用自动规则以保持列表结构完整。 若某些行为不符合需求，可配置 org-list-automatic-rules 单独禁用。

TAB (org-cycle) ¶

列表项可像标题层级一样折叠显示。通常仅当光标在普通列表项上时生效。 更多细节见变量 org-cycle-include-plain-lists 。 若该变量设为 integrate ，普通列表项将被视为低级标题， 项的层级由项目符号/数字的缩进决定。 但列表项始终从属于真实标题，两者层级完全分离。 在尚无内容的新项中，首次按下 TAB 会将该项降级为前一项的子项， 后续按下 TAB 会在列表中切换有效层级，最终回到初始位置。

M-RET (org-insert-item) ¶

在当前层级插入新项。搭配前缀参数时，强制插入新标题（见 Structure Editing）。 若在项中间执行，该项会 拆分 为两部分，后半部分成为新项¹³。 若在项正文之前执行，新项会插入到当前项 之前 。

M-S-RET ¶

插入带复选框的新项（见 Checkboxes）。

S-UP, S-DOWN ¶

跳转到当前列表的上一个/下一个项，但仅当 org-support-shift-select 关闭时生效¹⁴。 未关闭时，可使用 C-UP 与 C-DOWN 等段落跳转命令实现类似效果。

M-UP, M-DOWN ¶

将项及其子项整体上移/下移¹⁵， 即与同缩进的上一个/下一个项交换位置。若为有序列表，会自动重新编号。

M-LEFT, M-RIGHT ¶

减小/增大项的缩进，子项保持不变。

M-S-LEFT, M-S-RIGHT ¶

减小/增大项及其所有子项的缩进。 初始时根据当前缩进选择项树，连续多次执行时， 即使新缩进对应不同层级，仍使用初始选中区域。 若要应用新层级，需移动光标中断连续操作。

特殊情况：在列表首个项上执行该命令会移动整个列表。 可通过配置 org-list-automatic-rules 禁用该行为。 列表的整体缩进不影响列表 后 的文本。

C-c C-c ¶

若项行包含复选框（见 Checkboxes），切换复选框状态。 无论何种情况，都会检查整个列表的项目符号与缩进一致性。

C-c - ¶

将整个列表层级循环切换为不同项目符号（ ‘-’ 、 ‘+’ 、 ‘*’ 、 ‘1.’ 、 ‘1)’ ）或其子集， 具体取决于 org-plain-list-ordered-item-terminator 、列表类型与缩进。 搭配数字前缀参数 N 时，选择列表中第 N 种项目符号。 执行时若存在激活区域，将所有行转为列表项。 搭配前缀参数时，选中文本转为单个项。 若首行已是列表项，则移除所有项标记。 即使无激活区域，普通行也会转为列表项。

C-c * ¶

将普通列表项转为标题，即在当前位置成为子标题。 详细说明见 Structure Editing。

C-c C-* ¶

将整个普通列表转为当前标题的子树。 复选框（见 Checkboxes）未选中时转为 ‘TODO’ 关键字，选中时转为 ‘DONE’ 关键字。

S-LEFT, S-RIGHT ¶

当光标在项目符号上或项行任意位置时，该命令也会循环切换项目符号样式， 具体细节取决于 org-support-shift-select 。

C-c ^ ¶

对普通列表排序。提示选择排序方式：数字、字母、时间或自定义函数。

Next: Blocks, Previous: Plain Lists, Up: Document Structure   [Contents][Index]

2.7 Drawers ¶

有时需要保存与条目关联的信息，但通常不希望显示。 为此 Org 模式提供了 抽屉(drawers) 。 抽屉可容纳除标题与其他抽屉外的任意内容。抽屉格式如下：

** This is a headline
Still outside the drawer
:DRAWERNAME:
This is inside the drawer.
:END:
After the drawer.

可通过调用绑定在 C-c C-x d 上的 org-insert-drawer 命令， 在光标处交互式插入抽屉。存在激活区域时，该命令会将区域放入抽屉。 搭配前缀参数时，调用非交互式函数 org-insert-property-drawer ， 在当前标题下方创建 ‘PROPERTIES’ 抽屉。 Org 模式使用该特殊抽屉存储属性（见 Properties and Columns），不可用作其他用途。

也可通过 M-TAB 对抽屉关键字补全¹⁶。

对标题执行显示状态循环（见 Visibility Cycling）时，会隐藏或显示条目， 但抽屉始终折叠为单行。若要查看抽屉内部，需将光标移至抽屉行并按下 TAB。

还可设置将状态变更记录（见 Tracking TODO state changes） 与计时时间（见 Clocking Work Time）保存在 ‘LOGBOOK’ 抽屉中。 若要像状态变更一样快速添加备注，可使用：

C-c C-z ¶

向 ‘LOGBOOK’ 抽屉添加带时间戳的备注。

Previous: Drawers, Up: Document Structure   [Contents][Index]

2.8 Blocks ¶

Org 模式使用 ‘#+BEGIN’ … ‘#+END’ 块实现多种用途， 包括插入源代码示例（见 Literal Examples）、记录计时信息（见 Clocking Work Time）等。 在 ‘#+BEGIN’ 行按下 TAB 可折叠或展开这些块。 可通过配置变量 org-hide-block-startup 让所有块在启动时折叠， 或针对单个文件使用以下设置：

#+STARTUP: hideblocks
#+STARTUP: nohideblocks

Next: Column Width and Alignment, Up: Tables   [Contents][Index]

3.1 Built-in Table Editor ¶

Org 可以轻松在纯 ASCII 文本中排版表格。任何以 ‘|’ 作为首个非空白字符的行都会被视为表格的一部分。 ‘|’ 同时也用作列分隔符¹⁷。 此外，以 ‘|-’ 开头的行表示水平分隔线，用于显式分隔行。 第一条水平分隔线之前的行均为表头行。一个表格示例如下：

| Name  | Phone | Age |
|-------+-------+-----|
| Peter |  1234 |  17 |
| Anna  |  4321 |  25 |

在表格内按下 TAB、RET 或 C-c C-c 时，表格会自动重新对齐。 TAB 还会跳至下一个单元格—RET 跳至下一行— 并在表格末尾或水平分隔线之前创建新的表格行。表格的缩进由第一行决定。 每次重新对齐时，水平分隔线会自动扩展至整个表格宽度。因此，要创建上面的表格，你只需输入：

|Name|Phone|Age|
|-

然后按下 TAB 对齐表格并开始填写内容。 更快的方式是输入 ‘|Name|Phone|Age’ ，随后按下 C-c RET。

在单元格中输入文本时，Org 会对 DEL、Backspace 以及所有字符按键做特殊处理，确保插入和删除操作不会打乱其他单元格。 此外，在通过 TAB、S-TAB 或 RET 移动到新单元格后 立即(immediately) 输入内容时，该单元格会自动清空。 如果你觉得该行为不够可控，可配置选项 org-table-auto-blank-field 。

Creation and conversion ¶

C-c | (org-table-create-or-convert-from-region) ¶

将选中区域转换为表格。如果每行至少包含一个 TAB 字符， 函数会判定内容为制表符分隔。如果每行包含逗号，则判定为逗号分隔值（CSV）。 否则按空白字符分割为单元格。你可以使用前缀参数强制指定分隔符： C-u 强制为 CSV，C-u C-u 强制为 TAB， C-u C-u C-u 会提示输入匹配分隔符的正则表达式， 数字前缀参数 N 表示至少连续 N 个空格或一个 TAB 作为分隔符。

如果没有选中区域，该命令会创建一个空的 Org 表格。 不过更简单的方式是直接开始输入，例如 | N a m e | P h o n e | A g e RET | - TAB。

Re-aligning and field motion ¶

C-c C-c (org-table-align) ¶

重新对齐表格，光标位置不变。

TAB (org-table-next-field) ¶

重新对齐表格，跳至下一个单元格，必要时创建新行。

M-x org-table-blank-field ¶

清空当前表格单元格或选中区域。

S-TAB (org-table-previous-field) ¶

重新对齐表格，跳至上一个单元格。

RET (org-table-next-row) ¶

重新对齐表格并跳至下一行，必要时创建新行。 在行首或行尾时，RET 仍会插入新行，因此可用于拆分表格。

M-a (org-table-beginning-of-field) ¶

跳至当前表格单元格开头，或跳至上一个单元格。

M-e (org-table-end-of-field) ¶

跳至当前表格单元格末尾，或跳至下一个单元格。

Column and row editing ¶

M-LEFT (org-table-move-column-left) ¶

将当前列左移。

M-RIGHT (org-table-move-column-right) ¶

将当前列右移。

M-S-LEFT (org-table-delete-column) ¶

删除当前列。

M-S-RIGHT (org-table-insert-column) ¶

在光标位置插入新列，将当前列及右侧所有单元格右移。

M-UP (org-table-move-row-up) ¶

将当前行上移。

M-DOWN (org-table-move-row-down) ¶

将当前行下移。

M-S-UP (org-table-kill-row) ¶

与上方相邻单元格交换位置，实现单元格上移。

S-UP (org-table-move-cell-up) ¶

Move cell up by swapping with adjacent cell.

S-DOWN (org-table-move-cell-down) ¶

与下方相邻单元格交换位置，实现单元格下移。

S-LEFT (org-table-move-cell-left) ¶

与左侧相邻单元格交换位置，实现单元格左移。

S-RIGHT (org-table-move-cell-right) ¶

与右侧相邻单元格交换位置，实现单元格右移。

M-S-DOWN (org-table-insert-row) ¶

在当前行上方插入新行。使用前缀参数时，在当前行下方创建新行。

C-c - (org-table-insert-hline) ¶

在当前行下方插入水平分隔线。使用前缀参数时，在当前行上方创建分隔线。

C-c RET (org-table-hline-and-move) ¶

在当前行下方插入水平分隔线，并将光标移至该分隔线下方的行。

C-c ^ (org-table-sort-lines) ¶

对区域内的表格行排序。光标位置指定排序列， 行范围为最近的水平分隔线之间的区域或整个表格。 如果光标在第一列之前，会提示选择排序列。 如果存在选中区域，标记指定首行与排序列，光标应位于排序包含的最后一行。 命令会提示排序类型：字母序、数字序或时间序。 可选择正序或倒序，也可使用自定义的键提取与比较函数。 带前缀参数调用时，字母排序区分大小写。

Regions ¶

C-c C-x M-w (org-table-copy-region) ¶

将表格中的矩形区域复制到专用剪贴板。 光标与标记确定矩形的边界单元格。若无选中区域，则仅复制当前单元格。 该过程会忽略水平分隔线。

C-c C-x C-w (org-table-cut-region) ¶

将表格中的矩形区域复制到专用剪贴板，并清空该矩形内所有单元格，即 “剪切(cut)” 操作。

C-c C-x C-y (org-table-paste-rectangle) ¶

将矩形区域粘贴到表格中，左上角对齐当前单元格，覆盖所有相关单元格。 如果矩形大小超出当前表格，表格会按需扩展。该过程忽略水平分隔线。

M-RET (org-table-wrap-region) ¶

在光标位置拆分当前单元格，将剩余内容移至下一行。 如果存在选中区域且光标与标记在同一列，该列文本会自动换行至指定行数的最小宽度。 数字前缀参数可修改目标行数。若无选中区域但指定前缀参数， 则清空当前单元格，并将内容追加到上方单元格。

Calculations ¶

C-c + (org-table-sum) ¶

对当前列或选中区域矩形内的数字求和。 结果显示在回显区，可通过 C-y 插入。

S-RET (org-table-copy-down) ¶

当前单元格为空时，从上方第一个非空单元格复制内容。 不为空时，将当前单元格内容复制到下一行并同步移动光标。

根据变量 org-table-copy-increment 的设置， 整数、时间戳字段以及前后带整数的字段在复制时可自动递增。 前缀参数 0 可临时禁用递增功能。

该快捷键同样用于选区切换及相关模式（详见 Packages that conflict with Org mode）。

Miscellaneous ¶

C-c ` (org-table-edit-field) ¶

在独立窗口中编辑当前单元格，适用于内容无法完全显示的单元格（详见 Column Width and Alignment）。 带一个 C-u 前缀调用时，仅完整显示单元格以便原地编辑。 带两个 C-u 前缀调用时，编辑窗口会跟随光标在表格中移动并始终显示当前单元格。 跟随模式在光标离开表格或重复执行 C-u C-u C-c ` 时自动退出。

M-x org-table-import ¶

导入文件作为表格。表格内容应为制表符或空白字符分隔。 例如可用于导入电子表格或数据库数据，这类程序通常可导出制表符分隔的文本文件。 该命令先将文件插入缓冲区，再将区域转换为表格。 所有前缀参数都会传递给转换器，用于确定分隔符。

C-c | (org-table-create-or-convert-from-region) ¶

也可通过以下方式导入表格：将表格文本粘贴到 Org 缓冲区， 使用 C-x C-x 选中粘贴内容，然后执行 C-c | 命令（详见 Creation and conversion）。

M-x org-table-export ¶

导出表格，默认格式为制表符分隔文件，用于与电子表格或数据库程序交换数据。 导出格式可通过变量 org-table-export-default-format 配置。 也可使用属性 ‘TABLE_EXPORT_FILE’ 与 ‘TABLE_EXPORT_FORMAT’ 在子树中指定导出文件名与格式。Org 支持非常通用的表格导出格式， 导出器格式与 Orgtbl 无线电表格所用格式一致，详见 Translator functions。

M-x org-table-header-line-mode ¶

当表格首行数据在缓冲区中不可见时，在窗口标题栏显示该行内容。 可将选项 org-table-header-line-p 设置为 t 以默认启用该次要模式。

M-x org-table-transpose-table-at-point ¶

对光标处的表格进行转置并移除水平分隔线。

Next: Column Groups, Previous: Built-in Table Editor, Up: Tables   [Contents][Index]

3.2 Column Width and Alignment ¶

列宽由表格编辑器自动确定。 列的对齐方式则根据该列中数值型与非数值型单元格的占比自动判断。

编辑单元格可能会改变表格的对齐方式。 移动连续的行或列——例如使用 TAB 或 RET—会自动重新对齐表格。 如果你想禁用该行为，可将 org-table-automatic-realign 设置为 nil 。 无论如何，你都可以手动对齐表格：

C-c C-c (org-table-align) ¶

对齐当前表格。

设置选项 org-startup-align-all-tables 会在打开文件时重新对齐文件内所有表格。 你也可以按单个文件设置该选项：

#+STARTUP: align
#+STARTUP: noalign

有时单个或少数单元格需要容纳较多文本，会导致列宽过大，使用不便。 你可能希望隐藏若干列，或按固定宽度显示而不考虑内容，如下例所示。

|---+---------------------+--------|           |---+-------…+…|
|   | <6>                 |        |           |   | <6>   …|…|
| 1 | one                 | some   |   ----\   | 1 | one   …|…|
| 2 | two                 | boring |   ----/   | 2 | two   …|…|
| 3 | This is a long text | column |           | 3 | This i…|…|
|---+---------------------+--------|           |---+-------…+…|

要设置列宽，可在该列任意一个单元格中只填写字符串 ‘<N>’ ， 其中 N 为以字符数表示的宽度。 你可以使用以下工具控制列的显示宽度：

C-c TAB (org-table-toggle-column-width) ¶

收缩或展开当前列。

如果某列通过宽度标记指定了宽度 W，收缩时只显示前 W 个可见字符。 否则该列会收缩至仅一个字符宽度。

若在第一列之前或最后一列之后调用，会提示输入要操作的列范围列表。

C-u C-c TAB (org-table-shrink) ¶

收缩所有设置了宽度的列，展开其余列。

C-u C-u C-c TAB (org-table-expand) ¶

展开所有列。

将鼠标悬停在收缩后的单元格上即可查看完整文本， 提示窗口会显示该单元格的全部内容。 或者使用 C-h . (display-local-help) 也可显示完整内容。 为方便使用，在收缩列附近进行任何修改都会自动展开该列。

设置选项 org-startup-shrink-all-tables 会在打开文件时立即收缩所有包含宽度标记的列。 你也可以按单个文件设置：

#+STARTUP: shrink

如果你想覆盖自动对齐规则（数值多的列右对齐、文本多的列左对齐）， 可以类似地使用 ‘<r>=、=<c>’ 或 ‘<l>’ 。 你还可以同时设置对齐方式和列宽，例如 ‘<r10>’ 。

仅包含这些格式标记的行会在导出文档时自动移除。

Next: The Orgtbl Minor Mode, Previous: Column Width and Alignment, Up: Tables   [Contents][Index]

3.3 Column Groups ¶

Org 导出表格时默认不显示竖线，因为这样通常视觉效果更好。 但有时竖线有助于将表格按列分组，就像横线可以按行分组一样。 要指定列组，可以使用一行特殊格式，该行第一个单元格只填写 ‘/=。 后续单元格可以用 =<’ 表示该列开始一个分组， ‘>’ 表示该列结束一个分组， 或者 ‘<>’ （ ‘<’ 和 ‘>’ 之间无空格）表示该列单独成组。 导出时，列组之间的边界会用竖线标记。示例如下：

| N | N^2 | N^3 | N^4 | sqrt(n) | sqrt[4](N) |
|---+-----+-----+-----+---------+------------|
| / |  <  |     |  >  |       < |          > |
| 1 |  1  |  1  |  1  |       1 |          1 |
| 2 |  4  |  8  | 16  |  1.4142 |     1.1892 |
| 3 |  9  | 27  | 81  |  1.7321 |     1.3161 |
|---+-----+-----+-----+---------+------------|
#+TBLFM: $2=$1^2::$3=$1^3::$4=$1^4::$5=sqrt($1)::$6=sqrt(sqrt(($1)))

更简单的方式是，在你希望出现竖线的位置后方插入列组起始标记即可：

| N | N^2 | N^3 | N^4 | sqrt(n) | sqrt[4](N) |
|---+-----+-----+-----+---------+------------|
| / | <   |     |     | <       |            |

Next: The Spreadsheet, Previous: Column Groups, Up: Tables   [Contents][Index]

3.4 The Orgtbl Minor Mode ¶

如果你喜欢 Org 表格编辑器直观的操作方式， 也可以在文本模式、邮件模式等其他模式中使用。 Orgtbl 次要模式可以实现这一点。 你可以随时通过 M-x orgtbl-mode 切换该模式。 要默认启用，例如在消息模式中启用，可使用：

(add-hook 'message-mode-hook #'turn-on-orgtbl)

此外，通过一些特殊配置，还可以在 Orgtbl 模式下维护任意语法格式的表格。 例如，可以借助 Orgtbl 模式便捷强大的功能（包括电子表格计算能力）来编写 LaTeX 表格。 详情参见 Tables in Arbitrary Syntax。

Next: Org Plot, Previous: The Orgtbl Minor Mode, Up: Tables   [Contents][Index]

3.5 The Spreadsheet ¶

表格编辑器借助 Emacs Calc 软件包实现了类似电子表格的功能。 它还可以执行 Emacs Lisp 表达式，根据其他单元格的值计算出新单元格的内容。 尽管功能完备，Org 的实现与其他电子表格并不完全相同。 例如，Org 引入了 列公式(column formula) 的概念：一条公式即可应用于整列的所有非表头单元格， 无需将公式复制到每个相关单元格。此外还提供公式调试器， 以及具备以下特性的公式编辑器：高亮表格中与光标所在公式引用对应的单元格， 并可通过方向键移动这些引用。

• References
• Formula syntax for Calc
• Emacs Lisp forms as formulas
• Durations and time values
• Field and range formulas
• Column formulas
• Lookup functions
• Editing and debugging formulas
• Updating the table
• Advanced features

@ROW$COLUMN

#+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6

remote(NAME,REF)

'(concat $1 $2)

'(+ $1 $2);N

'(apply '+ '($1..$4));N

'(substring "$1" $2 $3);L

'(substring $1 (string-to-number $2) (string-to-number $3))

'(concat $1 ";")

'(concat $1 ";");

|  Task 1 |   Task 2 |    Total |
|---------+----------+----------|
|    2:12 |     1:47 | 03:59:00 |
|    2:12 |     1:47 |    03:59 |
| 3:02:20 | -2:07:00 |     0.92 |
#+TBLFM: @2$3=$1+$2;T::@3$3=$1+$2;U::@4$3=$1+$2;t

| x | y |
|---+---|
| 1 |   |
| 2 |   |
#+TBLFM: $2=$1*1
#+TBLFM: $2=$1*2

| x | y |
|---+---|
| 1 | 2 |
| 2 | 4 |
#+TBLFM: $2=$1*1
#+TBLFM: $2=$1*2

| x | y |
|---+---|
| 1 | 1 |
| 2 | 2 |
#+TBLFM: $2=$1*1
#+TBLFM: $2=$1*2

|---+---------+--------+--------+--------+-------+------|
|   | Student | Prob 1 | Prob 2 | Prob 3 | Total | Note |
|---+---------+--------+--------+--------+-------+------|
| ! |         |     P1 |     P2 |     P3 |   Tot |      |
| # | Maximum |     10 |     15 |     25 |    50 | 10.0 |
| ^ |         |     m1 |     m2 |     m3 |    mt |      |
|---+---------+--------+--------+--------+-------+------|
| # | Peter   |     10 |      8 |     23 |    41 |  8.2 |
| # | Sam     |      2 |      4 |      3 |     9 |  1.8 |
|---+---------+--------+--------+--------+-------+------|
|   | Average |        |        |        |  25.0 |      |
| ^ |         |        |        |        |    at |      |
| $ | max=50  |        |        |        |       |      |
|---+---------+--------+--------+--------+-------+------|
#+TBLFM: $6=vsum($P1..$P3)::$7=10*$Tot/$max;%.1f::$at=vmean(@-II..@-I);%.1f

|---+-------------+---+-----+--------------------------------------|
|   | Func        | n | x   | Result                               |
|---+-------------+---+-----+--------------------------------------|
| # | exp(x)      | 1 | x   | 1 + x                                |
| # | exp(x)      | 2 | x   | 1 + x + x^2 / 2                      |
| # | exp(x)      | 3 | x   | 1 + x + x^2 / 2 + x^3 / 6            |
| # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 |
| # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2    |
| * | tan(x)      | 3 | x   | 0.0175 x + 1.77e-6 x^3               |
|---+-------------+---+-----+--------------------------------------|
#+TBLFM: $5=taylor($2,$4,$3);n3

Previous: The Spreadsheet, Up: Tables   [Contents][Index]

3.6 Org Plot ¶

Org Plot 可以根据 Org 表格中存储的信息生成图表， 既可以是图形化图表，也可以是 ASCII 艺术图表。

Graphical plots using Gnuplot ¶

Org Plot 可以借助 Gnuplot 与 Gnuplot mode， 将 Org 表格中的数据生成二维与三维图表。 想要实际体验该功能，请先确保系统已安装 Gnuplot 与 Gnuplot mode， 随后将光标置于下方表格处，执行 C-c " g 或 M-x org-plot/gnuplot。

#+PLOT: title:"Citas" ind:1 deps:(3) type:2d with:histograms set:"yrange [0:]"
| Sede      | Max cites | H-index |
|-----------+-----------+---------|
| Chile     |    257.72 |   21.39 |
| Leeds     |    165.77 |   19.68 |
| Sao Paolo |     71.00 |   11.50 |
| Stockholm |    134.19 |   14.33 |
| Morelia   |    257.56 |   17.67 |

Org Plot 支持多种图表类型，也支持自行扩展更多类型。 例如可以按如下方式生成雷达图：

#+PLOT: title:"An evaluation of plaintext document formats" transpose:yes type:radar min:0 max:4
| Format            | Fine-grained-control | Initial Effort | Syntax simplicity | Editor Support | Integrations | Ease-of-referencing | Versatility |
|-------------------+----------------------+----------------+-------------------+----------------+--------------+---------------------+-------------|
| Word              |                    2 |              4 |                 4 |              2 |            3 |                   2 |           2 |
| LaTeX             |                    4 |              1 |                 1 |              3 |            2 |                   4 |           3 |
| Org Mode          |                    4 |              2 |               3.5 |              1 |            4 |                   4 |           4 |
| Markdown          |                    1 |              3 |                 3 |              4 |            3 |                   3 |           1 |
| Markdown + Pandoc |                  2.5 |            2.5 |               2.5 |              3 |            3 |                   3 |           2 |

可以看到 Org Plot 能够自动将表格表头用作图表标签。 通过表格前方的 ‘PLOT’ 关键字，还可以进一步控制图表的标签、类型、内容与外观。 下方列出 Org Plot 的全部可用选项。 更多说明与示例可参考 Org Plot tutorial。

Plot options ¶

‘set’

指定绘图时需要设置的任意 Gnuplot 选项。

‘title’

指定图表标题。

‘ind’

指定表格中用作 ‘x’ 轴的列。

‘timeind’

指定表格中用作 ‘x’ 轴时间值的列。

‘deps’

以 Lisp 风格列表形式指定需要绘制的列，使用圆括号包裹、空格分隔， 例如 ‘dep:(3 4)’ 表示绘制第三列与第四列。 默认绘制除 ‘ind’ 指定列之外的所有列。

‘transpose’

取值为 ‘y’ 、 ‘yes’ 或 ‘t’ 时，会在绘图前尝试转置表格数据。 也支持简写 ‘trans’ 。

‘type’

指定图表类型，默认为 ‘2d’ 、 ‘3d’ 、 ‘radar’ 或 ‘grid’ 之一。 可用类型可通过 org-plot/preset-plot-types 自定义。

‘with’

为所有待绘制列指定 ‘with’ 选项，例如 ‘lines’ 、 ‘points’ 、 ‘boxes’ 、 ‘impulses’ 。 默认为 ‘lines’ 。

‘file’

若需要将图表输出至文件，可指定为 ‘"path/to/desired/output-file"’ 。

‘labels’

为 ‘deps’ 指定的列设置标签列表。 若存在表头，默认使用列标题。

‘line’

指定一整行内容，直接插入到 Gnuplot 脚本中。

‘map’

绘制 ‘3d’ 或 ‘grid’ 类型图表时，将此项设为 ‘t’ 可绘制平面映射图，而非三维坡度图。

‘min’

设置图表可使用的坐标轴最小值，默认指代 ‘y’ 轴。 可通过 ‘xmin’ 与 ‘ymin’ 分别显式指定 ‘x’ 轴与 ‘y’ 轴的最小值。

‘max’

设置图表可使用的坐标轴最大值，默认指代 ‘y’ 轴。 可通过 ‘xmax’ 与 ‘ymax’ 分别显式指定 ‘x’ 轴与 ‘y’ 轴的最大值。

‘ticks’

设置希望显示的坐标轴刻度数量，供对应图表类型使用。 若未指定，需要刻度的图表类型会通过 org--plot/sensible-tick-num 自动计算合适值。

‘timefmt’

指定 Org 时间戳的格式，以便 Gnuplot 解析。 默认为 ‘%Y-%m-%d-%H:%M:%S’ 。

‘script’

若需要完全自主控制，可指定一个脚本文件（文件名用双引号包裹）用于绘图。 绘图前，脚本中所有 ‘$datafile’ 都会被替换为生成的数据文件路径。 注意：即使设置了该选项，通常仍建议指定图表类型，因为它会影响数据文件内容。

ASCII bar plots ¶

将光标置于某一列上，输入 C-c " a 或执行 M-x orgtbl-ascii-plot，即可新增一列并生成 ASCII 风格的柱状图。 该图表通过常规表格公式实现。当源列数据变化时， 可通过刷新表格更新柱状图，例如输入 C-u C-c *。

| Sede          | Max cites |              |
|---------------+-----------+--------------|
| Chile         |    257.72 | WWWWWWWWWWWW |
| Leeds         |    165.77 | WWWWWWWh     |
| Sao Paolo     |     71.00 | WWW;         |
| Stockholm     |    134.19 | WWWWWW:      |
| Morelia       |    257.56 | WWWWWWWWWWWH |
| Rochefourchat |      0.00 |              |
#+TBLFM: $3='(orgtbl-ascii-draw $2 0.0 257.72 12)

该公式为 Elisp 调用。

Function: orgtbl-ascii-draw value min max &optional width ¶

在表格中绘制 ASCII 柱状条。

VALUE 为待绘制的数据值。

MIN 对应空柱所代表的数值，MAX 对应填满整个 WIDTH 柱宽的数值。 超出该范围的源数据会显示为 ‘too small’ 或 ‘too large’ 。

WIDTH 为柱状图所占字符数，默认为 ‘12’ 。

Next: Internal Links, Up: Hyperlinks   [Contents][Index]

4.1 Link Format ¶

Org 可以识别普通 URI，也支持用尖括号包裹²⁴， 并将它们激活为可点击链接。

而通用的链接格式如下所示：

[[LINK][DESCRIPTION]]

或者简写形式：

[[LINK]]

LINK 部分中的部分 ‘\’ 、 ‘[’ 、 ‘]’ 字符需要 “转义(escaped)”， 即在其前面再加一个 ‘\’ 。具体来说，必须转义的字符只有以下几种：

1. 所有 ‘[’ 和 ‘]’ 字符，
2. 任何位于 ‘]’ 或 ‘[’ 前面的 ‘\’ 字符，
3. 链接末尾的所有 ‘\’ 字符。

插入链接的函数（见 Handling Links）会自动对歧义字符正确转义。 只有当你直接在方括号内插入或粘贴 URI 时，才需要关心上述规则。 如有疑问，可以使用函数 org-link-escape ，它会将链接字符串转为转义后的形式。

当缓冲区中的一个链接完整且所有括号都齐全时，Org 会改变显示方式： 显示 ‘DESCRIPTION’ 而非 ‘[[LINK][DESCRIPTION]]’ ， 显示 ‘LINK’ 而非 ‘[[LINK]]’ 。 链接会使用 org-link 文本的视觉样式高亮，默认是带下划线的样式。

你可以直接编辑链接的可见部分： 如果没有描述文本，则是 LINK 部分； 否则是 DESCRIPTION 部分。 若要编辑不可见的 LINK 部分， 将光标置于链接上并使用 C-c C-l（见 Handling Links）。

如果将光标放在显示文本的开头或末尾后方并按下 BS， 会删除该位置不可见的括号²⁵。 这会使链接变为不完整状态，内部结构重新以纯文本显示。 插入缺失的括号后，链接内部会再次隐藏。 若要显示所有链接的内部结构，可使用菜单：Org → Hyperlinks → Literal links， 自定义 org-link-descriptive ， 或使用 ‘literallinks’ 启动选项（见 Summary of In-Buffer Settings）。

Next: Radio Targets, Previous: Link Format, Up: Hyperlinks   [Contents][Index]

4.2 Internal Links ¶

不具备 URL 形式的链接—即不以已知协议或文件名开头的链接— 指向当前文档。将光标放在链接上时， 可通过 C-c C-o 或鼠标点击打开（见 Handling Links）。

Org 对文档内部导航提供了多项增强功能。 最常用的是 ‘[[#my-custom-id]]’ 这样的结构， 它精确指向 ‘CUSTOM_ID’ 属性为 ‘my-custom-id’ 的条目。 此外，形如 ‘[[*Some section]]’ 的内部链接会指向标题为 ‘Some section’ 的标题²⁶。

当链接不属于以上任何一种情况时，Org 会查找 专用目标(dedicated target) ： 即使用双层尖括号的相同字符串，例如 ‘<<My Target>>’ 。

如果没有专用目标，链接会尝试匹配缓冲区中某个元素的确切名称。 命名通过 ‘NAME’ 关键字完成，该关键字必须放在其所指向元素的前一行， 如下例所示：

#+NAME: My Target
| a  | table      |
|----+------------|
| of | four cells |

最后，如果以上方式均未匹配成功，Org 会根据 org-link-search-must-match-exact-headline 的值， 搜索与链接文本完全一致（可包含 TODO 关键字与标签）的标题， 或发起纯文本搜索。

注意：你必须确保自定义 ID、专用目标和名称在整个文档中唯一。 如有需要，Org 提供语法检查工具辅助处理。详见 Org Syntax。

导出时，内部链接用于标记对象并为其分配编号。 被标记的对象会被指向它们的链接所引用。 特别是没有描述文本的链接，会显示为被标记对象的编号²⁷。 以下是 Org 缓冲区中的一段示例：

1. one item
2. <<target>>another item
Here we refer to item [[target]].

导出后最后一句话会显示为： ‘Here we refer to item 2’ 。

在非 Org 文件中，搜索会查找链接文本中的单词。 上例中，搜索内容为 ‘target’ 。

打开链接时会向 Org 的标记环中添加一个标记。 你可以使用 C-c & 返回上一位置。 连续多次使用该命令可回到更早记录的位置。

Next: External Links, Previous: Internal Links, Up: Hyperlinks   [Contents][Index]

4.3 Radio Targets ¶

Org 可以自动将普通文本中出现的特定目标名称转为链接。 这样无需显式创建链接，文本即可连接到对应目标并定位其位置。 无线电目标使用三层尖括号包裹。 例如，目标 ‘<<<My Target>>>’ 会使普通文本中每次出现 ‘my target’ 时都激活为链接。 Org 文件仅在首次加载到 Emacs 时自动扫描无线电目标。 若要在编辑时更新目标列表， 将光标放在目标上或其附近并按下 C-c C-c。

Next: Handling Links, Previous: Radio Targets, Up: Hyperlinks   [Contents][Index]

4.4 External Links ¶

Org 支持指向文件、网站、新闻组与邮件、BBDB 数据库条目的链接， 以及 IRC 对话及其日志的链接。 外部链接是类 URL 定位符，以简短标识字符串开头，后跟冒号， 冒号后不能有空格。

以下是全部内置链接类型：

‘file’

文件链接。文件名可以是远程路径、绝对路径或相对路径。

特殊情况：如果文件名完整（例如以 ‘./’ 或 ‘/’ 开头），可省略 “file” 前缀。

‘attachment’

与文件链接相同，但指向附加到当前节点的文件与文件夹（见 Attachments）。 附件链接的行为与文件链接完全一致，只是路径相对于附件目录。

‘bbdb’

指向 BBDB 记录的链接，支持正则表达式补全。

‘docview’

指向使用 DocView mode 打开的文档，可指定页码。

‘doi’

通过数字对象标识符指向电子资源。

‘elisp’

激活时执行一条 Elisp 命令。

‘gnus’ 、 ‘rmail’ 、 ‘mhe’

指向指定 Emacs 邮件客户端中的邮件或文件夹。

‘help’

在 ‘*Help*’ 缓冲区中显示符号的文档。

‘http=、=https’

网页链接。

‘id’

通过 ID 属性指向某个 Org 文件中的特定标题。

‘info’

指向 Info 手册或特定节点。

‘irc’

指向 IRC 频道。

‘mailto’

调用邮件撰写窗口。

‘news’

新闻组链接。

‘shell’

激活时执行一条 shell 命令。

‘shortdoc’

指向一组 Emacs Lisp 函数的简要文档汇总。 ²⁸

更多信息见 Name Help 和 Documentation Groups。

对于 ‘file:’ 和 ‘id:’ 链接，还可以用 ‘::’ 分隔，额外指定行号或文本搜索串。 在 Org 文件中，也可以直接指向标题名、自定义 ID 或代码引用。

下表展示了上述链接类型及其用法示例：

除了这些内置链接类型外， ‘org-contrib’ 仓库还提供更多类型（见 Installation）。 例如，当你从 ‘org-contrib’ 加载对应库后， 即可使用指向 VM 或 Wanderlust 邮件的链接：

关于自定义 Org 以添加新链接类型的说明，见 Adding Hyperlink Types。

链接应使用双层方括号包裹，并可包含显示用描述文本以替代 URL（见 Link Format），例如：

[[https://www.gnu.org/software/emacs/][GNU Emacs]]

如果描述文本是指向图片的文件名或 URL，HTML 导出（见 HTML Export）会将图片内嵌为可点击按钮。 如果完全没有描述文本且链接指向图片，该图片会直接嵌入到导出的 HTML 文件中。

Org 也能识别普通文本中的外部链接并将其激活。 如果链接中必须包含空格（例如 ‘bbdb:R.*Stallman’ ）， 或需要消除链接结尾的歧义，可将链接用方括号或尖括号包裹。

Next: Using Links Outside Org, Previous: External Links, Up: Hyperlinks   [Contents][Index]

4.5 Handling Links ¶

Org 提供了按正确语法创建链接、将其插入 Org 文件以及跳转链接的方法。

主要函数为 org-store-link ，通过 M-x org-store-link 调用。由于该功能十分重要，建议将其绑定到一个常用按键上（见 Activation）。它会为当前位置创建一个链接并保存，供稍后插入到 Org 缓冲区—详见下文。创建的链接类型取决于当前缓冲区：

Org mode 缓冲区

对于 Org 文件，如果光标处存在 ‘<<target>>’ ，链接将指向该目标。如果光标处有命名块（使用 ‘#+name:’ ），链接将指向该名称。除此之外，链接指向当前标题，并以该标题作为描述文本。

如果该标题含有 ‘CUSTOM_ID’ 属性，则保存指向该自定义 ID 的链接。此外，根据 org-id-link-to-org-use-id 的取值，还可为链接创建并/或使用全局唯一的 ‘ID’ 属性³⁰。因此在 Org 缓冲区中使用该命令，可能会生成两种链接：一种是基于自定义 ID、人类可读的链接，另一种是全局唯一、即便条目在文件间移动依然有效的链接。=ID= 属性可以是 UUID（默认）或时间戳，具体由 org-id-method 决定。稍后插入链接时，你可以选择使用哪一种。

当 org-id-link-consider-parent-id 为 t³¹ 时，会考虑上层标题的 ‘ID’ 属性。这样即便某个具体目标、命名块或标题自身没有全局唯一 =ID=，也可以在拥有全局 ID 的上层标题或文件上下文内实现精确链接。

例如下方 Org 文件：

* Parent
:PROPERTIES:
:ID: abc
:END:
** Child 1
** Child 2

将光标放在 “Child 1” 处保存链接，会生成链接 ‘<id:abc::*Child 1>’ ，即便该子标题自身没有 ID，也能精确指向 “Child 1”。

邮件/新闻客户端：VM、Rmail、Wanderlust、MH-E、Gnus ¶

几乎所有 Emacs 邮件客户端均受支持。链接指向当前文章，在部分 Gnus 缓冲区中则指向新闻组。描述文本根据变量 org-link-email-description-format 构造，默认包含收件人与主题。

网页浏览器：W3M 和 EWW

链接为当前 URL，并以页面标题作为描述。

联系人：BBDB

在 BBDB 缓冲区中创建的链接指向当前条目。

聊天：IRC ¶

对于 IRC 链接，如果变量 org-irc-link-to-logs 非 nil ，则创建一个 ‘file’ 类型链接，指向当前对话日志中的相关位置；否则保存 ‘irc’ 类型链接，指向光标下的用户/频道/服务器。

其他文件

对于任意其他文件，链接指向该文件，并附带一个搜索字符串（见 Search Options in File Links）定位当前行内容。如果存在活跃选区，选中的文字将作为搜索字符串的基础。你可以编写自定义 Lisp 函数，为特定文件类型选择搜索串并执行搜索（见 Custom Searches）。

你也可以定义指向其他文件的专用链接，见 Adding Hyperlink Types。

日程视图

当光标位于日程视图中时，创建的链接指向当前行所引用的条目。

在 Org 缓冲区中，以下命令可用于创建、导航或对链接执行其他操作。

C-c C-l (org-insert-link) ¶

插入链接³²。命令会提示输入要插入的链接，你可以直接输入链接内容：内部链接使用文本即可，外部链接则使用上文示例中的类型前缀。链接会连同描述文本一起插入缓冲区³³。如果此时有选中的文本，该文本将作为默认描述。

插入已保存的链接

当前会话中保存的所有链接都会出现在提示历史中，可通过 UP 和 DOWN（或 M-p、M-n）选择。

补全支持

使用 TAB 补全可帮助输入合法的链接前缀，如 ‘http’ 或 ‘ftp’ ，包括通过链接缩写定义的前缀（见 Link Abbreviations）。如果只输入前缀后按下 RET，Org 会为部分链接类型提供专用补全支持³⁴。例如输入 f i l e RET—另一种方式是 C-u C-c C-l，见下文—Org 会提供文件名补全；输入 b b d b RET 后则可以补全联系人姓名。

C-u C-c C-l ¶

当以 C-u 作为前缀调用 C-c C-l 时，直接插入指向文件的链接，并可使用文件名补全选择文件。若被链接文件位于当前 Org 文件所在目录或其子目录，或路径使用 ‘../’ 相对当前目录书写，则插入相对路径；否则使用绝对路径，主目录部分尽可能用 ‘~/’ 表示。使用两层 C-u 前缀可强制使用绝对路径。

C-c C-l（光标位于已有链接上时） ¶

当光标位于已有链接上时，C-c C-l 允许编辑链接的地址与描述部分。

C-c C-o (org-open-at-point) ¶

打开光标处的链接。对于 URL 会启动网页浏览器（使用 browse-url-at-point ）；对于对应类型链接会启动 VM/MH-E/Wanderlust/Rmail/Gnus/BBDB；对于 shell 链接会执行其中命令。当光标位于内部链接上时，该命令会执行对应的搜索。当光标位于标题的标签部分时，会创建对应的标签视图（见 Matching tags and properties）。若光标位于时间戳上，则会生成该日期的日程。此外，它会用 Emacs 打开 ‘file’ 链接中的文本文件与远程文件，并为本地非文本文件选择合适的应用程序。文件类型仅根据扩展名判断，详见选项 org-file-apps 。若想覆盖默认应用、强制用 Emacs 打开，可使用 C-u 前缀；若想避免用 Emacs 打开，则使用 C-u C-u 前缀。

若光标位于标题上但不在链接处，Org 会显示该标题与正文中的所有链接。如果需要配置打开链接时的框架布局，可自定义 org-link-frame-setup 。

RET ¶

当 org-return-follows-link 开启时，RET 也可打开光标处的链接。

mouse-2 或 mouse-1 ¶

在链接上，mouse-1 与 mouse-2 的作用与 C-c C-o 相同，均可打开链接。

mouse-3 ¶

功能与 mouse-2 类似，但会强制用 Emacs 打开文件链接，并在另一个窗口中显示内部链接³⁵。

C-c % (org-mark-ring-push) ¶

将当前位置压入 Org 标记环，方便后续返回。打开内部链接的命令会自动执行该操作。

C-c & (org-mark-ring-goto) ¶

跳回已记录的位置。打开内部链接的命令与 C-c % 都会记录位置。连续多次使用该命令可在历史位置环中依次回退。

C-c C-x C-n (org-next-link), C-c C-x C-p (org-previous-link) ¶

在缓冲区中向前/向后移动到下一个/上一个链接。到达缓冲区边界时，搜索失败一次后会循环到另一端。该按键组合较长，你可能希望将其绑定到 M-n 和 M-p。

(with-eval-after-load 'org
  (define-key org-mode-map (kbd "M-n") #'org-next-link)
  (define-key org-mode-map (kbd "M-p") #'org-previous-link))

Next: Link Abbreviations, Previous: Handling Links, Up: Hyperlinks   [Contents][Index]

4.6 Using Links Outside Org ¶

你不仅可以在 Org 中，还可以在任意 Emacs 缓冲区中插入和跳转符合 Org 语法的链接。为此，Org 提供了两个函数： org-insert-link-global 和 org-open-at-point-global 。

你可以将它们绑定到全局可用按键，相关建议见 Activation。

Next: Search Options in File Links, Previous: Using Links Outside Org, Up: Hyperlinks   [Contents][Index]

4.7 Link Abbreviations ¶

输入长 URL 十分繁琐，而文档中又常常需要大量相似链接，这时可以使用链接缩写。缩写链接格式如下：

[[linkword:tag][description]]

其中标签 tag 为可选部分。链接词 linkword 必须是一个单词，以字母开头，后跟字母、数字、=-= 和 ‘_’ 。缩写根据变量 org-link-abbrev-alist 中的映射关系解析，该变量将链接词与替换文本相关联。示例如下：

(setq org-link-abbrev-alist
      '(("bugzilla"        . "https://10.1.2.9/bugzilla/show_bug.cgi?id=")
        ("Nu Html Checker" . "https://validator.w3.org/nu/?doc=%h")
        ("duckduckgo"      . "https://duckduckgo.com/?q=%s")
        ("omap"            . "https://nominatim.openstreetmap.org/search?q=%s&polygon=1")
        ("ads"             . "https://ui.adsabs.harvard.edu/search/q=%20author%3A\"%s\"")))

如果替换文本包含 ‘%s=，则会被标签替换。使用 =%h’ 替代 ‘%s’ 会对标签进行 URL 百分号编码（如上例中需要对 URL 参数编码）。使用 ‘%(my-function)’ 可将标签传入自定义 Lisp 函数，并以返回字符串作为替换结果。

如果替换文本不包含任何占位符，则直接拼接在链接词后生成完整链接。

除了字符串，你也可以指定一个 Lisp 函数来生成链接，该函数以标签作为唯一参数。

使用以上配置后，你可以用 ‘[[bugzilla:129]]’ 链接到特定缺陷单，用 ‘[[duckduckgo:OrgMode]]’ 搜索 OrgMode，用 ‘[[omap:31 Milk Street, Boston]]’ 显示自由软件基金会所在地地图，用 ‘[[omap:Science Park 904, Amsterdam, The Netherlands]]’ 定位 Carsten 的办公室，还可以用 ‘[[ads:Dominik,C]]’ 查询 Org 作者除 Emacs 开发外的学术成果。

如果只需要在单个 Org 缓冲区中使用专用缩写，可以在文件内定义：

With the above setting, you could link to a specific bug with ‘[[bugzilla:129]]’, search the web for ‘OrgMode’ with ‘[[duckduckgo:OrgMode]]’, show the map location of the Free Software Foundation ‘[[omap:31 Milk Street, Boston]]’ or of Carsten’s office ‘[[omap:Science Park 904, Amsterdam, The Netherlands]]’ and find out what the Org author is doing besides Emacs hacking with ‘[[ads:Dominik,C]]’.

#+LINK: bugzilla  https://10.1.2.9/bugzilla/show_bug.cgi?id=
#+LINK: duckduckgo https://duckduckgo.com/?q=%s
#+LINK: "Nu Html Checker" https://validator.w3.org/nu/?doc=%h

包含空格的缩写必须用引号包裹。

缓冲区内部补全（见 Completion）可在输入 ‘[’ 后补全链接缩写。你还可以定义 Lisp 函数，为使用 C-c C-l 插入此类链接提供专用（如补全）支持。该函数不应接受任何参数，并返回带前缀的完整链接。设置链接补全函数的示例如下：

(org-link-set-parameter "type" :complete #'some-completion-function)

Next: Custom Searches, Previous: Link Abbreviations, Up: Hyperlinks   [Contents][Index]

4.8 Search Options in File Links ¶

文件链接可以包含附加信息，使 Emacs 在打开链接时跳转到文件内的特定位置。该信息可以是行号，也可以是双冒号后的搜索选项³⁶。例如，当 org-store-link 为某个文件创建链接时（见 Handling Links），会将当前行内容编码为搜索字符串，以便后续使用 C-c C-o 打开链接时找回该行。

注意，所有搜索选项对附件链接和 ID 链接的作用方式与文件链接完全一致。

以下为文件链接附加搜索内容的不同语法及说明：

[[file:~/code/main.c::255]]
[[file:~/xx.org::My Target]]
[[file:~/xx.org::*My Target]]
[[file:~/xx.org::#my-custom-id]]
[[file:~/xx.org::/regexp/]]
[[attachment:main.c::255]]

‘255’

跳转到第 255 行。

‘My Target’

搜索链接目标 ‘<<My Target>>=，或对文本 =my target’ 进行搜索，规则与内部链接类似，见 Internal Links。在 HTML 导出中（见 HTML Export），此类文件链接会变为指向目标文件中对应命名锚点的 HTML 引用。

‘*My Target’

在 Org 文件中，仅在标题范围内搜索。

‘#my-custom-id’

链接到带有 ‘CUSTOM_ID’ 属性的标题。

‘/正则表达式(REGEXP)/’

对 REGEXP 执行正则表达式搜索（见 Regular Expressions）。该功能使用 Emacs 命令 occur 在独立窗口列出所有匹配项。如果目标文件为 Org 模式，则使用 org-occur 创建包含匹配项的稀疏树。

作为一种特殊用法，文件名为空的文件链接可用于搜索当前文件。例如 ‘[[file:::find me]]’ 会在当前文件中搜索 ‘find me=，效果与 =[[find me]]’ 相同。

Previous: Search Options in File Links, Up: Hyperlinks   [Contents][Index]

4.9 Custom Searches ¶

创建搜索字符串并执行文件链接相关搜索的默认机制并非在所有场景下都有效。例如 BibTeX 数据库文件中有许多形如 year="1993" 的条目，这类内容无法生成良好的搜索串，因为 BibTeX 条目的唯一标识是引用键。

遇到此类问题时，你可以编写自定义函数，为特定文件类型设置合适的搜索字符串，并在文件中执行对应搜索。通过 add-hook ，这些函数需要添加到钩子变量 org-create-file-search-functions 和 org-execute-file-search-functions 中。更多信息参见这些变量的文档字符串。Org 本身已对 BibTeX 数据库文件使用了该机制，你可以参考对应代码作为实现示例，详见文件 ‘ol-bibtex.el’ 。

Next: Extended Use of TODO Keywords, Up: TODO Items   [Contents][Index]

5.1 Basic TODO Functionality ¶

任何标题以 ‘TODO’ 开头时，都会成为待办事项，例如：

*** TODO Write letter to Sam Fortune

用于操作 待办条目(TODO entries) 的最重要命令如下：

C-c C-t (org-todo) ¶

在以下状态间循环切换当前条目的待办状态：

,-> (unmarked) -> TODO -> DONE --.
'--------------------------------'

如果待办关键字设有快速访问键（参见 Fast access to TODO states），则通过快速选择界面提示选择待办关键字；当 org-use-fast-todo-selection 为非 nil 时，这是默认行为。

同样的状态切换也可以在议程框架中通过 t 命令键 “远程(remotely)” 完成（参见 Commands in the Agenda Buffer）。

S-RIGHT S-LEFT ¶

选择下一个/上一个待办状态，效果类似循环切换。 主要在存在多于两种待办状态时使用（参见 Extended Use of TODO Keywords）。关于与 Shift 选择功能的冲突说明， 另见 Packages that conflict with Org mode。 同时可参考变量 org-treat-S-cursor-todo-selection-as-state-change 。

C-c / t (org-show-todo-tree) ¶

在 稀疏树(sparse tree) 中查看待办事项（参见 Sparse Trees）。折叠整个缓冲区， 但显示所有待办事项——非 DONE 状态——及其上方的标题层级。 携带前缀参数，或使用 C-c / T，可搜索特定待办事项。 系统会提示输入关键字，你也可以输入形如 ‘KWD1|KWD2|...’ 的关键字列表， 以列出匹配任一关键字的条目。携带数字前缀参数 N 时，显示变量 org-todo-keywords 中第 N 个关键字对应的树形结构。携带两个前缀参数时，查找所有待办状态，包括未完成和已完成。

M-x org-agenda t (org-todo-list) ¶

显示全局待办列表。从所有议程文件中收集待办事项（非 DONE 状态） （参见 Agenda Views）并整合到单一框架中。 新框架处于 Org 议程模式，可在其中执行命令查看和操作待办条目 （参见 Commands in the Agenda Buffer）。 更多信息参见 The global TODO list。

S-M-RET (org-insert-todo-heading) ¶

在当前条目下方插入新的待办条目。

修改待办状态时也可触发标签变更。详情参见选项 org-todo-state-tags-triggers 的文档字符串。

Next: Progress Logging, Previous: Basic TODO Functionality, Up: TODO Items   [Contents][Index]

5.2 Extended Use of TODO Keywords ¶

默认情况下，标记的待办条目仅有两种状态：TODO 和 DONE。 Org mode 允许你通过 待办关键字(TODO keywords) （存储于 org-todo-keywords ） 以更复杂的方式分类待办事项。通过特殊配置，待办关键字系统可在不同文件中表现不同。

注意， 标签(tags) 是另一种通用的标题分类方式，尤其适用于待办事项（参见 Tags）。

• TODO keywords as workflow states
• TODO keywords as types
• Multiple keyword sets in one file
• Fast access to TODO states
• Setting up keywords for individual files
• Faces for TODO keywords
• TODO dependencies

(setq org-todo-keywords
      '((sequence "TODO" "FEEDBACK" "VERIFY" "|" "DONE" "DELEGATED")))

(setq org-todo-keywords '((type "Fred" "Sara" "Lucy" "|" "DONE")))

(setq org-todo-keywords
      '((sequence "TODO" "|" "DONE")
        (sequence "REPORT" "BUG" "KNOWNCAUSE" "|" "FIXED")
        (sequence "|" "CANCELED")))

(setq org-todo-keywords
      '((sequence "TODO(t)" "|" "DONE(d)")
        (sequence "REPORT(r)" "BUG(b)" "KNOWNCAUSE(k)" "|" "FIXED(f)")
        (sequence "|" "CANCELED(c)")))

#+TODO: TODO FEEDBACK VERIFY | DONE CANCELED

#+TYP_TODO: Fred Sara Lucy Mike | DONE

#+TODO: TODO(t) | DONE(d)
#+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)
#+TODO: | CANCELED(c)

(setq org-todo-keyword-faces
      '(("TODO" . org-warning) ("STARTED" . "yellow")
        ("CANCELED" . (:foreground "blue" :weight bold))))

* TODO Blocked until (two) is done
** DONE one
** TODO two

* Parent
:PROPERTIES:
:ORDERED:  t
:END:
** TODO a
** TODO b, needs to wait for (a)
** TODO c, needs to wait for (a) and (b)

* This entry is never blocked
:PROPERTIES:
:NOBLOCKING: t
:END:

Next: Priorities, Previous: Extended Use of TODO Keywords, Up: TODO Items   [Contents][Index]

5.3 Progress Logging ¶

若要在修改待办状态时记录时间戳与备注，可携带前缀参数调用命令 org-todo 。

C-u C-c C-t (org-todo) ¶

提示输入备注，并记录待办状态的变更时间。 备注会作为列表项插入到标题下方，也可放入抽屉中，参见 Tracking TODO state changes。

如果你希望更系统化地记录，Org mode 可以在将待办事项标记为完成时， 甚至每次修改待办状态时，自动记录时间戳并可选添加备注。 该系统高度可配置，可按关键字单独设置，也可限定在单个文件甚至子树中生效。 关于为任务记录工作时长的方法，参见 Clocking Work Time。

• Closing items
• Tracking TODO state changes
• Tracking your habits

(setq org-log-done 'time)

(setq org-log-done 'note)

(setq org-todo-keywords
      '((sequence "TODO(t)" "WAIT(w@/!)" "|" "DONE(d!)" "CANCELED(c@)")))

#+TODO: TODO(t) WAIT(w@/!) | DONE(d!) CANCELED(c@)

* TODO Log each state with only a time
  :PROPERTIES:
  :LOGGING: TODO(!) WAIT(!) DONE(!) CANCELED(!)
  :END:
* TODO Only log when switching to WAIT, and when repeating
  :PROPERTIES:
  :LOGGING: WAIT(@) logrepeat
  :END:
* TODO No logging at all
  :PROPERTIES:
  :LOGGING: nil
  :END:

** TODO Shave
   SCHEDULED: <2009-10-17 Sat .+2d/4d>
   :PROPERTIES:
   :STYLE:    habit
   :LAST_REPEAT: [2009-10-19 Mon 00:36]
   :END:
   - State "DONE"       from "TODO"       [2009-10-15 Thu]
   - State "DONE"       from "TODO"       [2009-10-12 Mon]
   - State "DONE"       from "TODO"       [2009-10-10 Sat]
   - State "DONE"       from "TODO"       [2009-10-04 Sun]
   - State "DONE"       from "TODO"       [2009-10-02 Fri]
   - State "DONE"       from "TODO"       [2009-09-29 Tue]
   - State "DONE"       from "TODO"       [2009-09-25 Fri]
   - State "DONE"       from "TODO"       [2009-09-19 Sat]
   - State "DONE"       from "TODO"       [2009-09-16 Wed]
   - State "DONE"       from "TODO"       [2009-09-12 Sat]

Next: Breaking Down Tasks into Subtasks, Previous: Progress Logging, Up: TODO Items   [Contents][Index]

5.4 Priorities ¶

如果你大量使用 Org mode，待办事项可能会多到需要区分优先级。 设置优先级的方法是在待办事项标题的关键字后插入 优先级标记(priority cookie) ，示例：

If you use Org mode extensively, you may end up with enough TODO items that it starts to make sense to prioritize them. Prioritizing can be done by placing a priority cookie into the headline of a TODO item right after the TODO keyword, like this:

*** TODO [#A] Write letter to Sam Fortune

默认情况下，Org mode 支持三种优先级： ‘A’ 、 ‘B’ 、 ‘C’ 。 ‘A’ 为最高优先级。无标记的条目按优先级 ‘B’ 处理。 优先级仅对议程中的排序生效（参见 Weekly/daily agenda）， 在议程之外对 Org mode 无固有含义。 优先级标记会使用变量 org-priority-faces 定义的文本的视觉样式显示，该变量可自定义。

你也可以使用数字表示优先级，例如：

*** TODO [#1] Write letter to Sam Fortune

使用数字优先级时，需要将 org-priority-highest 、 org-priority-lowest 和 org-priority-default 设为整数，且均为 0 到 64 之间的非负整数。

优先级可附加到任意标题，不必是待办事项。

C-c , (org-priority) ¶

设置当前标题的优先级。命令会提示输入优先级字符 ‘A’ 、 ‘B’ 或 ‘C’ 。 若按下 SPC，则移除标题中的优先级标记（如有）。 也可在议程框架中通过 , 命令 “远程(remotely)” 修改优先级（参见 Commands in the Agenda Buffer）。

S-UP (org-priority-up) ¶

S-DOWN (org-priority-down)

提升/降低当前标题的优先级⁴⁷。 注意这些按键也用于修改时间戳（参见 Creating Timestamps）。 关于与 Shift 选择功能的冲突说明，参见 Packages that conflict with Org mode。

你可以通过设置变量 org-priority-highest 、 org-priority-lowest 和 org-priority-default 修改允许的优先级范围。 合法的优先级值为单个大写拉丁字母 A-Z，以及 0 到 64 之间的非负整数。 对于单个缓冲区，可按如下方式设置这些值（最高、最低、默认） （请确保最高优先级在字母顺序上早于最低优先级）：

#+PRIORITIES: A C B

或使用数字：

#+PRIORITIES: 1 10 5

Next: Checkboxes, Previous: Priorities, Up: TODO Items   [Contents][Index]

5.5 Breaking Down Tasks into Subtasks ¶

通常建议将大型任务拆分为更小、可管理的子任务。 你可以在待办事项下方创建大纲树，在树上设置详细子任务⁴⁸。 为概览已标记完成的子任务比例，可在标题任意位置插入 ‘[/]’ 或 ==。 每当子项待办状态变更，或在标记上按下 C-c C-c 时，这些标记会自动更新。示例：

* Organize Party [33%]
** TODO Call people [1/2]
*** TODO Peter
*** DONE Sarah
** TODO Buy food
** DONE Talk to neighbor

若一个标题下方同时存在复选框和待办子项，统计标记的含义会变得模糊。 将属性 ‘COOKIE_DATA’ 设为 ‘checkbox’ 或 ‘todo’ 即可解决该问题。

若希望统计标记计算子树中所有待办条目（而非仅直接子项）， 可配置变量 org-hierarchical-todo-statistics 。 若仅对单个子树生效，可在 ‘COOKIE_DATA’ 属性值中加入 ‘recursive’ 。

* Parent capturing statistics [2/20]
  :PROPERTIES:
  :COOKIE_DATA: todo recursive
  :END:

若希望待办条目在所有子项完成时自动变为完成状态，可使用如下配置：

(defun org-summary-todo (n-done n-not-done)
  "Switch entry to DONE when all subentries are done, to TODO otherwise."
  (let (org-log-done org-todo-log-states)   ; turn off logging
    (org-todo (if (= n-not-done 0) "DONE" "TODO"))))

(add-hook 'org-after-todo-statistics-hook #'org-summary-todo)

另一种方法是使用复选框标识子任务（层级），参见 Checkboxes。

Previous: Breaking Down Tasks into Subtasks, Up: TODO Items   [Contents][Index]

5.6 Checkboxes ¶

普通列表⁴⁹（参见 Plain Lists）中的每一项都可以通过以 ‘[ ]’ 开头变为复选框。 该功能与待办事项类似（参见 TODO Items），但更轻量。 复选框不会出现在全局待办列表中，因此非常适合将任务拆分为多个简单步骤，或用于购物清单。

以下是复选框列表示例：

* TODO Organize party [2/4]
  - [-] call people [1/3]
    - [ ] Peter
    - [X] Sarah
    - [ ] Sam
  - [X] order food
  - [ ] think about what music to play
  - [X] talk to the neighbors

第一行和第二行的 ‘[2/4]’ 和 ‘[1/3]’ 是统计标记， 表示该条目内已勾选的复选框数量与总复选框数量。 即使不展开折叠的条目，也能直观了解剩余未勾选数量。 标记可放在标题或普通列表项（第一行）中。 每个标记仅统计其所在标题/项的结构直接子级复选框⁵⁰。 你需要手动输入 ‘[/]’ 或 ‘[%]’ 插入标记。 使用 ‘[/]’ 会显示「n/m」格式结果，如上例； 使用 ‘[%]’ 则显示已勾选百分比（上例中分别为 ‘[50%]’ 和 ‘[33%]=）。 在标题中，标记可统计下方复选框或子项待办状态，显示最后修改的类型。 将属性 =COOKIE_DATA’ 设为 ‘checkbox’ 或 ‘todo’ 可明确统计类型。

若当前标题设有 ‘ORDERED’ 属性，复选框必须按顺序勾选， 若尝试在上方存在未勾选框时勾选下方框，会抛出错误。

复选框有三种状态：

1. 未勾选 ‘[ ]’
2. 部分勾选 ‘[-]’
3. 已勾选 ‘[X]’

复选框按层级工作，若一个复选框项包含子复选框， 切换任一子复选框会使父复选框反映子项的全部、部分或未勾选状态。

若所有子复选框均未勾选，父复选框也未勾选：

- [ ] call people
  - [ ] Peter
  - [ ] Sarah

若部分子复选框已勾选，父复选框为部分勾选：

- [-] call people
  - [X] Peter
  - [ ] Sarah

若所有子复选框均已勾选，父复选框也已勾选：

- [X] call people
  - [X] Peter
  - [X] Sarah

以下命令用于操作复选框：

C-c C-c (org-toggle-checkbox) ¶

切换光标处复选框状态；若携带前缀参数，则切换复选框是否存在。 携带单个前缀参数时，添加空复选框或移除当前复选框⁵¹。 携带双前缀参数时，设为 ‘[-]’ ，即中间状态。

C-c C-x C-b (org-toggle-checkbox) ¶

切换光标处复选框状态；若携带前缀参数，则切换复选框是否存在。 携带双前缀参数时，设为 ‘[-]’ 中间状态。

• 若存在选中区域，切换区域内第一个复选框，并将其余框设为相同状态。 携带前缀参数时，为区域内所有项添加或移除复选框。
• 若光标在标题中，切换该标题与下一标题之间区域的复选框，而 非 整个子树。
• 若无选中区域，仅切换光标处复选框。

C-c C-x C-r (org-toggle-radio-button) ¶

将光标所在项的复选框作为单选按钮切换： 当该复选框勾选时，同一层级的其他所有复选框会自动取消勾选。 携带通用前缀参数时，切换复选框是否存在。 携带双前缀参数时，设为 ‘[-]’ 。

通过在列表前设置 ‘#+ATTR_ORG: :radio t’ ，或调用 M-x org-list-checkbox-radio-mode 启用该次要模式， 可使 C-c C-c 将复选框视为单选按钮。

M-S-RET (org-insert-todo-heading) ¶

插入带复选框的新项。仅当光标已在普通列表项中时生效（参见 Plain Lists）。

C-c C-x o (org-toggle-ordered-property) ¶

切换条目的 ‘ORDERED’ 属性，控制复选框是否必须按顺序勾选。 该行为使用属性实现，因为此设置应仅作用于当前条目，而非像标签一样继承。 若希望通过标签 跟踪(track) 该属性值以提升可见性，可自定义 org-track-ordered-property-with-tag 。

C-c # (org-update-statistics-cookies) ¶

更新当前大纲条目的统计标记。 携带 C-u 前缀调用时，更新整个文件。 使用 C-c C-c 切换复选框或用 M-S-RET 新建复选框时， 复选框统计标记会自动更新。 修改待办状态时，待办统计标记会更新。 若手动删除/添加框或条目，可使用该命令同步统计数据。

Next: Setting Tags, Up: Tags   [Contents][Index]

6.1 Tag Inheritance ¶

标签(tags) 会沿用大纲树的层级结构。如果某个标题带有特定标签，其所有子标题均会继承该标签。 例如在下列内容中：

* Meeting with the French group      :work:
** Summary by Frank                  :boss:notes:
*** TODO Prepare slides for him      :action:

最底层标题会自动带有 ‘work’ 、 ‘boss’ 、 ‘notes’ 和 ‘action’ 标签， 即便该标题并未显式标记这些标签。你也可以为文件中所有条目设置统一继承的标签， 相当于在整个文件外存在一个虚拟的零级标题定义了这些标签。使用如下格式的行即可⁵²

#+FILETAGS: :Peter:Boss:Secret:

若要限制标签仅对特定标签继承，或完全关闭继承功能，可使用变量 org-use-tag-inheritance 与 org-tags-exclude-from-inheritance 。

标签继承在日程搜索匹配标签时生效，适用于 tags 或 tags-todo 类型的日程视图。 在其他日程类型中， org-use-tag-inheritance 不产生作用。不过你可能仍希望 日程中标签能正确显示，以确保基于继承标签的筛选正常工作。可通过设置 org-agenda-use-tag-inheritance 进行控制：默认值对所有日程类型生效， 将其设为 nil 可显著加快日程生成速度。

Next: Tag Hierarchy, Previous: Tag Inheritance, Up: Tags   [Contents][Index]

6.2 Setting Tags ¶

标签可直接在缓冲区标题末尾输入。输入冒号后，M-TAB 可触发标签补全。 同时也提供专用命令用于插入标签：

C-c C-q (org-set-tags-command) ¶

为当前标题设置新标签。Org 模式会提供补全或专用单键操作界面来设置标签，详见下文。 按下 RET 后，标签会插入并对齐到 org-tags-column 列。 若带 C-u 前缀调用，会将当前缓冲区所有标签对齐到该列，仅用于美化排版。 标题升降级、TODO 状态变更后，标签会自动重新对齐（参见 Basic TODO Functionality）。

C-c C-c (org-set-tags-command) ¶

当光标位于标题上时，该命令与 C-c C-q 作用相同。

Org 支持基于 标签列表(list of tags) 插入标签。默认情况下，该列表动态生成，包含缓冲区当前所有已使用标签⁵³。 你也可以通过变量 org-tag-alist 全局指定固定标签列表。最后，可通过 ‘TAGS’ 关键字 为指定文件设置默认标签，例如：

#+TAGS: @work @home @tennisclub
#+TAGS: laptop car pc sailboat

若已通过变量 org-tag-alist 全局定义常用标签，但希望在特定文件中使用动态标签列表， 可在该文件中添加空的 ‘TAGS’ 关键字：

#+TAGS:

若有一组希望在所有文件中使用的常用标签，且独立于各文件通过 ‘TAGS’ 关键字定义的标签， 可通过变量 org-tag-persistent-alist 指定该组标签。如需在单个文件中关闭此功能， 可在该文件中添加 ‘STARTUP’ 关键字：

#+STARTUP: noptag

默认情况下，Org 模式使用标准小缓冲区补全功能输入标签。此外还提供一种更快捷的标签选择方式， 称为 快速标签选择(fast tag selection) ，可通过单次按键完成标签的选中与取消。为更好使用该功能， 应为大部分常用标签分配唯一字母。可在 Emacs 初始化文件中配置变量 org-tag-alist 实现全局设置。 例如，你可能需要在不同文件中为大量条目标记 ‘@home’ ，此时可进行如下设置：

(setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))

若标签仅与当前编辑文件相关，可改用 ‘TAGS’ 关键字设置：

#+TAGS: @work(w)  @home(h)  @tennisclub(t)  laptop(l)  pc(p)

标签界面会在弹出框架中显示可用标签。若希望在特定标签后换行，可在标签列表中插入 ‘\n’ 。

#+TAGS: @work(w) @home(h) @tennisclub(t) \n laptop(l) pc(p)

或分两行书写：

#+TAGS: @work(w)  @home(h)  @tennisclub(t)
#+TAGS: laptop(l)  pc(p)

也可使用大括号将互斥标签分组，例如：

#+TAGS: { @work(w)  @home(h)  @tennisclub(t) }  laptop(l)  pc(p)

表示 ‘@work’ 、 ‘@home’ 、 ‘@tennisclub’ 中最多只能选中一个。支持设置多个此类分组。

不要忘记将光标置于这些行中并按下 C-c C-c 使修改生效。

若要在变量 org-tag-alist 中设置此类互斥分组，需使用虚拟标签 :startgroup 与 :endgroup 代替大括号。同理，可使用 :newline 表示换行。上述示例对应的全局配置如下：

(setq org-tag-alist '((:startgroup . nil)
                      ("@work" . ?w) ("@home" . ?h)
                      ("@tennisclub" . ?t)
                      (:endgroup . nil)
                      ("laptop" . ?l) ("pc" . ?p)))

若至少有一个标签分配了选择按键，按下 C-c C-c 会自动弹出专用界面， 列出继承标签、当前标题标签及所有有效标签与对应按键⁵⁴。

按下标签对应按键可在当前行标签列表中添加或移除该标签。在互斥组中选中一个标签， 会自动取消组内其他标签的选中状态。

在该界面中，还可使用以下特殊按键：

TAB ¶

在小缓冲区中输入标签，即便该标签不在预定义列表中。可补全缓冲区中所有标签 以及全局通过 org-tag-alist 与 org-tag-persistent-alist 预定义的标签。 也可同时添加多个标签，使用逗号分隔即可。

SPC ¶

清除当前行所有标签。

RET ¶

确认修改后的标签集合。

C-g ¶

放弃修改并退出。

q ¶

若 q 未分配给标签，作用与 C-g 相同，即放弃退出。

! ¶

临时关闭互斥标签组限制。可用于（作为例外）为同一组分配多个标签。

C-c ¶

切换下次修改后自动退出（见下文）。若使用专家模式，首次按下 C-c 会显示选择框架。

该方式只需极少按键即可为标题设置标签。使用上述配置时，清除当前标签并设置 ‘@home’ 、 ‘laptop’ 与 ‘pc’ 只需依次按下：C-c C-c SPC h l p RET。 从 ‘@home’ 切换为 ‘@work’ 可使用 C-c C-c w RET， 或改用 C-c C-c C-c w。添加未预定义标签 ‘sarah’ 可通过 C-c C-c TAB s a r a h RET 实现。

若大多数情况下仅需单次按键修改标签列表，可设置变量 org-fast-tag-selection-single-key 。 此后无需按下 RET 退出快速标签选择，首次修改后会自动退出。 若偶尔需要多次按键，可按下 C-c 关闭当前选择过程的自动退出 （实际效果为以 C-c C-c C-c 代替 C-c C-c 启动选择）。 若将该变量设为 expert ，单键选择标签时不会显示专用框架， 仅在额外按下 C-c 时才会弹出。

快速标签选择界面中显示的标签数量受 org-fast-tag-selection-maximum-tags 限制， 避免可用按键耗尽。你可自定义该变量。

Next: Tag Searches, Previous: Setting Tags, Up: Tags   [Contents][Index]

6.3 Tag Hierarchy ¶

标签可定义为层级结构。一个标签可作为一组其他标签的 /分组标签(group tag)/， 分组标签可视为其下属标签的“上位概念”。定义多个分组标签并嵌套，即可形成标签层级。

典型用途是构建术语（标签）分类体系，用于对文档或文档集中的节点进行分类。

搜索分组标签时，会返回该组及其子组内所有成员标签的匹配结果。在日程视图中， 按分组标签筛选会显示或隐藏带有该组任一成员或子组成员标签的标题。 这让标签搜索与筛选更加灵活。

可使用方括号设置分组标签，在分组标签与其关联标签间插入冒号—注意所有空格均为必需， 以确保 Org 能正确解析该行：

#+TAGS: [ GTD : Control Persp ]

本例中 ‘GTD’ 为分组标签，关联 ‘Control’ 、 ‘Persp’ 两个标签。 将 ‘Control’ 与 ‘Persp’ 继续设为分组标签，可形成完整标签层级：

#+TAGS: [ Control : Context Task ]
#+TAGS: [ Persp : Vision Goal AOF Project ]

从概念上可视为如下标签层级：

• ‘GTD’
  • ‘Persp’
    • ‘Vision’
    • ‘Goal’
    • ‘AOF’
    • ‘Project’
  • ‘Control’
    • ‘Context’
    • ‘Task’

直接设置 org-tag-alist 时，可使用 :startgrouptag 、 :grouptags 与 :endgrouptag 关键字：

(setq org-tag-alist '((:startgrouptag)
                      ("GTD")
                      (:grouptags)
                      ("Control")
                      ("Persp")
                      (:endgrouptag)
                      (:startgrouptag)
                      ("Control")
                      (:grouptags)
                      ("Context")
                      ("Task")
                      (:endgrouptag)))

组内标签可设为互斥，用法与互斥标签分组相同—使用大括号包裹：

#+TAGS: { Context : @Home @Work @Call }

设置 org-tag-alist 时，可使用 :startgroup 与 :endgroup 代替 :startgrouptag 与 :endgrouptag ， 使组内标签互斥。

此外，分组标签的成员也可使用正则表达式，从而实现更动态、基于规则的标签结构 （参见 Regular Expressions）。组内正则表达式必须放在大括号内。 扩展示例如下：

#+TAGS: [ Vision : {V@.+} ]
#+TAGS: [ Goal : {G@.+} ]
#+TAGS: [ AOF : {AOF@.+} ]
#+TAGS: [ Project : {P@.+} ]

搜索标签 ‘Project’ 时，会同时列出所有匹配正则表达式 ‘P@.+’ 的标签， 对 ‘Vision’ 、 ‘Goal’ 、 ‘AOF’ 的标签搜索同理。例如，该规则可很好支持带有通用项目标识的项目标签， 如 ‘P@2014_OrgTags!’ 。

若需临时忽略分组标签，可通过 org-toggle-tags-groups 切换分组标签支持， 该命令绑定至 C-c C-x q。若要完全禁用标签分组，可将 org-group-tags 设为 nil 。

Previous: Tag Hierarchy, Up: Tags   [Contents][Index]

6.4 Tag Searches ¶

标签体系建立后，可用于将相关信息汇总为专用列表。

C-c / m or C-c \ (org-match-sparse-tree) ¶

生成符合标签搜索条件的所有标题构成的稀疏树。 带 C-u 前缀调用时，忽略非 TODO 行的标题。

M-x org-agenda m (org-tags-view) ¶

从所有日程文件中生成全局标签匹配列表。参见 Matching tags and properties。

M-x org-agenda M (org-tags-view) ¶

从所有日程文件中生成全局标签匹配列表，但仅检查 TODO 条目。

这些命令均会提示输入匹配字符串，支持基础布尔逻辑， 例如 ‘+boss+urgent-project1’ 表示查找带有 ‘boss’ 与 ‘urgent’ 标签、 但不含 ‘project1’ 标签的条目； ‘Kathy|Sally’ 表示查找带有 ‘Kathy’ 或 ‘Sally’ 任一标签的条目。 搜索字符串语法丰富，还可匹配 TODO 关键字、条目层级与属性。 完整语法说明与大量示例参见 Matching tags and properties。

Next: Special Properties, Up: Properties and Columns   [Contents][Index]

7.1 Property Syntax ¶

属性为键值对。当属性关联单个条目或某个树形结构时，需要插入到名为 ‘PROPERTIES’ 的专用收纳块中（参见 Drawers），该收纳块必须直接位于标题下方，若存在规划行则位于规划行下方（参见 Deadlines and Scheduling）。每个属性单独占一行，键名用冒号包裹并写在前面，其后为对应值。键名不区分大小写。示例如下：

* CD collection
** Classic
*** Goldberg Variations
    :PROPERTIES:
    :Title:     Goldberg Variations
    :Composer:  J.S. Bach
    :Artist:    Glenn Gould
    :Publisher: Deutsche Grammophon
    :NDisks:    1
    :END:

根据变量 org-use-property-inheritance 的取值，以此方式设置的属性可仅关联单个条目，或关联该条目对应的整个子树，详见 Property Inheritance。

你可以通过定义 ‘Xyz_ALL’ 这一属性，指定特定属性 ‘Xyz’ 的允许取值。该特殊属性支持 继承(inherited) ，因此在一级条目中设置后，会作用于整个树形结构。定义允许取值后，设置对应属性会更简便，也能减少输入错误。以上述 CD 收藏为例，我们可以预先定义出版商与光盘数量：

* CD collection
  :PROPERTIES:
  :NDisks_ALL:  1 2 3 4
  :Publisher_ALL: "Deutsche Grammophon" Philips EMI
  :END:

属性可在缓冲区层级定义，即写在首个标题之前，可被文件中所有条目继承。首个标题前定义的属性块必须位于缓冲区顶部，其上方只能有注释。

也可通过如下格式的行定义属性：

#+PROPERTY: NDisks_ALL 1 2 3 4

若要为已有属性追加取值，可在属性名后添加 ‘+’ 。下述配置会使属性 ‘var’ 同时拥有 ‘foo’ 和 ‘bar’ 两个值。

#+PROPERTY: var  foo
#+PROPERTY: var+ bar

使用追加符号 ‘+’ ，也可以为继承的属性添加取值。下述配置会使 ‘Goldberg Variations’ 子树下的 ‘Genres’ 属性拥有 ‘Classic’ 、 ‘Baroque’ 和 ‘Keyboard music’ 三个值。

* CD collection
** Classic
    :PROPERTIES:
    :Genres: Classic
    :END:
*** Goldberg Variations
    :PROPERTIES:
    :Title:     Goldberg Variations
    :Composer:  J.S. Bach
    :Artist:    Glenn Gould
    :Publisher: Deutsche Grammophon
    :NDisks:    1
    :Genres+:   Baroque
    :Genres+:   Keyboard music
    :END:

注意：只有使用 ‘+’ 追加时，一个属性才能在同一个收纳块中存在多个取值。若同一属性无 ‘+’ 却重复定义，结果未定义。

通过全局变量 org-global-properties 设置的属性值，可被所有 Org 文件中的全部条目继承。

以下命令可用于操作属性：

M-TAB (pcomplete) ¶

在行首输入冒号后，补全属性键名。会列出当前文件中使用过的所有键名作为候选项。

C-c C-x p (org-set-property) ¶

设置属性。会提示输入属性名与取值，必要时自动创建属性收纳块。

C-u M-x org-insert-drawer ¶

在当前条目插入属性收纳块。收纳块会插入在条目靠前位置，位于截止日期等规划信息行之后。若在首个标题前使用，则插入在缓冲区顶部注释之后。

C-c C-c (org-property-action) ¶

光标位于属性收纳块内时，执行属性相关命令。

C-c C-c s (org-set-property) ¶

为当前条目设置属性，属性名与取值均可通过补全输入。

S-RIGHT (org-property-next-allowed-value), S-LEFT (org-property-previous-allowed-value) ¶

将光标所在属性切换为下一个/上一个允许取值。

C-c C-c d (org-delete-property) ¶

从当前条目中移除指定属性。

C-c C-c D (org-delete-property-globally) ¶

从当前文件所有条目中全局移除指定属性。

C-c C-c c (org-compute-property-at-point) ¶

依据最近的列格式定义中的运算符与作用范围，计算光标处属性的取值。

Next: Property Searches, Previous: Property Syntax, Up: Properties and Columns   [Contents][Index]

7.2 Special Properties ¶

特殊属性提供了访问 Org 模式功能的另一种方式，例如条目的 TODO 状态或优先级（前序章节已介绍）。该接口用于将这些状态纳入列视图（参见 Column View）或用于查询。以下属性名为特殊保留名称，不应在属性收纳块中作为自定义键使用：

Next: Property Inheritance, Previous: Special Properties, Up: Properties and Columns   [Contents][Index]

7.3 Property Searches ¶

基于属性筛选生成稀疏树与专用列表，所用命令与标签搜索相同（参见 Tag Searches）。

C-c / m 或 C-c \ (org-match-sparse-tree) ¶

生成包含所有匹配条目的稀疏树。携带 C-u 前缀调用时，忽略非 TODO 行的标题。

M-x org-agenda m (org-tags-view) ¶

从所有日程文件中生成标签与属性匹配的全局列表。

M-x org-agenda M (org-tags-view) ¶

从所有日程文件中生成全局标签匹配列表，但仅筛选 TODO 条目。

搜索字符串的语法详见 Matching tags and properties。

另有专用命令可基于单个属性生成稀疏树：

C-c / p ¶

基于属性值生成稀疏树。先提示输入属性名，再提示输入取值，随后生成所有设置该属性为指定值的条目构成的稀疏树。若将取值放在大括号内，会按正则表达式匹配属性值（参见 Regular Expressions）。

Next: Column View, Previous: Property Searches, Up: Properties and Columns   [Contents][Index]

7.4 Property Inheritance ¶

Org 文档的大纲结构天然适合属性继承模型：若树形结构中的父条目拥有某属性，子条目可继承该属性。Org 模式默认未开启此功能，因为它会显著降低属性搜索速度，且通常并非必需。但如果你认为继承功能有用，可通过设置变量 org-use-property-inheritance 开启。可将其设为 t 使所有属性均从父条目继承，也可设为需要继承的属性列表，或匹配可继承属性的正则表达式。若某属性取值为 nil ，表示显式取消该属性定义，继承搜索会在此处停止并返回 nil 。

Org 模式对部分属性硬编码了继承行为，至少在其专用场景下生效：

COLUMNS ¶

‘COLUMNS’ 属性定义列视图的格式（参见 Column View）。其继承规则为：定义 ‘COLUMNS’ 属性的层级会作为列视图表格的起始位置，与开启列视图的子树位置无关。

CATEGORY ¶

对于日程视图，通过 ‘CATEGORY’ 属性设置的分类会作用于整个子树。

ARCHIVE ¶

用于归档功能， ‘ARCHIVE’ 属性可定义整个子树的归档位置（参见 Moving a tree to an archive file）。

LOGGING ¶

‘LOGGING’ 属性可定义条目或子树的日志记录设置（参见 Tracking TODO state changes）。

Previous: Property Inheritance, Up: Properties and Columns   [Contents][Index]

7.5 Column View ¶

在大纲树中查看和编辑属性的一种极佳方式是 列视图(column view) 。在列视图下，每个标题都会变为表格的一行，表格中的列用于访问条目的各类属性。Org 模式通过在每个条目标题上叠加表格结构来实现列视图。即便标题已被转为表格行，你仍然可以控制大纲树的可见性。例如，切换到 “内容(contents)” 视图可得到紧凑的表格—在列视图激活时按 S-TAB S-TAB 或直接按 c—同时你仍可以展开、查看和编辑每个标题下方的内容。此外，你也可以在执行稀疏树命令后再切换到列视图，这样就能只针对筛选出的条目生成表格。列视图同样适用于日程缓冲区（参见 Agenda Views），这类缓冲区通常已通过查询从多个文件中收集了指定条目。

• Defining columns
• Using column view
• Capturing column view

** Top node for columns view
   :PROPERTIES:
   :COLUMNS: %25ITEM %TAGS %PRIORITY %TODO
   :END:

#+COLUMNS: %25ITEM %TAGS %PRIORITY %TODO

%[WIDTH]PROPERTY[(TITLE)][{SUMMARY-TYPE}]
%[宽度]属性名[(列标题)][{汇总类型}]

:COLUMNS:  %25ITEM %9Approved(Approved?){X} %Owner %11Status \
                   %10Time_Estimate{:}
:Owner_ALL:    Tammy Mark Karl Lisa Don
:Status_ALL:   "In progress" "Not started yet" "Finished" ""
:Approved_ALL: "[ ]" "[X]"

* The column view
#+BEGIN: columnview :hlines 1 :id "label"

#+END: