我正在准备一个提交给 CRAN 的包。
我使用 R CMD build myPackage 然后 R CMD check myPackage --as-cran 并且它通过了所有检查,没有任何注释或警告。
但是,每次尝试提交时,我都会从其中一位 CRAN 维护人员那里收到以下错误消息:



首先,我希望能够在我自己的系统 ( R version 3.0.1 ) 上重现上述错误消息。

小插图 .Rnw 文件如下所示:

%\VignetteEngine{knitr::knitr}
%\VignetteIndexEntry{myVignetteName}
\documentclass{article}
\begin{document}
Here is some code:
<<>>=
plot(1:10, 10:100)
@
\end{document}

我尝试在根目录中添加一个 INDEX 文件,其中包含一个像这样的小插图条目:
myFunction       a brief description
abc-vignette     vignette description

同样,这通过了 R CMD check myPackage --as-cran 但我收到了相同的错误消息。

我也试过 R CMD build myPackage --md5 强制创建一个 MD5 文件,但无济于事。

当我查看 myPackage.Rcheck/00_pkg_src/myPackage/inst/doc 时,我发现小插图文件 .Rnw.pdf 符合预期。

DESCRIPTION 文件具有以下条目:
VignetteBuilder: knitr
Suggests: knitr

当我查看 myPackage.Rcheck/myPackage/Meta 时,我看到一个条目 vignette.rds 。然而,这似乎是一个二进制文件,所以我无法理解。

这是来自“编写 R 扩展”:



那么我是否需要手动创建 index.html 并且有人可以指出它应该是什么样子的示例吗?

This question 似乎密切相关,但我(有意)没有 .Rbuildignore 文件。 This is also related ,虽然我没有使用 devtools 来创建包。我还查看了 this question,但没有看到简单的答案。

7 月 1 日更新

对于可重现的示例,该包可用 here on github 。下载和安装(例如使用 devtools::install_github() 应该允许重现此错误。

最佳答案

我收集 Vignette 命令需要在 前导码 中,即低于 documentclass ,这样文件 1x24313 应为 130

\documentclass{article}

% \VignetteIndexEntry{myVignette}
% \VignetteEngine{knitr::knitr}

\usepackage[]{graphicx}
...

这似乎工作正常。

错误消息来自 开发 版本 myVignette.Rnw 目前是 R CMD check 。我一直在使用较旧的“稳定”版本,这不是在考虑提交给 CRAN 时检查包的推荐方法。

我仍然不确定使用手动 3.3.0 文件的优点 - 这似乎没有必要,但如果有人能对此有所了解,我很乐意更改已接受的答案。

关于r - 我如何 'prebuild' R 包的小插图索引?,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/30976308/

10-16 11:59