在参考部分使用 Roxygen2 模板标签答案

【问题标题】：Use Roxygen2 template tags in references section在参考部分使用 Roxygen2 模板标签
【发布时间】：2017-11-24 14:43:51
【问题描述】：

我对 Using Roxygen2 Template tags 的基础知识很有信心，它在替换对 @param 的调用时可以正常工作，但在使用模板向参考部分添加引用时遇到问题。

我在man-roxygen/refEstabrook1985.R 的模板读取

#' \cite{Estabrook G.F., McMorris F.R., Meacham C.A. 1985. Comparison of undirected phylogenetic trees based on subtrees of four evolutionary units. Syst. Zool. 34:193--200.}

我尝试了几种方法将其链接到引用块。

没有大括号

#' @references
#' @template refEstabrook1985

给出警告 Warning: @references [QuartetDistance.R#218]: requires a value 并且不呈现引用部分。

大括号，没有空格

#' @references {
#' @template refEstabrook1985
#' }

给出警告 Warning: @references [QuartetDistance.R#218]: mismatched braces or quotes Warning: @template [QuartetDistance.R#219]: mismatched braces or quotes 并且不会在 .Rd 文件中呈现引用部分。

大括号和空格

#' @references {
#'  @template refEstabrook1985
#' }

（注意额外的空格）不给出警告，但不展开模板，因此手册页显示“参考：@template refEstabrook1985”

【问题讨论】：

标签： r templates r-package

【解决方案1】：

我想我已经确定我想做的事是不可能的。 Roxygen manual 声明

模板必须由完整的标签组成——因为所有的roxygen标签都是当前块标签，它们不能用于内联插入。

另一种方法是使用 Rdpack：请参阅 Citing articles using roxygen2

【讨论】：