如何在 R 和 RStudio 中构建 pdf 插图

Question

我是编写 R 包的新手。我正在尝试学习如何为我的包裹制作小插图。我创建了一个带有文件 "getting-started.Rmd"

的 vignettes 文件夹

---
title: "WaterML Tutorial"
author: "Jiri Kadlec"
date: "`r Sys.Date()`"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{Introduction to the WaterML R package}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

## Quick Start

This simple example shows how to get started with the <my R package>.

要构建小插图，我使用以下命令：

devtools::build_vignettes()

然后我运行 Rcmd.exe INSTALL my_package，为了查看我的插图我运行：

browseVignettes("my_package")

但是我只看到 html 和源格式的插图：

如您在屏幕截图中所见，没有 "pdf" 选项。如何配置我的 .Rmd 文件以创建 pdf 格式的插图？

Answer 1

在你的 header 中，你告诉 R 只输出一个 html 小插图行：

output: rmarkdown::html_vignette

如果你想要pdf，试试：

output: pdf_document

根据R packages：

Output: this tells rmarkdown which output formatter to use. There are many options that are useful for regular reports (including html, pdf, slideshows, …) but rmarkdown::html_vignette has been specifically designed to work well inside packages. See ?rmarkdown::html_vignette for more details.

所以您在使用原始 pdf 时可能会遇到一些小问题。

目前rmarkdown没有output: rmarkdown::pdf_vignette选项

如何在 R 和 RStudio 中构建 pdf 插图

How to build a pdf vignette in R and RStudio

pdf

vignette

r

knitr

r-markdown