roxygen2 包是否支持表格？答案

【问题标题】：Does the roxygen2 package support tables?roxygen2 包是否支持表格？
【发布时间】：2017-03-25 13:48:55
【问题描述】：

我想尝试在 .Rd 文件中使用降价。我想我在一个函数的文档末尾得到了@md，它可以解析降价。但是看不到这个表出现，也没有出现原始文本... roxygen 支持表吗？

#' makes bar
#' @description
#' prints 2 x
#' @details see this table
#' 
#' |a |b |c |
#' |--|--|--|
#' |1 |3 |4 |
#'
#' @param x how much foo
#' @return - 
#' @export
#' @family tmp
#' @examples
#' foo(2)
#' @md
foo <- function(x) {
    print(2 * x)
}

【问题讨论】：

它使用 commonmark，我在他们的规范中看不到任何关于表格的信息：spec.commonmark.org/0.27

标签： r markdown roxygen2

【解决方案1】：

现在支持roxygen2 since the 7.0.0 version 中的降价表（自 2019 年 11 月 12 日起在 CRAN 上）：

Markdown 表格被转换为 \tabular{} 宏 (#290)。氧气2 支持 GFM 表语法看起来像这样：
| foo | bar | 
| --- | --- | 
| baz | bim | 

您可以在dedicated roxygen2 vignette 中阅读更多相关信息。

【讨论】：

谢谢！但是，不要忘记先turn on markdown support！ ;-)

【解决方案2】：

由于最终添加了此功能，因此此答案似乎已过时。出于历史目的保留答案。

# 旧答案如下

roxygen2 包的文档说它使用 commonmark 作为它的降价，并且截至目前，commonmark specs 中的表没有任何内容。最重要的是，我们可以检查与 roxygen2 包 here 和 here 的降价相关的代码，我们没有发现任何对降价表的支持。

因此，至少在撰写此答案时，您的问题的答案似乎对降价表是“否”。

话虽如此，您可以将表格放入文档中，但您必须使用 LaTeX 语法“手动”完成：https://cran.r-project.org/doc/manuals/R-exts.html#Lists-and-tables

【讨论】：