自定义组织模式变量 - 文档在哪里?

问题描述 投票:0回答:1

几个月来我一直在使用Org-mode,当我自定义Emacs时,我在查找如何专门定制各种变量的文档方面遇到了很多困难。

示例:我已成功设置归档,但希望自定义org-archive-save-context-info变量以减少与任务一起归档的信息。我不希望每个文件都这样做,而是在我的配置文件中。尽管我付出了最大努力,但我没有看到有关自定义此语法的语法和参数的文档。

当我在Emacs UI中自定义变量时,我确实看到了一些文档 - 但我正在寻找文档,所以我可以通过配置文件查看自定义的语法和参数。我可以通过这种方式向后学习(通过“轻松自定义”):自定义变量,查看Emacs写入配置的内容,尝试调整等等。

[编辑]我正在谈论归档后出现的任务下面的信息,如下所示:

  :PROPERTIES:
  :ARCHIVE_TIME: 2018-09-10 Mon 11:24
  :ARCHIVE_FILE: ~/Dropbox/logs/capture.org
  :ARCHIVE_OLPATH: Tasks
  :ARCHIVE_CATEGORY: capture
  :ARCHIVE_TODO: DONE
  :END:

这是故意的吗?我只需要先'了解ELisp'吗?您是否打算使用Emacs点击式UI来自定义这样的内容?如果我能找到FM,我很高兴RTFM。

emacs org-mode
1个回答
2
投票

您是否打算使用Emacs点击式UI来自定义这样的内容?

如果您不了解elisp,那么您肯定会使用自定义界面(即使您这样做也可能选择使用它)。

我只需要先'了解ELisp'吗?

是的,您至少需要熟悉elisp才能理解文档并能够编写自己的配置更改。这是因为elisp是Emacs的配置语言,因此文档是在该上下文中编写的。 (在使用它们的每一篇文档中解释和重复基本的lisp概念是没有意义的。)

也就是说,许多人只是通过复制和粘贴配置示例来获得 - 而且你可能会以这种方式获取基础知识,即使你没有完全理解它们。如果你对Emacs很认真,那么花一些时间去了解elisp对你来说将是非常有益的。

我可以通过这种方式向后学习(通过“轻松自定义”):自定义变量,查看Emacs写入配置的内容,尝试调整等等。

这是完全合理的事情。

如果您有背景理解,FWIW C-hv org-archive-save-context-info实际上非常清楚。

This variable can be a list of any of the following symbols:

time       The time of archiving.
file       The file where the entry originates.
ltags      The local tags, in the headline of the subtree.
itags      The tags the subtree inherits from further up the hierarchy.
todo       The pre-archive TODO state.
category   The category, taken from file name or #+CATEGORY lines.
olpath     The outline path to the item.  These are all headlines above
           the current item, separated by /, like a file path.

这告诉您可以在配置文件中使用以下内容:

(setq org-archive-save-context-info '(time file todo))

如果我能找到FM,我很高兴RTFM。

您可以在“Emacs Lisp Intro”手册中开始学习elisp,您可以在Info目录的顶部附近找到它,或者直接使用C-hig (eintr) RET跳转到。如果您需要学习如何使用信息阅读器,请从那里输入h。

© www.soinside.com 2019 - 2024. All rights reserved.