r - 在 R 包文档 (.Rd) 文件中包含图像

Question

我正在努力记录我的一个包中的可视化功能。为此，我希望通过 Rd 文件 'funcname.Rd' 嵌入一个图像，该图像可以解释函数中使用的各种参数，如果用户阅读包手册 PDF 或写入 '?funcname ' 在 R. 中的一些东西:



'Writing R extensions'-document 似乎没有解决这个问题，我能找到的唯一引用是 this blog post和 this R-devel discussion .前者与名为“base64”的包的链接已断开，而后者只解决了各种替代方案，例如将图像包含在 R 包小插图中。如果这可以与 CRAN 兼容，那就太好了。

任何有关如何解决此问题的建议将不胜感激，谢谢!

Answer 1

未经测试，但查看 GitHub 上的 R 源代码，他们似乎将图像添加到 ?par documentation file以下列方式:

 \item{\code{mai}}{A numerical vector of the form \code{c(bottom,
        left, top, right)} which gives the margin size specified in
      inches.\cr
      \if{html}{\figure{mai.png}{options: width="35\%" alt="Figure: mai.png"}}
      \if{latex}{\figure{mai.pdf}{options: width=7cm}}
    }

该图似乎保存在 /man/figures 中.

更多详情请查看 Writing R Extensions section关于这个话题。