Настройка переменных режима Org - где находится документация? - PullRequest
0 голосов
/ 14 сентября 2018

Я пользуюсь режимом Org несколько месяцев, и, когда я настраиваю Emacs, мне очень трудно найти документацию о том, как конкретно настраивать различные переменные.

Пример: я имеюуспешно настроить архивирование, но хотите настроить переменную org-archive-save-context-info, чтобы уменьшить объем информации, которая архивируется вместе с задачей. Я не хочу делать это для каждого файла, но в моем конфигурационном файле. Несмотря на все мои усилия, я не вижу документации по синтаксису и параметрам для его настройки.

Я делаю см. Некоторую документацию, когда я настраиваю переменную в пользовательском интерфейсе Emacs - но я ищу документацию, чтобы я мог видеть синтаксис и параметры для его настройки самостоятельно через файл конфигурации,Я могу выучить это задом наперед (через «простую настройку»): настроить переменную, посмотреть, что Emacs записал в конфигурацию, попытаться настроить это и т. Д.

[EDIT] Я говорю об информации нижезадание, которое появляется после архивирования, например:

  :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 «укажи и щелкни», чтобы настроить подобные вещи?Рад RTFM, если смог найти FM.

1 Ответ

0 голосов
/ 15 сентября 2018

Предполагается ли, что вы используете пользовательский интерфейс Emacs, чтобы настроить что-то подобное?

Разумеется, предполагается, что вы будете использовать интерфейс настройки, если вы не знаете, elisp (и вы можете использовать его, даже если вы знаете).

Нужно ли сначала "знать ELisp"?

Да, вам понадобится хотя бы некоторое знакомство с elisp, чтобы понять документацию и написать собственные изменения конфигурации. Это потому, что elisp является языком конфигурации для Emacs, и поэтому документация написана в этом контексте. (Не имеет смысла объяснять и повторять базовые концепции LISP в каждом документе, который их использовал.)

Тем не менее, многие люди просто копируют и вставляют из примеров конфигурации - и вы, вероятно, поймете основы таким образом, даже если вы не до конца их понимаете. Если вы серьезно относитесь к Emacs, потратить некоторое время на изучение elisp будет чрезвычайно полезно для вас в будущем.

Я могу выучить это задом наперед (через «простую настройку»): настроить переменную, посмотреть, что Emacs записал в конфигурацию, попытаться настроить это и т. Д.

Это вполне разумно.

FWIW C-h v 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))

Рад RTFM, если смог найти FM.

Вы можете начать изучать elisp в руководстве "Emacs Lisp Intro", которое вы должны найти в верхней части каталога Info, или перейти непосредственно к Ch i г (eintr) RET . Введите h оттуда, если вам нужно научиться пользоваться считывателем информации.

...