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

Question

我安装了Emacs 24.3.1 (使用homebrew)，它自带org-mode，但是我无法在Emacs内置文档中（通过C-h i访问）找到org-mode的文档。

我可以在这里在线找到org-mode文档，但我更喜欢直接在Emacs中阅读。

我发现用Web浏览器而不是在Emacs内部阅读文档非常奇怪（实际上几乎与整个org-mode的文本定位相反）。

我需要单独下载和安装这个文档才能在Emacs中阅读吗？如果是这样的话，我可以在哪里找到适当的（texinfo？）文件？

还是说这个文档已经默认与Emacs捆绑在一起（我只需要配置我的现有Emacs安装以通过C-h i来浏览它）？

- kjo

---

f1 i，g，（org） - abo-abo

@abo-abo：非常感谢！如果您愿意发表评论，我很乐意接受它作为答案。 - kjo

Answer 1

• 使用 C-h i 调出信息。
• 然后调用 g (Info-goto-node)。
• 在提示符中输入 (org)。

- abo-abo

Answer 2

或者在您的.emacs文件中加入以下代码，然后使用C-h o：

(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!?

- fniessen

---

写一个自动加载表达式来代替只有当org已经加载时才让按键绑定起作用，这样不是更好吗？ - phils

这个键绑定是众多绑定之一（我没有展示其他的），但是，是的，在我看来，org-info应该自动加载。 - fniessen

您IP地址为143.198.54.68，由于运营成本限制，当前对于免费用户的使用频率限制为每个IP每72小时10次对话，如需解除限制，请点击左下角设置图标按钮（手机用户先点击左上角菜单按钮）。 - phils

信息菜单来自信息目录中的dir文件。您可以使用C-h i g (org) RET然后C-x d RET检查可能带有Org Mode条目的dir文件。我的读取为“* Org Mode：（org）。基于大纲的笔记管理和组织器”，但我不确定通常如何填充它。 - phils

关于自动加载，请参见 C-h f autoload。org-info 函数定义在 org.el 库中，因此您可以使用 (autoload 'org-info "org" "Read documentation for Org-mode in the info system." t)。 - phils

Answer 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 mode文档的目录。在这里，它是目录"/home/myself/.emacs.d/elpa/org-plus-contrib-20141222"。您可以在该目录中查找名为dir的文件 - 它描述了此目录中的信息文件。在dir中，像这样一行：

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

说有一个描述Org模式的信息节点，该节点的顶部在该目录中的文件“org”中。因此，您应确保该文件在目录中。

- Jeffrey DeLeo