citar org roam

citar-org-漫遊

一個 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中配置其詳細資訊。

有關其他範本想法，請參閱 wiki 並為其做出貢獻。

用法

citar-open-notes和citar-open命令將正常工作，但將使用 org-roam 打開筆記。

若要將子檔案節點定義為書目註解（ref 節點），請使用citar-org-roam-ref-add將ROAM_REF新增至該節點。

除此之外，該包提供的唯一互動式命令是：

• citar-org-roam-cited ：顯示引用所選參考文獻的註釋列表
• citar-org-roam-open-current-refs ：為目前緩衝區中與漫遊節點相關的所有引用引用開啟 Citar UI。