R cite 引用參考書目條目

說明

在文本中引用bibentry 對象。 cite() 函數使用默認 bibstyle 中的 cite() 函數(如果存在)或 citeNatbib()(如果不存在)。 citeNatbib() 使用與 LaTeX 包 natbib 類似的樣式。

用法

cite(keys, bib, ...)
citeNatbib(keys, bib, textual = FALSE, before = NULL, after = NULL,
           mode = c("authoryear", "numbers", "super"),
           abbreviate = TRUE, longnamesfirst = TRUE,
           bibpunct = c("(", ")", ";", "a", "", ","), previous)

參數

keys	要引用的條目鍵的字符向量。單個條目中可能包含多個鍵，並用逗號分隔。
bib	一個 "bibentry" 對象，包含要在其中查找鍵的文檔列表。
...	要傳遞給默認樣式的 cite() 函數的其他參數。
textual	產生“textual”風格的引文，即什麽‘⁠\citet⁠' 將在 LaTeX 中生成。
before	在引文之前顯示的可選文本。
after	引文後顯示的可選文本。
mode	引用的“mode”。
abbreviate	是否縮寫長作者列表。
longnamesfirst	如果是 abbreviate == TRUE ，是否保留第一個引用很長。
bibpunct	引文中使用的標點符號向量，如 natbib 中使用的。請參閱詳細信息部分。
previous	先前引用的鍵列表，在 abbreviate == TRUE 和 longnamesfirst == TRUE 時使用

細節

參數名稱是根據 LaTeX natbib 包的文檔選擇的。請參閱該文檔了解 bibpunct 條目的解釋。

bibpunct中的條目如下：

1. 左分隔符。

2. 正確的分隔符。

3. 引文中參考文獻之間的分隔符。

4. “mode” 的指示符："n" 表示數字，"s" 表示上標，author-year 表示其他任何內容。

5. 作者和年份之間的標點符號。

6. 當作者身份被壓製時，年份之間的標點符號。

請注意，如果指定了 mode，它將覆蓋 bibpunct[4] 中的模式規範。部分匹配用於 mode 。

citeNatbib 的默認值已選擇為匹配 JSS 樣式，並且默認情況下這些值用於 cite 中。請參閱bibstyle 了解如何設置不同的默認樣式。

值

返回單個元素字符串，其中包含引文。

例子

## R reference
rref <- bibentry(
   bibtype = "Manual",
   title = "R: A Language and Environment for Statistical Computing",
   author = person("R Core Team"),
   organization = "R Foundation for Statistical Computing",
   address = "Vienna, Austria",
   year = 2013,
   url = "https://www.R-project.org/",
   key = "R")

## References for boot package and associated book
bref <- c(
   bibentry(
     bibtype = "Manual",
     title = "boot: Bootstrap R (S-PLUS) Functions",
     author = c(
       person("Angelo", "Canty", role = "aut",
         comment = "S original"),
       person(c("Brian", "D."), "Ripley", role = c("aut", "trl", "cre"),
         comment = "R port, author of parallel support",
         email = "ripley@stats.ox.ac.uk")
     ),
     year = "2012",
     note = "R package version 1.3-4",
     url = "https://CRAN.R-project.org/package=boot",
     key = "boot-package"
   ),

   bibentry(
     bibtype = "Book",
     title = "Bootstrap Methods and Their Applications",
     author = as.person("Anthony C. Davison [aut], David V. Hinkley [aut]"),
     year = "1997",
     publisher = "Cambridge University Press",
     address = "Cambridge",
     isbn = "0-521-57391-2",
     url = "http://statwww.epfl.ch/davison/BMA/",
     key = "boot-book"
   )
)

## Combine and cite
refs <- c(rref, bref)
cite("R, boot-package", refs)

## Cite numerically
savestyle <- tools::getBibstyle()
tools::bibstyle("JSSnumbered", .init = TRUE,
         fmtPrefix = function(paper) paste0("[", paper$.index, "]"),
         cite = function(key, bib, ...)
         	citeNatbib(key, bib, mode = "numbers",
         	    bibpunct = c("[", "]", ";", "n", "", ","), ...)
         )
cite("R, boot-package", refs, textual = TRUE)
refs

## restore the old style
tools::bibstyle(savestyle, .default = TRUE)

作者

Duncan Murdoch