软件包开发: pdf手册和vignette的位置

Question

在构建修补程序时，一切似乎都正常：

library(devtools)
build(vignettes = T, manual = T)

* checking for file ‘/storage/Documents/client/validate/mypackage/DESCRIPTION’ ... OK
* preparing ‘mypackage’:
* checking DESCRIPTION meta-information ... OK
* installing the package to build vignettes
* creating vignettes ... OK
* checking for LF line-endings in source and make files
* checking for empty or unneeded directories
* building ‘mypackage_0.1.tar.gz’

[1] "/storage/Documents/client/validate/mypackage_0.1.tar.gz"

然而，我既找不到PDF手册，也找不到小插曲。

Vignette:遵循这里描述的工作流，使用RStudio / devtools / markdown。然而：

vignette("mypackage")警告信息:找不到vignette‘mypackage’

对于PDF手册，我尝试过这，但没有成功。

所以，我的问题是:我在哪里可以找到PDF手册和维涅特？

Answer 1

我可以通过以下方式找到我的PACKAGE-manual.pdf，整个PACKAGE都是我的包名

C:\Users\USERNAME\AppData\Local\Temp\

在Windows文件夹目录中。您可能必须启用隐藏的文件夹和文件才能看到这一点。在这个文件夹中有许多临时文件夹和其他类似的东西。按日期排序，向下滚动到文件夹所在的位置。最近的一个是你可能想要的；以"Rtmp"作为前缀的是R.

在(可能)最近的Rtemp[blah]中，应该有一个名为PACKAGE.Rcheck的文件夹。在这个PACKAGE.Rcheck文件夹中应该是手动pdf PACKAGE-manual.pdf，假设它是成功创建的。

我的计算机上的完整路径字符串(对于这个包创建运行)是

C:\Users\USERNAME\AppData\Local\Temp\RtmpG0713j\PACKAGE.Rcheck\PACKAGE-manual.pdf。

在得到正确的文件夹之前，您可能需要搜索几个Rtmp[blah]文件夹。

Answer 2

不太清楚RStudio把它放在哪里，但是在基本的检查操作中，如果您创建了mypackage-package.R文件，手册的pdf版本应该位于一个名为mypackage.Rcheck的文件夹中，那么在安装包时，?mypackage应该会引导您找到手册的html版本。你可以通过安装你的软件包和做vignette("mypackage")来获得这个效果。

Answer 3

我不知道手册的内容，但是如果您使用“build and reload”按钮从rstudio构建(在“检查按钮”附近)，如果构建正确，将在您的r库文件夹的“yourpackage”子文件夹中结束，我认为在inst/doc子文件夹中。另外，对于小片段，你试过使用devtools::build_vignettes构建它们吗？通常对我有用。