citar org roam

citar-org-roam

Paket emacs untuk menyediakan integrasi Citar dan Org-Roam yang lebih erat.

Fitur

Di luar kotaknya, Citar menyediakan dukungan default untuk catatan bibliografi file per catatan yang kompatibel dengan Org-Roam v2. Paket ini terintegrasi langsung dengan database Org-Roam, dan menyediakan fitur tambahan berikut untuk dukungan Citar note:

1. beberapa referensi per catatan
2. beberapa catatan referensi per file
3. kemampuan untuk menanyakan kutipan catatan dengan referensi
4. Pembaruan "langsung" Citar UI untuk kehadiran catatan
5. dukungan untuk templat penangkapan org-roam

Tangkapan layar

Instalasi

Paket ini tersedia melalui MELPA.

Konfigurasi

Mengaktifkan citar-org-roam-mode akan mengkonfigurasi Citar untuk menggunakan fungsi-fungsi ini.

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

Templat

Untuk mengubah keluaran judul catatan default, Anda dapat memodifikasi variabel citar-org-roam-note-title-template :

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

Ini akan menetapkan judul dalam database org-roam , dan juga antarmuka penyelesaian.

Untuk memformat file catatan sebenarnya, tentukan org-roam-capture-templates mana yang akan digunakan untuk pemformatan catatan bibliografi. Sebagai contoh, dengan org-roam-capture-templates didefinisikan seperti ini:

( 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 )))

… Jika Anda kemudian ingin menggunakan templat “catatan literatur” untuk catatan bibliografi baru, Anda dapat menyetel citar-org-roam-capture-template-key ke kuncinya:

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

Dalam contoh templat tersebut, variabel templat note-title menyertakan format yang disebutkan di atas untuk judul catatan baru sebagaimana ditentukan dalam citar-org-roam-note-title-template . Perhatikan juga templatnya menyertakan beberapa variabel templat terkait citar , termasuk citar-date . Ini adalah contoh data yang diteruskan dari citar ke templat pengambilan, yang detailnya dapat Anda konfigurasikan di citar-org-roam-template-fields .

Untuk ide templat tambahan, silakan lihat dan berkontribusi di wiki.

Penggunaan

Perintah citar-open-notes dan citar-open akan bekerja seperti biasa, tetapi akan menggunakan org-roam untuk membuka catatan.

Untuk mendefinisikan node sub-file sebagai catatan bibliografi (ref node), gunakan citar-org-roam-ref-add untuk menambahkan ROAM_REF ke node pada titik tersebut.

Selain itu, satu-satunya perintah interaktif yang disediakan paket ini adalah:

• citar-org-roam-cited : menyajikan daftar catatan yang mengutip referensi yang dipilih
• citar-org-roam-open-current-refs : Membuka Citar UI untuk semua referensi kutipan yang terkait dengan node roam di buffer saat ini.