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