the compact org-mode guide 第二章

最新推荐文章于 2021-03-02 10:11:00 发布

翻译最新推荐文章于 2021-03-02 10:11:00 发布 · 1k 阅读

Emacs 同时被 2 个专栏收录

42 篇文章

订阅专栏

Emacs学习

37 篇文章

订阅专栏

本文深入探讨了Org模式的文档结构组织、标题定义、可见循环、移动、结构编辑、稀疏树、朴素列表及脚注等功能，旨在为用户提供全面的编辑体验与高效的工作流程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

第二章

1 文档结构

1 文档结构

Org基于大纲模式，并且提供了灵活的命令去编辑文档结构。

1.1 大纲

Org是在大纲模式上实现的。大纲模式以一种层次化的结构组织文档，至少对我来说，是相当好的笔记和思想的表达方式。通过文档的折叠（隐藏）大部分的内容，显示主干结构展现文档结构全貌，Org通过一个命令进行显示和隐藏，org-cycle它绑定到了TAB键。

1.2 标题

标题定义了大纲树的结构。在Org中，标题开始于一个或者多个星号，举例：

* Top level headline
 ** Second level
 *** 3rd level
 some text
 *** 3rd level
 more text
* Another top level headline

有的人发现太多的星号太复杂了，他们更愿意使用一个星号后面接许多的空白字符来实现这样的效果，15.2节描述了如何实现这样的效果。

1.3 可见循环

大纲可以隐藏buffer内的部分文本。Org使用两个命令，分别绑定到TAB和S-TAB键。

TAB
子树循环：以下列状态旋转当前子树
    ,-> FOLDED -> CHILDREN -> SUBTREE --.
    '-----------------------------------'

当使用C-u TAB或者shift键时，全局的循环会被触发

S-TAB and C-u TAB
全局循环：以下列状态旋转整个buffer
    ,-> OVERVIEW -> CONTENTS -> SHOW ALL --.
    '--------------------------------------'

C-u C-u C-u TAB
全部显示，包括图。

当Emacs第一次查看Org文件，全局的状态会被设置为 OVERVIEW ，即只有顶层的标题能被看到。这个效果可以通过配置变量org-startup-folded实现，或者在文件添加启动关键字：overview，content，showall。

例如：

#+STARTUP: content

1.4 移动

下面的命令可以再当前buffer中跳转到别的标题

C-c C-n 下一个标题
C-c C-p 上一个标题
C-c C-f 相同级别的下一个标题
C-c C-b 相同级别的上一个标题
C-c C-u 向上一级的标题

1.5 结构编辑

M-RET 添加一个当前级别的标题，如果光标在一个简单地列表项上，那么一个新的项会被创建。当这个命令被在一行的中间使用，那么这行会被分割，剩下的那一部分会称为新的标题。
M-S-RET 在当前标题中插入一个新的TODO入口
TAB 在一个新的，空的入口处。
    在一个没有文本的新的入口处，TAB会循环合理的级别（我没搞懂。。。。。。）In a new entry with no text yet, TAB will cycle through reasonable levels.
M-left/right 升/降一级当前的标题级别
M-S-left/right 升/降一级当前的子树
M-S-up/down 向上/下移动当前的子树
C-c C-w 移动到别的地方（我没搞懂。。。。。。）Refile entry or region to a different location.
C-x n s/w (只看当前子树，别的都去掉)/(还原)

当有一个活动region时，区域内的所有标题都会执行升级/降级

1.6 稀疏树

在org模式中，可以根据在大纲树中选择的信息创建稀疏树，整个文档被尽可能的折叠，但是选择的信息会根据标题结构显示q

org模式包括好几个命令创建这样的一棵树，所有的命令都通过下面的这个分配器产生：

C-c / 询问下一个键去选择创建一个稀疏树的命令
C-c / r 询问一个正则表达书，并显示一棵稀疏树，包括所有的匹配项，所有的匹配项也被高亮，高亮可以被C-c C-c取消。

其他的稀疏树命令——选择TODO关键字，tags，或者内容都会在后面讨论。

1.7 朴素列表

手写格式的列表可以提供额外的结构，甚至能够创建复选框。Org支持编辑列表，和HTML导出粘贴。

org知道有序列表，无序列表和描述列表

无序列表开始于'-','+',或者'*'
有序列表开始于'1.'或者'1)'.
描述列表使用'::'分割描述项和描述内容.

属于同一个列表的列表项必须有着首行一样的缩进，一个项终止于下一行是bullet/number。一个列表终止于两个空行。举例：

** Lord of the Rings My favorite scenes are (in this order)

The attack of the Rohirrim
Eowyn's fight with the witch king
- this was already my favorite scene in the book
- I really like Miranda Otto.

Important actors in this film are:

Elijah Wood

He plays Frodo

Sean Austin

He plays Sam, Frodo's friend.

（下面使用这种方式描述快捷键）：

TAB

像标题可以被折叠

M-RET

在当前级别插入一个项

M-S-RET

插入一个复选框项

M-S-up/down

移动这个项上下（连带着此项的下级）

M-left/M-right

减少/增加此项的缩进，让孩子不动

M-S-left/right

减少/增加慈祥的缩进，包括子项

C-c C-c

如果这是一个复选框，改变这个复选框的状态，刷新整个buffer

C-c -

整体改变整个列表的枚举符号或者数字符号('-','+','*'，'1.','1)')

1.8 脚注

举例：

The Org homepage¹ now looks a lot better than it used to. …

下面的命令处理脚注：

C-c C-x f

脚注动作命令，当光标在一个脚注引用上市，跳转到定义。当在定义上时，跳转到第一个引用上。否则，创建一个新的脚注，当这个命令有前缀参数时，一个额外的重计数菜单选项会被给出。

C-c C-c

在定义和引用之间跳转

Footnotes:

¹ The link is:http://orgmode.org

Date: 2014-06-13T23:09+0800

Author: kirchhoff

Org version 7.9.3f withEmacs version 24

Validate XHTML 1.0