问题标签 [vignette]

在开发 R 包时，我在 /data 文件夹中有一个外部数据集。我称之为data_m。devtools::check()现在显示数据集的错误。

然而，当我使用 Knit 运行小插图时，我看不到任何函数的结果，例如colnames(data_m)我编写的函数。

例如

```r colnames(data_m) ```

只给我代码colnames(data_m)而不是数据集的列名。

还，

```{r} colnames(data_m) ```

生成错误 Error in this data.frame(x): objectdata_mnot found Calls: <Anonymous> ...withVisible -> eval -> eval -> colnames -> is.data.frame Execution halted

当我跑步时

devtools::check()

我也显示

frequencyrank: no visible binding for global variable ‘data_m’

我认为数据集和小插图之间存在脱节。但我不确定它是什么。

谁能让我知道问题到底是什么？非常感谢。

我在 RMarkdown 中为需要 API 密钥的包创建了一个小插图。我将密钥作为环境变量包含在内，然后将此密钥用作参数；但是当我检查包构建时，我收到一个警告，因为它无法读取我的环境变量。

如果我将密钥直接传递到函数中，我不会收到警告。

这是警告：

我的代码看起来

我正在创建一个带有小插图的 R 包。但是，当我尝试使用

由于在 doc 文件夹中找不到文件 index.html，因此发生错误。我以为这个文件会自动创建，但显然这里出了点问题。发生的错误如下：

我的小插图 .Rmd 看起来像这样：

我以前从未构建过 R 包，但在互联网上搜索了几天的解决方案，但找不到任何解决方案。这似乎是同一个问题，但我在那里找不到问题的解决方案。你可以在这里找到我的包裹。

真的希望有人能帮助我！

问题

我为我的公司创建了一个小型内部包。为了描述热使用它，我写了一个小插曲。但由于某种原因，当我在 RStudio 中点击安装并重新启动时，没有构建小插图。

更多信息

• 我使用 roxygen 作为包文档

• 有趣的是，Install and Restart的输出表明它已安装：

  /li>

• devtools::build_vignettes()NULL即使行返回

  包含在说明中。

• 小插图的 YAML 标头如下所示：

  /li>

• 我还尝试强制构建小插图，devtools::build(vignettes = TRUE)但没有任何改变。

编辑（更改 YAML 标头）：

当我在小插图的 YAML 标头中更改%\VignetteEngine{rmarkdown::render}为时%\VignetteEngine{knitr::rmarkdown}，devtools::build_vignettes()工作并将构建的小插图放置在/inst/doc/.

但是，当我在 RStudio 中检查包时，在此位置检查失败：

create_var_details和都是create_var_overview导出函数。这里有一个例子：

使用旧标题，检查很好。

我刚刚创建了一个“玩具”R 包。该软件包包括vignettes带有两个文档的文件夹：

• vignette.Rmd：使用用于生成小插图的代码
• vignette.html：这是knitr在R studio中按下按钮后的结果。

正确安装软件包后（我可以访问所有功能），当我运行时，browseVignettes("name_of_package")我收到以下消息：

我读了一些类似knitr .Rmd vignettes 的帖子没有出现在 vignette() 中，但我没有解决问题。任何想法将不胜感激。

我用 rStudio 创建了一个包，而不是用 devtools。现在我想创建一个小插图并将其链接到包，以便我可以在库中搜索包，并且应该在描述文件下找到小插图的链接。我在与包相同的项目中创建了一个 rmarkdown 文档。我有以下设置，但我没有得到小插图包中的链接。我应该包括哪个设置来制作小插图？

我在尝试创建晕影效果时尝试使用 SVG 滤镜。

我在一个旧的 repo 中找到了一个片段，作者这样做是这样的，但feFlood没有为我选择过滤器。我也试过flood-color="url(#gradient_toaster)"，但没有区别。W3 文档说这个属性有颜色，比作者可能错了吗？如果是，实现晕影效果的方法是什么？

这是一个与未回答的问题类似的问题。

knitr/markdown：如何在 CRAN 构建的小插图中渲染数学方程？

我正在开发一个供公司内部使用的软件包（不会提交给 CRAN）。

我写了多个小插曲，其中包括一些 MathJAX 代码和 r 代码。

这是他们的 YAML：

我使用 devtools::document() 和带有“Build Binary Package”的包构建小插图。

我删除了该软件包的任何先前版本并通过 zip 文件再次安装。一切都相应地工作。

当我尝试 vignette("package") 时，它会给出小插图，但将 mathjax 渲染为字符串而不是实际的数学表达式：

如果我在开发它们时实际上通过网络浏览器或 CTRL + Shift + K 打开了 html 文件 MathJax 会正确呈现，但当您通过 vignette(...) 访问它们时不在帮助窗口中

有什么帮助吗？

我想在我的 R 包中包含静态小插曲，它将显示给使用 R 函数的用户browseVignettes()。

我需要小插图是静态的，因为小插图的构建时间太长，如果动态包含它们，我会导致我无法对 win-builder 进行 CRAN 检查。

该软件包R.rsp似乎提供了我想要的东西；此处描述：https ://cran.r-project.org/web/packages/R.rsp/vignettes/R_packages-Static_PDF_and_HTML_vignettes.pdf 。

我按照R.rsp. 按照指示，我有一个vignettes文件夹，其中包含一个 .html 文件以及一个相应的 .Rmd 文件和一个 .html.asis 文件。我在说明文件中也有相应的代码。使用这些设置，我通过了 win-builder、travis 等的 CRAN 测试。但是，当我从 github 下载包时，它说没有与包关联的小插曲。我是否遗漏了有关 R.rsp 包的内容？这种能力过时了吗？我是否需要将构建的小插图从 Vignettes 文件夹复制到 inst/doc 文件夹中？（我看到有关 vignettes 文件夹与 inst/doc 文件夹的冲突信息）。

使用 R.rsp::asis 之类的东西是包含需要很长时间才能动态包含的小插曲的最佳方式吗？我见过的另一种方法是在 .Rbuildignore 中包含 vignettes 文件夹，然后在 README 文件中包含一条注释，告诉用户他们可以从 github 单独构建 vignettes 以便查看它们。我也在考虑在自述文件中包含指向外部小插图的链接。这是更好的方法吗？CRAN 可能更喜欢哪个？

我一直在做一个包。起初，我会定期构建小插图，并且 vignette() 函数将能够找到它们。但是后来有些东西坏了，我不知道它是什么，即使使用默认代码，vignette() 也不起作用。

我创建了一个全新的包'tabtest'，它会自动创建一个函数'hello'，我这样做：

创建小插图文件，我没有更改任何内容并保存。

然后，我使用 Ctrl-Shift-B 构建，然后执行

并得到错误'主题 [1L] 中的错误：'closure' 类型的对象不是子集'，这与我在实际包中遇到的错误相同。

值得注意的是，如果我这样做

它运行没有问题，并在 doc/ 文件夹中创建准确的小插图文件，但小插图（）找不到它们。另外，如果我将代码上传到 github 并使用 install_github，那么它也找不到小插图。

我一定在某个地方按下了一些奇怪的开关。我究竟做错了什么？谢谢！