RStudio 插件 citr：Markdown 引用插入工具使用教程

RStudio 插件 citr：Markdown 引用插入工具使用教程

citr RStudio Addin to Insert Markdown Citations 项目地址: https://gitcode.com/gh_mirrors/ci/citr

1. 项目介绍

citr 是一个为 RStudio 编辑器设计的插件，它可以方便地在 R Markdown 文档中插入格式化的 Markdown 引用。该插件通过搜索 BibTeX 文件或 Zotero 数据库中的参考文献，帮助用户快速地添加和管理引用。

2. 项目快速启动

安装

在 RStudio 中安装 citr 插件，可以使用以下 R 代码：

# 安装稳定版本（如果 CRAN 上可用）
install.packages("citr")

# 或者从 GitHub 仓库安装最新开发版本
devtools::install_github("crsh/citr")

安装后，需要重启 RStudio 会话以激活插件。

使用 RStudio Addin

安装并重启 RStudio 后，citr 插件将出现在菜单中。你可以通过以下步骤使用它：

• 打开或创建一个 R Markdown 文档。
• 通过菜单或自定义的键盘快捷键调用 citr 插件。
• 插件将自动查找文档中 YAML 前言指定的参考文献文件。

使用命令行

如果不使用 RStudio，你也可以通过命令行使用 citr 的功能。以下是一个示例：

library(citr)
md_cite("foo 2016", bib_file = "references.bib")

这条命令将在指定的 BibTeX 文件中搜索并创建对应作者的格式化 Markdown 引用。

3. 应用案例和最佳实践

插入引用

在 R Markdown 文档中，你可以使用 citr 插件快速插入引用。例如，假设你想要引用一个作者的著作，你只需选择相应的引用并插入即可。

管理参考文献

完成写作后，你的参考文献文件可能包含一些不需要的条目。citr 提供了一个函数来清理这些无用的（或重复的）参考文献条目：

tidy_bib_file(rmd_file = "report.Rmd", messy_bibliography = "references.bib", file = "tidy_references.bib")

4. 典型生态项目

citr 插件与以下生态项目配合使用效果良好：

• Better BibTeX：如果你使用 Zotero 作为参考文献管理工具，安装 Better BibTeX 插件后，citr 可以直接访问你的参考数据库。
• bookdown：citr 默认支持 bookdown 的父文档查找机制，使得在编写书籍时管理引用更加方便。

通过以上介绍，你可以开始使用 citr 插件来简化 R Markdown 文档中的引用管理工作。

citr RStudio Addin to Insert Markdown Citations 项目地址: https://gitcode.com/gh_mirrors/ci/citr