citar org roam

citar-org-roam

Пакет emacs, обеспечивающий более тесную интеграцию Citar и Org-Roam.

Функции

В стандартной комплектации Citar обеспечивает поддержку по умолчанию библиографических примечаний по каждому файлу, совместимых с Org-Roam v2. Этот пакет напрямую интегрируется с базой данных Org-Roam и предоставляет следующие дополнительные функции для поддержки заметок Citar:

1. несколько ссылок на заметку
2. несколько справочных примечаний в файле
3. возможность запрашивать цитаты заметок по ссылке
4. «живое» обновление Citar UI для наличия заметок
5. поддержка шаблонов захвата роуминга организации

Скриншот

Установка

Этот пакет доступен через MELPA.

Конфигурация

Активация citar-org-roam-mode настроит Citar на использование этих функций.

( use-package citar-org-roam
  :after (citar org-roam)
  :config (citar-org-roam-mode))

Шаблоны

Чтобы изменить вывод заголовка заметки по умолчанию, вы можете изменить переменную citar-org-roam-note-title-template :

( setq citar-org-roam-note-title-template " ${author} - ${title} " )

Это установит заголовок в базе данных org-roam и, следовательно, интерфейс завершения.

Чтобы отформатировать сам файл примечания, укажите, какой из org-roam-capture-templates использовать для форматирования библиографических примечаний. Например, с org-roam-capture-templates определенными следующим образом:

( setq org-roam-capture-templates
      '(( " d " " default " plain
         " %? "
         :target
         (file+head
          " %<%Y%m%d%H%M%S>-${slug}.org "
          " #+title: ${note-title} n " )
         :unnarrowed t )
        ( " n " " literature note " plain
         " %? "
         :target
         (file+head
          " %(expand-file-name (or citar-org-roam-subdir "" ) org-roam-directory)/${citar-citekey}.org "
          " #+title: ${citar-citekey} (${citar-date}). ${note-title}. n #+created: %U n #+last_modified: %U nn " )
         :unnarrowed t )))

… если вы затем захотите использовать свой шаблон «литературных заметок» для новых библиографических заметок, вы можете установить citar-org-roam-capture-template-key его ключ:

( setq citar-org-roam-capture-template-key " n " )

В этом примере шаблона переменная шаблона note-title включает указанное выше форматирование для новых заголовков заметок, как указано в citar-org-roam-note-title-template . Обратите также внимание, что шаблон включает в себя некоторые переменные шаблона, связанные с citar , включая citar-date . Это пример данных, передаваемых из citar в шаблон захвата, детали которого вы можете настроить в citar-org-roam-template-fields .

Дополнительные идеи шаблонов можно найти в вики и внести свой вклад.

Использование

Команды citar-open-notes и citar-open будут работать как обычно, но для открытия заметок будут использоваться org-roam.

Чтобы определить узел подфайла как библиографическую заметку (ссылочный узел), используйте citar-org-roam-ref-add чтобы добавить ROAM_REF к узлу в данной точке.

Помимо этого, единственная интерактивная команда, предоставляемая этим пакетом:

• citar-org-roam-cited : представляет список заметок, в которых цитируются выбранные ссылки.
• citar-org-roam-open-current-refs : открывает пользовательский интерфейс Citar для всех ссылок на цитаты, связанных с узлом roam-node в текущем буфере.