在Roxygen中记录时：如何在@details中创建逐项列表？

Question

将逐项列表添加到roxygen2的适当语法是什么，例如，在@details部分？我可以创建一个乳胶列表环境吗？

似乎忽略了换行符，即

#' @details text describing parameter inputs in more detail
#'
#' parameter 1: stuff
#' 
#' parameter 2: stuff

谢谢！

Answer 1

以下是您的问题表达后的roxygen2示例。

##'
##' @details text describing parameter inputs in more detail.
##' \itemize{
##'  \item{"parameter 1"}{Stuff}
##'  \item{"parameter 2"}{Stuff}
##' }
##'

这将允许您在详细信息部分中使用itemize。你也可以在@param部分使用它。

希望这有帮助。

Answer 2

自roxygen2 6.0.0起，您可以直接在R文档中使用markdown。

#' @details text describing parameter inputs in more detail.
#' * parameter 1 stuff
#' * parameter 2 stuff
#' @md

要使用此功能，请在说明中添加Roxygen: list(markdown = TRUE)以打开整个包的标记，或将@md标记添加到单个文件中。