r - 添加示例时，pkgdown 无法解析 Rd 文件

Question

出于某种原因pkgdown无法解析我的包中的 .Rd 文件之一。当我向 roxygen2 添加示例时，我发现它失败了使用 @examples 的文档标签或 @example inst/example/add.R选择。我将我的函数最小化为两个参数，以使其更“可重现”并且仍然得到相同的错误。请在错误消息下方找到使用该 devtools::document() 生成的 .Rd 文件以及函数的 roxygen2 文档。正如你所看到的，我正在使用一个非常简单的例子，它应该可以毫无问题地运行......还有一件事要说的是，当我运行 devtools::check() 时。我所有的例子都通过了，所以我不明白为什么 pkgdown正在失败。
非常感谢你的帮助。
最好的事物，
错误信息

Reading 'man/merge.Rd'
Error : Failed to parse Rd in merge.Rd
i unused argument (output_handler = evaluate::new_output_handler(value = pkgdown_print))
Error: callr subprocess failed: Failed to parse Rd in merge.Rd
i unused argument (output_handler = evaluate::new_output_handler(value = pkgdown_print))

.rd 文件

% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/merge.R
\name{merge}
\alias{merge}
\title{Merge two tables}
\usage{
merge(x, y)
}
\arguments{
\item{x}{data frame: referred to \emph{left} in R terminology, or \emph{master} in
Stata terminology.}

\item{y}{data frame: referred to \emph{right} in R terminology, or \emph{using} in
Stata terminology.}
}
\value{
a data.table joining x and y.
}
\description{
This is the main and, basically, the only function in joyn.
}
\examples{
x <- c(1, 2)
}

roxygen2 文档

#' Merge two tables
#'
#' This is the main and, basically, the only function in joyn.
#'
#' @param x data frame: referred to *left* in R terminology, or *master* in
#'   Stata terminology.
#' @param y data frame: referred to *right* in R terminology, or *using* in
#'   Stata terminology.
#' @return a data.table joining x and y.
#' @export
#' @import data.table
#'
#' @examples
#' x <- c(1, 2)

Answer 1

这个错误来自 downlit::evaluate_and_highlight (遗憾的是它没有在输出中报告)，并且可以通过安装 downlit 的开发版本来修复。 :

library(devtools)
install_github('r-lib/downlit')

仅当您使用来自 pkgdown 的 git 版本时才有意义，稳定 pkgdown (版本 1.6.1)在稳定版 downlit 上运行得很好.当然，任何包的开发版本都可能随时崩溃，但直到它没有为止，这都没关系。