为 R 包生成可打印文档的标准选项是什么?

What are the standard options for generating printable documentation for an R package?

当我查看 R 包的文档时,它通常以这样的 PDF 文档出现:

https://cran.r-project.org/web/packages/glmnet/glmnet.pdf

那个文件有名字吗?

通常我通过在网络上搜索找到这些文档,但我想知道我是否也可以使用一些 R 命令生成它们,例如 library(help=...)vignette(...)。但是,this answer 听起来有点复杂,就像我必须自己编译包和 运行 R CMD Rd2pdf,这样对吗?

此外,作为一个潜在的软件包作者,我可以想象将此 PDF 文档用作我的软件包的主要文档。唯一的障碍是,当我阅读这些文档时,文档中的函数似乎总是按字母顺序出现。有没有办法把最重要的功能放在前面,这样就可以直接阅读文档(而不是仅仅作为参考)?或者是否有另一种文档格式可以让我按特定顺序记录内容?

参考手册只是帮助页面的集合。它们应该写成参考 material,这可能不是用户应该首先查找文档的地方,如果那是你所说的 "primary documentation".

用户首先应该寻找的是提供包概览的小插图。它可以显示为 HTML 或 PDF(由包作者选择)。由于它是 free-form,您可以按逻辑顺序记录内容,而不受限于参考手册的字母顺序。

它也是可选的,我用它来衡量我正在调查的包的质量:如果他们没有这样的小插图,作者就不会真正关心提供好的文档。