#+title: Emacs 的 Org 主模式
#+setupfile: setup.org
#+html_head: <link rel="stylesheet" href="resources/style/index.min.css" type="text/css" />
#+html_head: <link rel="preload" href="resources/img/org-mode-unicorn.svg" as="image" type="image/svg+xml">
#+include: "resources/preamble.html" export html

#+html_head: <link rel="stylesheet" href="resources/style/org-demo.min.css" type="text/css" />
#+include: "resources/normal-outline-3.html" export html

#+begin_export html
<div class="banner hero" itemscope itemtype="https://schema.org/SoftwareApplication">
  <img src="resources/img/org-mode-unicorn.svg"
       alt="Org unicorn logo" itemprop="image"/>
  <div>
    <h2>
      <span itemprop="name">Org Mode</span>
      <p class="subtitle">纯文本的生活</p>
    </h2>
    <p>
      一个 <a href="https://www.gnu.org/software/emacs/" style="color: inherit; font-weight: bold; font-style: italic;"
           title="An extensible, customizable, free/libre text editor">GNU Emacs</a>
      的纯文本主模式。Org Mode 有多种用法：用户可用它来快捷且高效地<span itemprop="applicationCategory">记笔记、编写文档、计算笔记本、文学编程、维护待办事项、计划项目等等。</p>
      <p><a title="从 GNU ELPA 下载" href="https://elpa.gnu.org/packages/org.html"><img src="https://elpa.gnu.org/packages/org.svg" alt="从 GNU ELPA 下载" /></a>
        <a title="如何报告问题" href="/manual/Feedback.html"><img src="resources/img/badge-report-bug.svg" alt="如何报告问题" /></a>
        <a title="给 Org Mode 邮件列表发送邮件" href="mailto:emacs-orgmode@gnu.org"><img src="resources/img/badge-feedback.svg" alt="给 Org Mode 邮件列表发送邮件" /></a>
        <a title="使用 Git 克隆代码仓库" href="https://git.savannah.gnu.org/cgit/emacs/org-mode.git"><img src="resources/img/badge-source-code.svg" alt="使用 Git 克隆代码仓库" /></a>
        <a title="sr.ht 项目主页" href="https://sr.ht/~bzg/org"><img src="resources/img/badge-srht-project.svg" alt="sr.ht 项目主页"/></a></p>
    <p class="bubble">
    在 <a href="https://liberapay.com/org-mode" title="感谢捐款"
         style="font-weight: bold; display: inline-block">
        <img class="inline" src="resources/img/external/librepay.svg" alt="Liberapay logo"/>
        Liberapay</a> 上支持 Org </p>
    <meta itemprop="operatingSystem" content="Linux, MacOS, Windows">
    <meta itemprop="softwareVersion" content="9.3.8">
    <meta itemprop="datePublished" content="2020-08-07">
    <meta itemprop="url" content="."> <!-- TODO: what is the use of this? -->
  </div>
</div>
<div class="banner slim grey faded inline">
  <p style="width:90vw; color:#515151"> 作者：<a
     target="new" href="https://staff.science.uva.nl/~dominik/"
     style="font-weight:500; color:inherit">Carsten Dominik</a>（<a
     target="new" href="/manual/History-and-Acknowledgments.html" style="color:#6e6e6e"
     >2003</a>）；维护者：<a target="new" href="https://bzg.fr/en/" style="font-weight:500; color:inherit"
     >Bastien Guerry</a>；开发者：<a href="/org.html#History-and-Acknowledgments" style="color:#6e6e6e">大量贡献者</a>。</p>
</div>
#+end_export

* 主要亮点
  :PROPERTIES:
  :HTML_CONTAINER_CLASS: columns no-heading
  :END:

** 功能
   @@html:<a href="features.html">@@
   #+attr_html: :alt 三颗星星 :title 无尽可能
   [[file:resources/img/stars.svg]]

   @@html:</a>@@

** 安装
   @@html:<a href="../org.html#Installation">@@
   #+attr_html: :alt 下箭头 :title 你还在等什么？
   [[file:resources/img/install.svg]]

   @@html:</a>@@

** 快速开始
   @@html:<a href="quickstart.html">@@
   #+attr_html: :alt 火箭 :title 立即开始，你会爱上它。
   [[file:resources/img/quickstart.svg]]

   @@html:</a>@@

** 贡献
   @@html:<a href="../worg/org-contribute.html">@@
   #+attr_html: :alt Git branch 图标 :title 多多益善。
   [[file:resources/img/contribute.svg]]

   @@html:</a>@@

* Elaboration + demo image                                        :ignore:

#+attr_html: :style margin-top:2rem;

Org 是一个非常灵活的有结构的纯文本文件格式，由几种简单而又多用的结构组成。因此，Org 即足够[[https://karl-voit.at/2017/09/23/orgmode-as-markup-only/][简单]]，又足够[[http://howardism.org/Technical/Emacs/literate-devops.html][强大]]。

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

#+include: org-demo.html export html

* 更多资料
  :PROPERTIES:
  :CUSTOM_ID: reading
  :END:

除开[[file:quickstart.org][快速开始]]与[[file:../manual/][手册]]之外，Org 还有一个[[file:../guide/][指南]]和大量由社区编写的文档：[[file:../worg/][Worg]]。

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

* 更多 Org
  :PROPERTIES:
  :CUSTOM_ID: more
  :END:

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

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

#+begin_center
#+attr_html: :class btn
[[file:tools.org][能与 Org 交互的工具]]
#+end_center

* [[file:../worg/][Worg]]，Org /世界/
  :PROPERTIES:
  :CUSTOM_ID: worg
  :END:

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

举个例子，[[file:../worg/][Worg]]包含了：

- [[file:../worg/org-faq.html][常见问题]]
- [[file:../worg/org-hacks.html][Org 妙招]]
- [[file:../worg/org-tutorials/index.html][各种教程]]
- [[file:../worg/doc.html][所有挂勾、命令与选项的文档]]
- [[file:../worg/org-in-the-wild.html][野生的 Org]]
- /……以及更多/

[[file:../worg/][Worg]]是一个装有 Org 文件的 Git 代码仓库，发步为 HTML 网页，[[file:../worg/worg-about.html#contribute-to-worg][欢迎贡献]]。

#+BEGIN_SRC shell
~$ git clone https://git.sr.ht/~bzg/worg
#+END_SRC

* 加入邮件列表
  :PROPERTIES:
  :CUSTOM_ID: mailing-list
  :END:

Org 邮件列表是一个能与整个 Org 社区交流的地方。你可以[[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][订阅此列表]]，也可以在[[https://list.orgmode.org][list.orgmode.org]]或者[[https://lists.gnu.org/archive/html/emacs-orgmode/][此 mailman 网页]]浏览往期邮件。​_请注意，此列表需要使用英语交流。_

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

更多关于邮件列表的信息请见[[file:../worg/org-mailing-list.html][此网页（英语）]]。此外，Org 还有其它的[[file:../worg/org-web-social.html][社交平台（英语）]]。

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

Org 的完整贡献者列表在 /Worg/ 里[[file:../worg/contributors.html][可见（英语）]]。你也可以查看手册的[[/org.html#History-and-Acknowledgments][鸣谢（英语）]]。

* Doom，Spacemacs，Scimax以及热门配置
  :PROPERTIES:
  :CUSTOM_ID: configs
  :END:

[[https://github.com/hlissner/doom-emacs][Doom]]，[[https://www.spacemacs.org/][Spacemacs]]，以及[[https://github.com/jkitchin/scimax][Scimax]]这几个 Emacs 入门工具包包含了一系列经过精细管理过的组件与配置，目标是给常用的 Org（以及 Emacs 本身）用法带来优化。它们包含了 =org-mode= 与其它模式的集成（例如 =evil-mode=​）。这里是它们目前使用的组件列表：[[https://github.com/hlissner/doom-emacs/blob/develop/modules/lang/org/packages.el][Doom]]、[[https://github.com/syl20bnr/spacemacs/blob/master/layers/%2Bemacs/org/packages.el][Spacemacs]]。​/Scimax/ 与 Org 紧密集成，所以 /Scimax/ 用户应先参考它的[[https://github.com/jkitchin/scimax/blob/master/scimax.org#org-mode][手册（英语）]]。​/Doom/ 使用的 Org 版本接近与开发版 ~HEAD~​，而 /Spacemacs/ 与 /Scimax/ 使用的则是 Org 在 GNU ELPA 上发步的版本。

各种入门工具包通常大量修改了 Emacs 的默认用户设置。如果你更偏向于原版 Emacs，可以参考包含配置了 Org 及其关联组件的热门配置，例如 [[https://github.com/purcell/emacs.d/blob/master/lisp/init-org.el][Purcell 的 emacs.d]]。

* 其它文本编辑器
  :PROPERTIES:
  :CUSTOM_ID: editors
  :END:

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

- *Vim* : [[https://github.com/kristijanhusak/orgmode.nvim][orgmode.nvim]]、[[https://github.com/jceb/vim-orgmode][vim-orgmode]]、 [[https://github.com/axvr/org.vim][org.vim]]
- *Atom* : [[https://atom.io/packages/org-mode][org-mode]]
- *VS Codium* : [[https://github.com/vscode-org-mode/vscode-org-mode][vscode-org-mode]]