一个 emacs 软件包,提供更紧密的 Citar 和 Org-Roam 集成。
Citar 开箱即用,为与 Org-Roam v2 兼容的按注释文件书目注释提供默认支持。该软件包直接与 Org-Roam 数据库集成,并为 Citar 笔记支持提供以下附加功能:
该软件包可通过 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。