简体   繁体   English

R CMD Check 未完成“检查 PDF 版本的手册...”步骤

[英]R CMD Check does not finish the step "Checking PDF version of manual ..."

I am creating an R package using R Studio version 0.99.489 together with the most current R development version on Windows 7. I created documentation .Rd files using roxygen2 and a .Rmd vignette using knitr.我正在使用 R Studio 版本 0.99.489 以及 Windows 7 上最新的 R 开发版本创建一个 R 包。我使用 roxygen2 创建了文档 .Rd 文件,并使用 knitr 创建了一个 .Rmd 小插图。 Until now everything worked out fine, but when I run the R CMD check within RStudio, the check gets stuck at the step "Checking PDF version of manual ...".到目前为止一切正常,但是当我在 RStudio 中运行 R CMD 检查时,检查卡在“检查手册的 PDF 版本 ...”步骤。 I neither get an "OK" nor any error or warnings message.我既没有收到“OK”,也没有收到任何错误或警告消息。 The step just does not proceed, even if I run it over night.即使我整夜运行,该步骤也不会继续进行。 I do not get any error or warning messages for the other steps as well, I have "OK"s everywhere.我也没有收到其他步骤的任何错误或警告消息,我到处都有“OK”。

Consequently, I do not find a PDF manual in the package.Rcheck folder.因此,我在 package.Rcheck 文件夹中找不到 PDF 手册。 I already created the manual myself using R CMD Rd2pdf package, which worked out fine.我已经使用 R CMD Rd2pdf 包自己创建了手册,效果很好。 I copied it to several locations within the package folder but this did not help at all.我将它复制到包文件夹中的几个位置,但这根本没有帮助。

I searched really a lot but I could not find any solution for this since I do not get any error message.我搜索了很多,但我找不到任何解决方案,因为我没有收到任何错误消息。 I thought about administration, latex, or R version problems, but I cannot figure out if it is any of those or something else.我想到了管理、乳胶或 R 版本问题,但我不知道是这些问题还是其他问题。

One thing I recognized is that when the package is build, it prints out:我认识到的一件事是,在构建包时,它会打印出来:

CMD build "..PATH...\package" --no-resave-data \ --no-manual CMD build "..PATH...\package" --no-resave-data \ --no-manual

although I did not specify the --no-manual option in the Build options from RStudio.尽管我没有在 RStudio 的构建选项中指定--no-manual选项。 Additionally, I did not find a way to change this.此外,我没有找到改变这一点的方法。 Might this be the problem?这可能是问题吗?

Can anyone help me with this?谁能帮我这个? I would really appreciate any hints.我真的很感激任何提示。 Please let me know if you need any output or any other information from me.如果您需要我的任何输出或任何其他信息,请告诉我。

Thanks!谢谢!

You could do it yourself using:您可以自己使用:

shell('R CMD Rd2pdf . --output=man/figures/manual.pdf --force --no-preview')

This will create the PDF and save it to yourpackage/man/figures/manual.pdf.这将创建 PDF 并将其保存到 yourpackage/man/figures/manual.pdf。

I use it, so I know it works before I send it to CRAN.我使用它,所以在我将它发送到 CRAN 之前我知道它可以工作。

I faced the same problem.我遇到了同样的问题。 It was really frustrating that it didn't give any error message.它没有给出任何错误信息真的很令人沮丧。 But then I tried this:但后来我尝试了这个:

install.packages("devtools")

Actually I don't really know how it works, but I guess it also install other requirements and now the checking process is done via devtools and not directly by roxygen2 .实际上我真的不知道它是如何工作的,但我猜它还安装了其他要求,现在检查过程是通过devtools而不是直接由roxygen2的。 Hope it helps.希望能帮助到你。

I also come across with this problem, which I think it's a bug of RStudio .我也遇到了这个问题,我认为这是RStudio的一个错误。 Try R CMD check <YOUR PROJECT NAME> in terminal, in my case, it finally generates an error,在终端中尝试R CMD check <YOUR PROJECT NAME> ,在我的情况下,它最终会产生错误,

* checking PDF version of manual without hyperrefs or index ... ERROR
Re-running with no redirection of stdout/stderr.

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM