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