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

Question

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

---
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

在您的标题中，您告诉 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选项