R bibstyle 選擇或定義參考書目樣式

說明

該函數定義並注冊渲染樣式bibentry對象進入‘路’ 格式，以便稍後轉換為文本、HTML 等。

用法

bibstyle(style, envir, ..., .init = FALSE, .default = TRUE)
getBibstyle(all = FALSE)

參數

style	命名樣式的字符串。
envir	(可選)包含實現樣式的函數的環境。
...	要添加到環境中的命名參數。
.init	是否從默認樣式 "JSS" 初始化環境。
.default	是否將指定樣式設置為默認樣式。
all	是否返回所有注冊樣式的名稱。

細節

bibentry 對象的渲染可以使用按照 BibTeX 使用的例程建模的例程來完成。此函數允許創建和操作環境以包含這些例程。

創建新風格環境有兩種方法。最簡單的就是設置.init = TRUE，在這種情況下，環境將使用默認的副本進行初始化"JSS"環境。 (這種風格是模仿‘jss.bst' 所使用的風格統計軟件雜誌.) 或者，envir參數可用於指定全新的樣式環境。

要查找默認樣式的名稱，請使用 getBibstyle() 。要檢索現有樣式而不將其設置為默認樣式，請使用 bibstyle(style, .default = FALSE) 。要修改現有樣式，請通過 ... 指定 style 和一些命名條目。 (不鼓勵修改默認的 "JSS" 樣式。)將 style 設置為 NULL 或將其保留缺失將檢索默認樣式，但不允許修改。

至少，環境應包含用於呈現 bibentry 支持的 12 種書目條目中每一種的例程以及下麵說明的其他幾個例程。前者必須命名為 formatArticle , formatBook , formatInbook , formatIncollection , formatInProceedings , formatManual , formatMastersthesis , formatMisc , formatPhdthesis , formatProceedings , formatTechreport 和 formatUnpublished 。其中每一個都采用一個參數，即傳遞給渲染器的 bibentry 向量中的單個 unclass 'ed 條目，並且應生成單個元素字符向量(可能包含換行符)。

其他例程如下。 sortKeys 是一個生成排序鍵以對條目進行排序的函數，它會傳遞原始 bibentry 向量，並且應該生成相同長度的可排序向量來定義排序順序。最後，可選函數 cite 應具有與 utils::cite 相同的參數列表，並且應生成要在文本中使用的引用。

"bibentry" 對象的 format 方法在排序之後和格式化之前向每個條目添加一個名為 ".index" 的字段。這是完整對象中從 1 開始的索引，可用於需要編號的樣式。盡管 "JSS" 樣式不使用數字，但它包含可用於顯示數字的 fmtPrefix() 存根函數。請參閱下麵的示例。

值

bibstyle 返回已選擇或創建的環境。

getBibstyle 返回默認樣式的名稱或所有樣式名稱。

例子

refs <-
c(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"),
  bibentry(bibtype = "article",
    author = c(person(c("George", "E.", "P."), "Box"),
               person(c("David",  "R."),      "Cox")),
    year = 1964,
    title = "An Analysis of Transformations",
    journal = "Journal of the Royal Statistical Society, Series B",
    volume = 26, number = 2, pages = "211--243",
    doi = "10.1111/j.2517-6161.1964.tb00553.x"))

bibstyle("unsorted", sortKeys = function(refs) seq_along(refs),
    fmtPrefix = function(paper) paste0("[", paper$.index, "]"),
       .init = TRUE)
print(refs, .bibstyle = "unsorted")

作者

Duncan Murdoch

也可以看看

bibentry