• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

crsh/citr: RStudio Addin to Insert Markdown Citations

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

crsh/citr

开源软件地址(OpenSource Url):

https://github.com/crsh/citr

开源编程语言(OpenSource Language):

R 84.4%

开源软件介绍(OpenSource Introduction):

citr: RStudio Addin to Insert Markdown Citations

CRAN status Download counter Project Status: Active - The project has reached a stable, usable state and is being actively developed. Build status

citr provides functions and an RStudio addin to search a BibTeX-file to create and insert formatted Markdown citations into the current document.

Installation

You can either use the stable version of citr from CRAN, Due to an intermittently orphaned dependency, citr is currently not on CRAN. Due to continuing SARS-CoV-2 related lockdowns, I'm having trouble allocating time to a resubmission. In the meantime, please install citr from this GitHub repository (see below).

# install.packages("citr")

or the current development snapshot from this GitHub repository:

devtools::install_github("crsh/citr")

How to use citr

The RStudio addin

Once citr is installed and you have restarted your R session, the addin appears in the menus. Alternatively, you can define a keyboard shortcut to call the addin.

The addin will automatically look up the bibliography files specified in the YAML front matter. If the document does not contain a YAML front matter the addin will attempt to locate a parent document and look up the bibliography file specified therein. That is, the addin works its automagic even if you edit R Markdown documents that are included as children in another R Markdown document. The expected names of a parent document default to c("index.Rmd", "master.Rmd"), it thus works with bookdown out of the box, but can be customized (e.g., options(citr.parent_documents = "my_parent.Rmd")).

Using citr without RStudio

The following call searches a bibliography file and creates formatted Markdown citations for the results.

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

md_cite() searches the author, year, title, and journal fields of your references.

Better BibTeX integration

If you are using Zotero citr can access your reference database directly. For this to work, you need to install the Better BibTeX extension. Once the extension is installed and your reference manager is running, citr can access all your references and keep your bibliography file updated by adding missing references.

Tidying bibliography files

When you are done writing, your bibliography file is likely to contain some unneeded references, which you added while writing but removed during revisions. tidy_bib_file() removes unneeded (or duplicate) entries from your bibliography file.

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

Known problems

citr relies on RefManager::ReadBib() and, thus, indirectly on bibtex::read.bib() to load bibliographies. I have noticed that very long Bib(La)TeX fields can cause these underlying functions to fail (e.g., Error in do_read_bib(file, encoding = .Encoding, srcfile): lex fatal error: input buffer overflow, can't enlarge buffer because scanner uses REJECT). To avoid such problems, I strongly recommend to disable the export of potentially long metadata fields, such as abstract and notes. The Better BibTeX-plugin allows users to specify fields to omit:

Once, the above error has occurred, it may be necessary to restart the R session. Otherwise reading any other file may fail with Error: lex fatal error: fatal flex scanner internal error--end of buffer missed.

Other RStudio addins

If you are interested in other handy addins take a look at this list. There you can find other useful addins, such as rcrossref or wordcountaddin.

Package dependencies




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap