#+title: 功能 | Org
#+setupfile: setup.org
#+include: "resources/preamble.html" export html

#+begin_export html
<style>
  .side-fig img {
    filter: invert(1.4%);
    box-shadow: none;
    max-width: 100%;
  }
  #content {
    max-width: none;
  }
  body {
    padding: 1em 0 0 0;
  }
  .outline-text-3 p {
    padding-bottom: 0.5em;
  }
  :root {
    --body-left: 0 !important;
    --body-right: 0 !important;
  }
</style>

<script type="text/javascript" async src="../resources/js/org-quotes.js"></script>
<div class="banner slim"> <p id="a-quote"></p> </div>
#+end_export

* 多种标记选项
  :PROPERTIES:
  :CUSTOM_ID: markup
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :style max-height:12em; :alt 使用文字元素标记文本的例子
[[file:resources/img/features/simple-syntax.svg]]

** 描述

Org 常被用于构建与管理复杂的工作流程。为此，Org 使用了优美且简单的语法，从最基本的标记到完整的 LaTeX 排版，从纯文本到文学程序，都可以使用 Org 编写而成。

以下这个例子包含了所有你开始使用 Org 需要的内容。

*** 更多

详见手册（英语）：[[file:../manual/Markup-for-Rich-Contents.html][标记]]

* 结构化的编辑@@comment:与导航@@
  :PROPERTIES:
  :CUSTOM_ID: editing
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt 演示在 Org 里折叠与显示章节
[[file:resources/img/features/folding.gif]]

** 描述

Org 里最基础的结构是由可嵌套、可折叠的章节构成的树。你可以使用一个快捷键 ----- =tab= ----- 来折叠、展开整个树。

Org 的树结构给用户带来了快速且优雅的导引与强大的信息遮避功能，让你在保持获取需要信息的能力的同时专心于手头的任务。

控制章节可见与否只是 Org 的一个小小的功能，而 Org 仍有其它多种工具与命令来为纯文本结构化的编辑带来便利。 Org 的语法让用户把枯燥的任务变成了单个的键盘命令，让用户更着重于内容而不是形式。

*** 更多

详见手册（英语）：[[file:../manual/Document-Structure.html][文档结构]]

* 透明化的表格处理
  :PROPERTIES:
  :CUSTOM_ID: tables
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt 在 Org 中处理表格，移动行列以及运行公式
[[file:resources/img/features/tables.gif]]

** 描述

Org 自带了一个强大的表格编辑器。

按 =tab= 可以左右移动；按 =return= 可以上下移动。

在内容发生改变时，表格结构会自动更新。

可以从 =.csv= 和 =.tsv= 文件，或直接从当前缓存区中导入表格，也可以把表格导出到任何 Org 支持的格式。

Org 表格不只是静态的数据堆积。它也可以被视作一个完整的[[file:../manual/The-Spreadsheet.html][表格]]系统，包含公式、引用等等 ----- 同时不失其作为纯文本系统的简洁与透明。

*** 更多

详见手册（英语）：[[file:../manual/Built_002din-Table-Editor.html][表格编辑器]]、[[file:../manual/The-Spreadsheet.html][表格系统]]

Worg 教程（英语）：[[file:../worg/org-tutorials/tables.html][使用表格工作]]、[[file:../worg/org-tutorials/org-spreadsheet-intro.html][表格系统]]

* 更优越的源代码
  :PROPERTIES:
  :CUSTOM_ID: babel
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt Demonstration of Org Babel executing code blocks
[[file:resources/img/features/babel.gif]]

** 描述

Org 提供的功能远远超过[[https://jupyter.org/][Jupyter]]、[[https://rmarkdown.rstudio.com/][R Markdown]]等计算笔记本。

# Program your way.
[[file:../worg/org-contrib/babel/][Org babel]]把可运行的代码区转换为一个完整的[[https://en.wikipedia.org/wiki/Literate_programming][文学编程（英语，外网）]]环境，使得用户可以用输入与输出串联不同的语言、运行环境、甚至不同的设备到同一个系统里。用户就此可以在[[https://en.wikipedia.org/wiki/Don%27t_repeat_yourself][DRY（英语，外网）]]上达到一个前所为有的高度。

# Free your code
使用 Org ，你可以非常简单地从同一个文件里提取源代码与生成帮助文档。尽管很多语言支持从代码备注里生成文档，Org 还可以同时在同一个文件里放入开发者指南、用户手册、实现以及测试 ----- 因此，每个 Org 文件是唯一的、不会逐步失去同步的信息源。

# Emacs. We will add your technological distinctiveness to our own.
Org 目前支持超过[[file:../worg/org-contrib/babel/languages/index.html][80种不同语言]]，并且像[[https://github.com/nnicandro/emacs-jupyter#org-mode-source-blocks][emacs-jupyter]]这样的组件使得用户可以利用 Jupyter 内核生态来使用更多的语言。

*** 更多

详见手册（英语）：[[file:../manual/Working-with-Source-Code.html][使用源代码]]

Worg（英语）：[[file:../worg/org-contrib/babel/languages/index.html][支持语言]]列表

* 导出与发表
  :PROPERTIES:
  :CUSTOM_ID: publishing
  :HTML_CONTAINER_CLASS: side-fig
  :END:
# Powerful publishing

#+attr_html: :class main-image :alt 示范如何把一个 Org 文件导出到 HTML，markdown，PDF 以及纯文本
[[file:resources/img/features/exports.gif]]

** 描述

Org 是一个撰写与发表的工具 ----- 它既可以是静态网页生成器，也可以是一系列为发表内容提供便利的工具。

你使用 Org 的简洁易懂的标记语法来撰写稿件，然后导出到你所选择的任何一种格式。 Org 支持很多格式，其中包含：

- =HTML=
- \(\LaTeX\)
- =ODT=
- 以及更多！

开发者可以轻松地为任何格式创造新的导出后端（详见[[file:../worg/dev/org-export-reference.html][ox的文档]]),并且 Org 也被[[https://pandoc.org][Pandoc]]支持。

除开导出单一的文件以外，你还可以​/发表项目/ ----- 将一个或更多的 =.org= 文件以及其需要的各种资源导出到一个或更多的发表后端。

*** 更多

冷知识：Org 的网页是由 Org 编写而成！

详见手册（英语）：[[file:../manual/Markup-for-Rich-Contents.html][标记]]，[[file:../manual/Exporting.html][导出]]，[[file:../manual/Publishing.html][发表]]

Worg 教程（英语）：发表到 [[file:../worg/org-tutorials/org-publish-html-tutorial.html][HTML]] ；发表到 [[file:../worg/org-tutorials/org-latex-export.html][\(\LaTeX\)]]

* 把握任务的进程
  :PROPERTIES:
  :CUSTOM_ID: planning
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt 演示在 Org 里设置计划，管理一个待办事项
[[file:resources/img/features/planning.gif]]

** 描述

Org 是一个功能齐全的任务计划工具、时间管理工具以及待办事项工具。

任何一个章节都可以通过增加例如 =TODO= 或者 =HOLD= 等关键词来被设置成​/待办/​。你可以由此跟踪纪录此任务的进度。你也可以使用快捷键 =S-<left>= 和 =S-<right>= 来把任务切换到不同状态。

需要增加其他的任务状态？没问题。你可以根据你的工作流程自由地设置任务状态。

在 Org /日程/​（Agenda）里，你可以轻松地查看多个文件里的任务 ----- 你仅需要添加一个任务状态关键词，例如 =TODO=​。Org 为以下功能有内置支持：任务优先级、截止日期、计划中任务、标签、打卡等等。​/日程/​能够使用上述所有功能来整理任务以及设置优先级。因此，在仅仅使用纯文本标记的同时，你可以把一个简单的待办事项列表无缝升级为一个完整的项目管理软件。

*** 更多

详见手册（英语）：[[file:../manual/TODO-Items.html][待办事项]]、处理[[file:../manual/Dates-and-Times.html][日期与时间]]

* 可执行的日程表
  :PROPERTIES:
  :CUSTOM_ID: agendas
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt Org 日程的一个例子，显示了不同的待办关键词、优先级、分类方式以及计划
[[file:resources/img/features/agenda.svg]]

** 描述

轻松计划你的一天，方式由你而定。

在​/日程界面/​里（一个由你所有待办事项组成的报告），你可以看到你每日、每周、每月的任务。

就算你有上百个 =.org= 文件以及上千个任务，日程仍可以让你集中精力攻克你最需要响应的任务 ----- 并且你可以从日程的优先级界面可以直接跳到你手头这个需要完成的任务。

日程的默认界面显示了你当周里计划中的、临近截止的、暂停的、以及未完成的待办任务。

对这个默认界面不满意？你可以随意修改 Org 日程的配置。你既可以修改其默认界面，也可以创建[[file:../manual/Custom-Agenda-Views.html][自定义界面]]。

从某种程度上来说，Org 是一个富有表达力的、能抓取在工作进程里的交互关键点的语言，使你在因生活、工作、娱乐等等需要构建新的工作进程时的步骤变得更加简单易懂。

*** 更多

详见手册（英语）：[[file:../manual/Agenda-Views.html][日程界面]]

Worg 教程（英语）：[[file:../worg/org-tutorials/org-custom-agenda-commands.html][日程命令]]

* 打卡
  :PROPERTIES:
  :CUSTOM_ID: clocking
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt 使用 Org 来纪录每个小任务花费的时间
[[file:resources/img/features/clocking.svg]]

** 描述

使用 Org /打卡/​（clocking）来纪录你花费在任务上的时间。你可以在一天结束之际生成关于你当天如何使用时间的报告。

Org 提供了给开始任务与结束任务打卡的快捷键。当你在使用一个 =.org= 文件时，按下 =C-c C-x C-i= 来打卡开始任务，​=C-c C-x C-o= 来打卡结束任务。所有的打卡时间都被存储在该任务标题的属性抽屉里。

当你在日程界面时，你可以使用 =I= 和 =O= 打卡。

*** 更多

详见手册（英语）：[[file:../manual/Clocking-Work-Time.html][任务打卡]]

* 从任何地方抓取信息
  :PROPERTIES:
  :CUSTOM_ID: capturing
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt 使用 Org Capture 来纪录编辑文件时产生的一个想法
[[file:resources/img/features/capturing.gif]]

** 描述

你可以​/抓取/​信息，然后把它加入到一个 =.org= 文件里。

你可以从任何地方抓取信息 ----- 可以是一个 Emacs 缓存区，也可以是其它程序，例如你的浏览器、PDF 阅览器等等。

抓取模版让你快速且便捷地从各种工作流程中抓取信息，例如增加新任务、引用手册的关联章节、或者保存收据。

*** 更多

详见手册（英语）：[[file:../manual/Capture.html][抓取]]

* 极度的可扩展性
  :PROPERTIES:
  :CUSTOM_ID: extensibiliy
  :HTML_CONTAINER_CLASS: side-fig
  :END:

#+attr_html: :class main-image :alt 显示一些自带的以及自定义的链接种类
[[file:resources/img/features/links.svg]]

** 描述

Org 不只是一般的“可扩展”；它是 /Emacs 级别/​的可扩展。

Org 起初只是 Emacs 的一个扩展组件。因此，Org 的各方各面都包含了对可扩展性的考量。

举一个小小的例子：超链接。当你在更新开发文档时你会经常重复引用到项目的问题列表，例如GitHub Issues。你可以在 Org 文件里添加一个新的 ~issue:~ 链接类型，使得类似​~[[issue:74][big bug]]~​的链接能够引用到​=https://github.com/author/repo/issues/74=​。

除了超链接，你也可以自定义解析函数、使用 [[https://www.emacswiki.org/emacs/TrampMode][Tramp]] 链接远程设备的文件，等等。