12.10 Creating Footnotes

脚注以位于行首(第0列)的方括号标记开始,不允许缩进。脚注在遇到下一个脚注定义、标题或两个连续空行时结束。文本中的脚注引用即为方括号内的标记。标记始终以 ‘fn:’ 开头。示例:

The Org website[fn:1] now looks a lot better than it used to.
...
[fn:50] The link is: https://orgmode.org

Org mode 在数字式语法基础上进行了扩展,支持 命名脚注(named) 与可选的行内定义。合法的引用格式如下:

[fn:NAME]

命名脚注引用,其中 NAME 为唯一标识词,也可使用数字以便自动生成。

[fn:: 此行内直接定义脚注内容]

匿名脚注,在引用位置直接给出定义。

[fn:NAME: 脚注定义内容]

带名称的行内脚注定义。由于 Org 支持对同一脚注的多次引用,之后可直接使用 ‘[fn:NAME]’ 追加引用。

脚注标签可自动生成,也可手动命名。该行为由变量 org-footnote-auto-label 及对应的 ‘STARTUP’ 关键字控制,详见该变量的文档字符串。

以下命令用于操作脚注:

C-c C-x f

脚注操作命令。

光标位于脚注引用处时,跳转到对应定义;位于定义处时,跳转到第一个引用。

其他情况下则新建脚注。根据变量 org-footnote-define-inline126,定义内容可直接嵌入引用处文本,或单独放置在变量 org-footnote-section 指定的位置。

带前缀参数调用该命令时,会显示附加选项菜单:

s按引用顺序对脚注定义排序
r对简单格式 ‘fn:N’ 的脚注重新编号
S先执行编号重置 r,再执行排序 s
n将所有脚注统一重命名为 ‘fn:1’ … ‘fn:n’ 序列
d删除光标处脚注,包括定义与所有引用

根据变量 org-footnote-auto-adjust127,在每次插入或删除脚注后可自动完成编号重排与排序。

C-c C-c

光标位于脚注引用处时跳转到定义,位于定义处时跳回引用。带前缀参数在脚注位置调用时,菜单与 C-c C-x f 相同。

C-c C-omouse-1/2

脚注标签同时也是指向对应定义或引用的链接,可使用常规链接跳转命令访问。


Footnotes

(126)

对应的缓冲区内设置为: ‘#+STARTUP: fninline’ 或 ‘#+STARTUP: nofninline’ 。

(127)

对应的缓冲区内选项为 ‘#+STARTUP: fnadjust’ 和 ‘#+STARTUP: nofnadjust’ 。