问题标签 [vignette]

我正在向 CRAN 提交一个包。我在 Linux 上进行了 --as-cran 检查，除了 CRAN 传入可行性的一个注释之外，它运行得很干净。我相信此注释属于“新提交”消息，因为我看不到任何其他附加消息。状态正常。当我提交给 CRAN 时，我在 Windows 上收到与小插图构建相关的错误。检查：重新构建小插图输出，结果：警告在重新构建小插图时出现错误：--- 使用 rmarkdown 重新构建“vignette-testme.Rmd”

Windows 上错误的堆栈跟踪很难解释，因为故障发生在设置正常工作的地方。我准备了 .tar.gz 文件如下：

1. 从 git 存储库中，我使用 'git archive --format tar HEAD' 提取了最新版本
2. 我使用“R CMD build xyz”来构建包
3. 我对生成的存档执行了“R CMD check --as-cran xyz_version.tar.gz”
4. 我将此文件上传到 CRAN

我忘记了一个必要的步骤吗？该软件包是纯 R 代码。我已将违规文件上传到https://drive.google.com/open?id=1nbe-8Os2MhI-O75IYNT0ZKQMonfZsynx（请注意，代码来自互联网），以防您想查看。

我必须尝试使用​​ Rstudio 在 Windows 上手动安装。我在小插图构建期间也遇到错误，这次是在设置阶段：

file.create(to[okay]) 中的警告：

无法创建文件'\vf-home/home$/bs/MyDocs/R/win-library/3.6/00LOCK-testme/00new/testme/doc/vignette-testme.R'，原因'没有这样的文件或目录'

非常感谢您提前。

在几个包中，最近matlib在 github 上的包https://github.com/friendly/matlib我有一个 README.{md,Rmd} 文件，上面写着类似

现在有一小部分小插曲可供使用。用browseVignettes("matlib")来看他们。

我想在 README 中用小插图名称及其标题列表替换或添加此内容。

在 README 中，我最接近我想要的信息的结果> vignette(package= "matlib")如下所示：

但是我想在一个块中捕获这个结果，或者我可以直接在 README 中使用。如果我使用 构建包站点pkgdown，我会在 **Articles* 下获得指向小插图的链接，但我仍然没有可以直接使用的小插图名称和标题列表。

几个月前，我向 CRAN 提交了一个 R 包，目前可以作为一个包使用。我连同包裹一起提交了插图。现在我有我的小插图的更新版本，我需要用旧的小插图替换它。如何进行？

我签入了如何在一个小插图中的同一个 R 包中放置另一个小插图的链接

但这对我正在寻找的内容缺乏明确性。

请帮忙。谢谢。

PS。我有一个小插图的 PDF 文件

当我使用不带参数的 browseVignettes() 时，我应该获得所有已安装包的小插图列表，但是根本没有打开任何 html 文件。当我将特定包作为函数的参数传递时也是如此。请帮忙

我遇到了有线情况。添加新代码后代码无法编织出来。

这个问题是关于 GRATIS 包中的 generate_msts() 函数。

我添加了一些新内容（使该函数具有将其输出转换为可爱的 tsibble 格式或保留原始“列表”格式的选项）并准备对 CRAN 的更新。

新代码添加如下（代码的详细信息以及问题底部显示的示例）

我想知道我应该得到 tsibble 索引吗？但是生成的数据好像没有索引？

作为指导，我在Vignette中更新了此函数的相应示例。然后事情变得有线。

如果我没有保存生成的时间序列输出（例如 x <- my_function()），小插图 就无法编织出来。（不过我可以在独立的普通RMD文件中直接使用这个功能）

直接使用此代码可以在 RStudio 内部显示输出，但不能编织出来。

但是，这很好用。它可以编织出小插图并显示出小标题。

但是，这样非常不方便，每次使用前都要保存。我想知道这是否是因为我在包中使用的任何默认设置或小插图没有改变？还是在更改 R 包中的函数后需要做一些额外的步骤？或者甚至我添加的 if else 内容需要改进？

我试图devtools::document("C:/Users/mreal/Documents/GitHub/package_name");devtools::install("C:/Users/mreal/Documents/GitHub/package_name")更新重建功能。但这仍然无助于小插曲。

我也试过rm(list=ls())了console。它也不起作用

我在小插图中使用的代码如下

Github 链接：

https://github.com/BocongZhao823/gratis/blob/master/vignettes/QuickStart.Rmd

（生成的.R文件）包内使用的R代码如下

** Github 链接**

https://github.com/BocongZhao823/gratis/blob/master/R/generate_ts.R

我为具有以下标头的包创建了一个小插图：

但是，小插图格式不允许 html_document 允许的全部功能。

我想自动更改 YAML 标头，以便能够以完整的 html_document 格式编织小插图（使用类似的选项toc_float: true）

我正在尝试使用 读取.Rmd文件ReadLines并替换标题gsub，但我正在努力使用转义字符/正则表达式：

感谢您的建议，欢迎使用转义字符修改文件头的替代方法。

我正在不同的 repo 路径中的 2 台不同的计算机上开发一个包。当我调用devtools::document()andpkgdown::build_site()时，我注意到整个小插图都被重新渲染了。问题在于，根据机器的不同，重新渲染会导致错误，因为函数调用的 2 台机器中的路径不同。有没有办法让小插图“静态”，这样它们就不会重新渲染，这样当我拉上另一台机器并开始处理包时，它将继承小插图而不是重建它？

在我的计算机上运行devtools::check()，​​我可以使用 .bib 文件的绝对路径强制我的包构建而不会出错。但是由于我在包小插图中包含了我的所有引用并试图指向包含所有 bibtex 引用的 .bib 文件，所以我还没有使用 GitHub Actions 构建包（绝对路径没有意义）。我正在寻求有关如何指向小插图 YAML 标头中的 .bib 文件的建议。

目录中 .bib 文件的位置inst/允许我使用包的 .Rd 文档中的引用（如此处建议：https ://geobosh.github.io/Rdpack/#org88fb0a7 ），所以我最感兴趣在让我引用该位置中的文件而不是将其保存在备用目录中的解决方案中。

我的 YAML 标头内容如下：

我也试过

如何在 YAML 标头中使用相对路径，以便可以从任何位置构建小插图？

我在为我的 R 包编写的小插图中发现了一个错误。要重新上传小插图，我是否需要将整个包重新提交给 CRAN？我从 CRAN 方面考虑这一点，我不想让某人在我的整个包只是一个正在更改的 pdf 文件时审查我的整个包。或者，对于 CRAN 的评论者来说，这可能不是那么糟糕？