Emacs 的 Org 主模式

主要亮点

功能

三颗星星

安装

下箭头

快速开始

火箭

贡献

Git branch 图标

Org 是一个非常灵活的有结构的纯文本文件格式，由几种简单而又多用的结构组成。因此，Org 即足够简单，又足够强大。

请在以下这个例子里一窥 Org 具有的强大功能。点击段落标题与链接可以智能折叠与展开相应内容。

元数据 
#+title:  Example Org File
#+author: TEC
#+date:   2020-10-27

概述显示

章节标题与折叠让结构化编辑小菜一碟。 纯文本使得将 Org 文件同步或者加入版本管理十分容易。 
* Revamp orgmode.org website

日程

列出你所有文件中的待办事项。 过滤内容，并且直接更改其内容。 

The /beauty/ of org *must* be shared.
[[https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg]]
 share icon 
** DONE Make screenshots
 
   CLOSED: [2020-09-03 Thu 18:24]


** DONE Restyle Site CSS
 

Go through [[file:style.scss][stylesheet]]


** TODO Check CSS on main pages
文本 
* Learn Org
 

Org makes easy things trivial and complex things practical.

You don't need to learn Org before using Org: read the quickstart
page and you should be good to go.  If you need more, Org will be
here for you as well: dive into the manual and join the community!
    
** Feedback
 

#+include: "other/feedback.org*manual" :only-contents t
* Check CSS minification ratios

Babel

在 Org 里进行文学编程。 用的是缓存区里类似笔记本的实时代码运行功能。 代码 
#+begin_src python
 
from pathlib import Path
cssRatios = []
for css_min in Path("resources/style").glob("*.min.css"):
    css = css_min.with_suffix('').with_suffix('.css')
    cssRatios.append([css.name,
    "{:.0f}% minified ({:4.1f} KiB)".format( 100 *
                      css_min.stat().st_size / css.stat().st_size,
                      css_min.stat().st_size / 1000)])
return cssRatios

#+end_src
运行结果 
#+RESULTS:
 
| index.css    | 76% minified ( 1.4 KiB) |
| org-demo.css | 77% minified ( 2.8 KiB) |
| errors.css   | 74% minified ( 4.9 KiB) |
| org.css      | 75% minified (10.7 KiB) |

更多资料

除开快速开始与手册之外，Org 还有一个指南和大量由社区编写的文档：Worg。

几乎所有的 Org 用户都有自己关于 Org 的故事 － 有些人甚至撰写了关于 Org 对于其实现可重复性研究（英语；外网）价值的科学论文。还有些人开发了一系列第三方工具用来在 Emacs 以外的环境里使用 Org ，例如在移动设备上。

更多 Org

Org 文件的 MIME 类型为 text/org​，使用 .org 后缀名。大部分操作系统不知道应该使用 Emacs 来打开 .org 文件，但通常可以轻松修改其对应设置来达到此目的。

Org 在 Emacs Lisp 上的默认实现目前为止拥有最丰富的功能。不过，目前仍有很多其它的工具能与 Org 进行交互。

能与 Org 交互的工具

Worg，Org 世界

Org 的用法五花八门，因此我们无法把它们轻松地纪录下来，更别提把它们在一个网页里展示出来。因此，我们创造了Worg作为社区百科，为纪录、分享用户们使用 Org 的各方面信息提供了空间。

举个例子，Worg包含了：

Worg是一个装有 Org 文件的 Git 代码仓库，发布为 HTML 网页，欢迎贡献。 

~$ git clone https://git.sr.ht/~bzg/worg

加入邮件列表

Org 邮件列表是一个能与整个 Org 社区交流的地方。你可以订阅此列表，也可以在list.orgmode.org或者此 mailman 网页浏览往期邮件。​请注意，此列表需要使用英语交流。

即使你不是此列表的订阅者，你仍可以向emacs-orgmode@gnu.org发送邮件，我们会把你加入白名单。

更多关于邮件列表的信息请见此网页（英语）。此外，Org 还有其它的社交平台（英语）。

你也可以使用 IRC 在Libera.Chat的 #org-mode 频道上与其它 Org 爱好者交流。​请注意，此频道需要使用英语交流。

Emacs China是一个中文 Emacs 用户聚集的论坛。在此你可以讨论 Org 以及其他与 Emacs 相关的内容。​请注意，此论坛需要使用中文交流。

Org 的完整贡献者列表在 Worg 里可见（英语）。你也可以查看手册的鸣谢（英语）。

Doom，Spacemacs，Scimax以及热门配置

Doom，Spacemacs，以及Scimax这几个 Emacs 入门工具包包含了一系列经过精细管理过的组件与配置，目标是给常用的 Org（以及 Emacs 本身）用法带来优化。它们包含了 org-mode 与其它模式的集成（例如 evil-mode​）。这里是它们目前使用的组件列表：Doom、Spacemacs。​Scimax 与 Org 紧密集成，所以 Scimax 用户应先参考它的手册（英语）。​Doom 使用的 Org 版本接近与开发版 HEAD​，而 Spacemacs 与 Scimax 使用的则是 Org 在 GNU ELPA 上发布的版本。

各种入门工具包通常大量修改了 Emacs 的默认用户设置。如果你更偏向于原版 Emacs，可以参考包含配置了 Org 及其关联组件的热门配置，例如 Purcell 的 emacs.d。

其它文本编辑器

尽管用户只能在 Emacs 上享受完整的 Org 功能，但是 Org 文件的基本功能已经在一系列其它编辑器上被实现出来，详见以下列表：

由TEC用 Org 独角兽 logo 完成。

根据 GNU FDL 1.3 授权 — 本网页源代码见此。