是否可以生成 LaTeX 格式的 RDoc?我查看了 RDoc 和 YARD,但没有找到我需要的东西。
我正在用 LaTeX 为我的 Ruby 项目编写文档,我需要一种方法来轻松地将 API 参考作为附录或章节嵌入到最终的 PDF 中。对我来说,最方便的是从 Ruby 源文件生成 LaTeX 源并在适当的地方包含它。
我没有这方面的经验,但一个简短的谷歌搜索显示:
另一种可能性:你知道 LaTeX 中的列表包吗?还有一个红宝石支持。你不会得到 rdoc-commands,但也许你可以在你的代码中使用 LaTeX-commands?
Papyrus是 RDoc 的一个插件,它使 RDoc 能够生成 PDF 文件。它基于 LaTeX。所以应该有一个中间的 TeX 文件。
来自papyrus的github 存储库的readme.rdoc:
这个库是 Ruby 文档生成器 RDoc 的插件。它提供了用于输出 PDF(便携式文档格式)(RDoc::Generator::Papyrus 类)文件的生成器和用于将已解析的 RDoc 标记转换为 LaTeX 代码的格式化程序(RDoc::Markup::ToLaTeX;RDoc::Markup ::ToLaTeX_Crossref 添加交叉引用工具)。