Next: Regular Expressions, Previous: The Very Busy C-c C-c Key, Up: Miscellaneous   [Contents][Index]

---

17.8 Summary of In-Buffer Settings ¶

缓冲区设置以 ‘#+’ 开头，后接关键字、冒号、一个或多个空格，再为每个设置对应的单词。Org 支持同一行设置多个选项，也支持同一关键字使用多行。本手册各处均有相关说明，此处汇总如下。

C-c C-c 可使缓冲区设置的修改生效，在 Emacs 中关闭并重新打开 Org 文件也可生效。

‘#+ARCHIVE: %s_done::’ ¶

设置日程文件的归档位置，对应变量为 org-archive-location 。

‘#+CATEGORY’ ¶

设置日程文件的分类，应用于整个文档。

‘#+COLUMNS: %25ITEM ...’ ¶

设置列视图的默认格式，该格式在无 ‘COLUMNS’ 属性的位置调用列视图时生效。

‘#+CONSTANTS: name1=value1 ...’ ¶

为表格公式可用的常量设置文件本地值，该行设置本地变量 org-table-formula-constants-local ，全局版本为 org-table-formula-constants 。

‘#+FILETAGS: :tag1:tag2:tag3:’ ¶

设置文件中所有条目（包括顶层条目）继承的标签。

‘#+LINK: linkword replace’ ¶

每行定义一个链接缩写，多个缩写可使用多个 ‘LINK’ 关键字（参见 Link Abbreviations），对应变量为 org-link-abbrev-alist 。

‘#+PRIORITIES: highest lowest default’ ¶

设置优先级的上下限与默认值，三者均为 A–Z 字母或 0–64 数字，最高优先级的 ASCII 码必须小于最低优先级。

‘#+PROPERTY: Property_Name Value’ ¶

为当前缓冲区条目设置默认继承值，常用于指定属性的允许取值。

‘#+SETUPFILE: file’ ¶

设置文件或对应 URL 用于额外的缓冲区设置。Org 打开主文件时会加载并解析该文件中的设置。若指定 URL，会下载内容并缓存至临时文件。在设置行执行 C-c C-c 可重新解析加载文件并重置临时文件缓存。

Org 正常导出时也会解析并加载设置文件中的缓冲区设置，如同其包含在当前 Org 缓冲区中，设置文件的其余内容会被忽略。

光标在设置文件名行时，按下 C-c ' 可打开设置文件（非 URL）。

‘#+STARTUP:’ ¶

Org 首次打开文件时使用的启动选项。

第一组选项控制大纲树的初始可见性，全局默认设置对应变量为 org-startup-folded ，默认值为 showeverything 。

‘overview’	仅显示顶层标题。
‘content’	显示所有标题。
‘showall’	所有条目均不折叠。
‘show2levels’	显示 1–2 级标题。
‘show3levels’	显示 1–3 级标题。
‘show4levels’	显示 1–4 级标题。
‘show5levels’	显示 1–5 级标题。
‘showeverything’	显示抽屉内容。

动态虚拟缩进由变量 org-startup-indented 控制¹⁶⁵。

‘indent’	启动时开启 Org 缩进模式。
‘noindent’	启动时关闭 Org 缩进模式。

标题动态虚拟编号由变量 org-startup-numerated 控制。

‘num’	启动时开启 Org 编号模式。
‘nonum’	启动时关闭 Org 编号模式。

打开文件时统一对齐表格，对应变量为 org-startup-align-all-tables ，默认值为 nil 。

‘align’	对齐所有表格。
‘noalign’	启动时不对齐表格。

收缩带宽度标记的表格列，对应变量为 org-startup-shrink-all-tables ，默认值为 nil 。

打开文件时自动显示内嵌图片，对应变量为 org-startup-with-inline-images~，默认值为 ~nil 以避免打开文件时延迟。

‘inlineimages’	显示内嵌图片。
‘noinlineimages’	启动时不显示内嵌图片。

Org 缓冲区中的方括号链接默认隐藏路径与括号，例如 ‘[[https://orgmode.org][Org Website]]’ 仅显示 “Org Website”。也可完整显示链接，对应变量为 org-link-descriptive 。

‘descriptivelinks’	隐藏链接路径与括号。
‘literallinks’	完整显示链接。

可通过以下选项配置 TODO 事项关闭、重新打开及时钟区间的日志记录（参见变量 org-log-done 、 org-log-note-clock-out 和 org-log-repeat ）。

‘logdone’	事项标记为完成时记录时间戳。
‘lognotedone’	完成时记录时间戳与备注。
‘nologdone’	不记录事项完成状态。
‘logrepeat’	重置循环事项时记录时间。
‘lognoterepeat’	重置循环事项时记录备注。
‘nologrepeat’	不记录循环事项重置。
‘lognoteclock-out’	时钟退出时记录备注。
‘nolognoteclock-out’	时钟退出时不记录备注。
‘logreschedule’	计划时间变更时记录时间戳。
‘lognotereschedule’	计划时间变更时记录备注。
‘nologreschedule’	不记录计划时间变更。
‘logredeadline’	截止时间变更时记录时间戳。
‘lognoteredeadline’	截止时间变更时记录备注。
‘nologredeadline’	不记录截止时间变更。
‘logrefile’	重新归档时记录时间戳。
‘lognoterefile’	重新归档时记录备注。
‘nologrefile’	不记录重新归档操作。

以下选项用于隐藏大纲标题前导星号与设置大纲缩进，对应变量为 org-hide-leading-stars 和 org-odd-levels-only ，默认均为 nil （即 ‘showstars’ 和 ‘oddeven’ ）。

‘hidestars’	标题仅显示一个星号，其余隐藏。
‘showstars’	显示标题所有前导星号。
‘indent’	按大纲层级虚拟缩进。
‘noindent’	不按大纲层级虚拟缩进。
‘odd’	仅使用奇数大纲层级（1、3…）。
‘oddeven’	使用所有大纲层级。

开启时间戳自定义格式覆盖（变量 org-display-custom-times 和 org-timestamp-custom-formats ）可使用：

‘customtime’

覆盖自定义时间格式。

以下选项影响表格电子表格（变量 constants-unit-system ）。

‘constcgs’	‘constants.el’ 使用厘米-克-秒单位制。
‘constSI’	‘constants.el’ 使用国际单位制。

以下关键字用于设置脚注，对应变量为 org-footnote-define-inline 、 org-footnote-auto-label 和 org-footnote-auto-adjust 。

‘fninline’	行内定义脚注。
‘fnnoinline’	在独立章节定义脚注。
‘fnlocal’	在首次引用附近定义脚注，非行内。
‘fnprompt’	提示输入脚注标签。
‘fnauto’	自动创建 ‘[fn:1]’ 格式标签（默认）。
‘fnconfirm’	提供自动标签供编辑或确认。
‘fnadjust’	自动重编号并排序脚注。
‘nofnadjust’	不自动重编号排序脚注。
‘fnanon’	使用 ~org-footnote-new= 创建匿名脚注。

以下关键字用于启动时隐藏块或抽屉，对应变量为 org-hide-block-startup 和 org-hide-drawer-startup 。

‘hideblocks’	启动时隐藏所有起止块。
‘nohideblocks’	启动时不隐藏块。
‘hidedrawers’	启动时隐藏所有抽屉。
‘nohidedrawers’	启动时不隐藏抽屉。

实体以 UTF-8 字符显示由变量 org-pretty-entities 及以下关键字控制：

‘entitiespretty’	尽可能以 UTF-8 字符显示实体。
‘entitiesplain’	保持实体原始格式。

‘#+TAGS: TAG1(c1) TAG2(c2)’ ¶

该行（支持多行）指定文件中有效的标签及（可选）对应的 快速标签选择 按键，对应变量为 org-tag-alist 。

‘#+TODO:’, ‘#+SEQ_TODO:’, ‘#+TYP_TODO:’ ¶

设置当前文件中的 TODO 关键字及其解析规则，对应变量为 org-todo-keywords 。