我正在开发一个最新的Windows10版本,RStudio 1.3.959,我刚刚安装了最新的MikTex。
我试着用RStudio把一个R包放在一起。我可以构建包,函数文档注释正在转换为/man/*..Rd文件。然后,当在?function_name控制台窗口中执行RStudio时,就会成功地显示这些内容。
不幸的是,我在构建package文档时运气很差(不要把它误认为是小插曲;我可以构建它)。我看过了一些教程,但它们都没有说明如何构建每个R包所期望的最终PDF文档。
我试过了:BuildWindows->More->Document ..。执行devtools::document(roclets = c('rd', 'collate', 'namespace', 'vignette'))的
BuildWindows->多->构建源代码包.它执行devtools::document(roclets = c('rd', 'collate', 'namespace', 'vignette')),然后执行devtools::build(binary = TRUE, args = c('--preclean'))
BuildWindows->多->构建二进制包.它执行devtools::document(roclets = c('rd', 'collate', 'namespace', 'vignette')),然后执行devtools::build(binary = TRUE, args = c('--preclean'))
这三个功能如预期,但仍然没有最终包手册pdf文件。
在对Stack进行一些调查时,我注意到有人使用了命令:
devtools::build_manual()我确信这就是我所需要的。但是,当我执行这一行代码时,会得到以下错误:
Converting Rd files to LaTeX ...
Warning in sys2(makeindex, shQuote(idxfile)) : '"makeindex"' not found
Error in texi2dvi(file = file, pdf = TRUE, clean = clean, quiet = quiet, :
unable to run 'makeindex' on 'Rd2.idx'
Warning in sys2(makeindex, shQuote(idxfile)) : '"makeindex"' not found
Error in texi2dvi(file = file, pdf = TRUE, clean = clean, quiet = quiet, :
unable to run 'makeindex' on 'Rd2.idx'
Error in running tools::texi2pdf()
Error: Failed to build manual这让我一点也不明智,尽管很明显,由于缺乏makeindex,有些东西有点不舒服。帮助是非常感谢的。
发布于 2020-10-22 16:16:19
如果我没听错,你指的是标准参考手册。例如,ggplot2参考手册。在我的经验中,当你提交的时候,这是由CRAN组合在一起的。所有手册都是(据我所知)一个文档完整的包应该拥有的东西的集合,例如描述文件、名称空间文件和实际文档的各种.RD文件。
即使在查看公共用于ggplot2的github时,我们也会发现它们的存储库中没有手册。此外,他们的.git*ignore文件中没有任何证据表明他们自己制作了手册。
但是,如果您想自己做这个,那么devtools::build_manual()是正确的函数调用。
我在github上用一个预先存在的软件包制作了手册。我建议尝试重新安装您的devtools包,并确保没有警告或错误。作为管理员运行会话可能会有帮助,以确保正确安装。
祝好运!
我在MacOS High上使用RV3.4和MacOS 1.1.453。
https://stackoverflow.com/questions/64483388
复制相似问题