Roxygenで文書化する場合：@detailsに項目別リストを作成するにはどうすればよいですか？

Question

たとえば、@ detailsセクションで、項目別リストをroxygen2に追加するための適切な構文は何ですか？ラテックスリスト環境を作成できますか？

改行は単に無視されているようです。

#' @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_タグを単一のファイルに追加します。