为什么我的小插图是 html 而不是 pdf？答案

【问题标题】：Why is my vignette html and not pdf?为什么我的小插图是 html 而不是 pdf？
【发布时间】：2018-05-17 16:24:22
【问题描述】：

我很困惑为什么我的 R 包的小插图是 HTML on CRAN 而不是 pdf。

我听从了Enforce PDF package vignette with knitr 的建议并使用了

%\VignetteEngine{knitr::rmarkdown}

生成小插图，但它是一个 pdf。其中一个文件的完整标题是

---
title: "wCorr Formulas"
author: "Paul Bailey, Ahmad Emad, Ting Zhang, Qingshu Xie"
date: '`r Sys.Date()`'
output:
  pdf_document: default
vignette: |
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteIndexEntry{wCorr Formulas}
  \usepackage[utf8]{inputenc}
  \usepackage{amssymb}
---

您可以在 https://github.com/cran/wCorr 或在构建之前在 https://github.com/ahmademad/wCorr 看到整个包

【问题讨论】：

标签： r r-markdown knitr

【解决方案1】：

您将在inst/doc 中包含 HTML 输出的副本（可能来自早期版本）。

这可能不是故意的；我相信devtools::build_vignettes 可能会解决 R 中的一个错误：https://bugs.r-project.org/bugzilla3/show_bug.cgi?id=17416。但是有更好的解决方法，例如此处描述：https://github.com/yihui/knitr/issues/1540。

【讨论】：

那些是在构建包时添加的，它们在构建包时不存在。在构建之前，我在 OP 中添加了一个指向包的链接。
尽管如此，你还是把它们放在那里。使用标准构建工具（即 R CMD 构建），除非您要求，否则您不会得到它们。
我在命令行使用“R CMD build”。在你在这里提到之前，我从来没有使用过“devtools::build_vignettes”。
CRAN 上的版本是 1.9.1； Github 上的版本是 1.9.0。当我在 Github 上构建一个时，我没有得到 HTML 文件，但 CRAN 有它们。您应该检查您发送给 CRAN 的 tarball，其中包含 1.9.1：我怀疑（无论出于何种原因）它包含 HTML 文件。
是的，我怀疑是一样的。我现在认为是我没有正确设置环境来构建 pdf 文件，所以 R CMD build 没有构建它们。然后，CRAN 发布了我发送的内容——这是有道理的。