如何在 Emacs 中阅读 org-mode 文档？答案

【问题标题】：How to read org-mode documentation inside Emacs?如何在 Emacs 中阅读 org-mode 文档？
【发布时间】：2015-01-23 22:55:49
【问题描述】：

我安装了 Emacs 24.3.1（使用 homebrew），它已经与 org-mode 一起提供，但我在 Emacs 内置文档中找不到 org-mode 的文档（可通过 C-h i 访问） .

我可以在网上找到org-mode 文档here，但我更喜欢直接在 Emacs 中阅读。

我觉得非常奇怪（实际上几乎与整个 org-mode 文本方向相反）发现自己必须使用 Web 浏览器而不是在 Emacs 中阅读此文档。

我是否需要单独下载并安装此文档才能在 Emacs 中阅读它？如果是这样，我在哪里可以找到合适的（texinfo？）文件？

或者这个文档是否已经默认与 Emacs 捆绑在一起（我只需要配置我当前的 Emacs 安装，以便能够通过 C-h i 浏览它）？

【问题讨论】：

【解决方案1】：

【讨论】：

【解决方案2】：

或C-h o 在您的.emacs 文件中使用以下代码：

(with-eval-after-load "org"

  ;; Display the Org mode manual in Info mode.
  (define-key global-map (kbd "C-h o") 'org-info)) ; Not autoloaded!?

【讨论】：

为那个函数写一个自动加载表达式不是更好吗，而不是在 org 已经加载的情况下只用键绑定做任何事情？
这个键绑定是其中之一（我没有展示其他的），但是，是的，应该自动加载 IMO org-info。
我的意思是您的答案可能包含 (autoload ...) 表达式，后跟 define-key（或 global-set-key）表达式。如果您希望自动加载某些内容，您可以修复它。
信息菜单来自信息目录中的dir 文件。您可以使用C-h i g (org) RET 然后C-x d RET 来检查dir 文件，该文件可能具有组织模式条目。我的读作“* Org Mode: (org). 基于大纲的笔记管理和组织者”，但我不确定它是如何正常填充的。
关于自动加载，请参阅C-h f autoload。 org-info 函数在 org.el 库中定义，因此您可以使用 (autoload 'org-info "org" "Read documentation for Org-mode in the info system." t)

【解决方案3】：

如果您可以像 abo-abo 等其他人所描述的那样访问 Org 模式文档，那么您就大功告成了。如果您仍然没有找到，请继续阅读。

在您正在运行的 emacs 中，查看变量 Info-directory-list。它的值可能看起来像这样：

("/home/myself/.emacs.d/elpa/org-plus-contrib-20141222" "/usr/share/info/emacs-24" "/usr/share/info/" "/usr/share/info/")

这里的重点是应该有一个包含 Org 模式文档的目录。这里是目录"/home/myself/.emacs.d/elpa/org-plus-contrib-20141222"。您可以在该目录中查找名为 dir 的文件 - 它描述了该目录中的信息文件。在 dir 中，像这样的一行：

* Org Mode: (org).      Outline-based notes management and organizer

表示有一个描述组织模式的信息节点，该节点的顶部位于该目录中的文件org中。所以你应该确保该文件在目录中。

【讨论】：