使用 devtools 构建 .md 小插图

Build .md vignette using devtools

我正在使用 knitr::rmarkdown(但 knitr::knitr 与我的 VignetteEngine 一样)。然后我使用 devtools::build_vignettes().

构建我的包小插图

这有效,但只在 inst/doc 中创建 HTML 和 R 输出文件。我想要的是一个Markdown输出文件,因为只有它可以直接显示在Github项目页面中(对于HTML文件,Github显示源代码和 Rmd 文件显示渲染输出,但显然没有执行 R 块)。

我已经尝试找出如何为自定义 VignetteEngine 指定输出,我认为这应该是可能的(毕竟,其他软件包至少使用它来构建 PDF 插图)但是我找不到通过 devtools::build_vignettes 执行此操作的方法。是否没有办法手动构建小插图(即通过 knitr::knit 或忽略 VignetteBuilder 指令的类似机制)?

我在documentation/source里面也找不到相关资料

晕影的唯一输出格式是 HTML 和 PDF(和 LaTeX,但已转换为 PDF,未显示)。不支持 Markdown。

您的包中可以包含任意文档文件(按照惯例,您将它们放在 inst/doc 中),但它们不被视为小插图,因此不会自动构建,功能如 browseVignettes() 将忽略它们,等等

要将 Rmd 文件转换为 md,只需 运行 knitr::knit 就可以了。