ruby - 生成 RDoc 到 LaTeX

Question

是否可以生成 LaTeX 格式的 RDoc？我查看了 RDoc 和 YARD，但没有找到我需要的东西。

我正在用 LaTeX 为我的 Ruby 项目编写文档，我需要一种方法来轻松地将 API 引用作为附录或章节嵌入最终的 PDF 中。对我来说，最方便的方法是从 Ruby 源文件生成 LaTeX 源代码，并在适当的地方包含它。

Answer 1

我没有这方面的经验，但简短的谷歌搜索显示:

• https://github.com/Quintus/rdoc_pdf-latex (链接已损坏，见下文)
• http://www.ruby-doc.org/core-1.9/classes/RDoc/Markup/ToLaTeX.html (链接断开)

另一种可能性:你知道 LaTeX 中的 listings-package 吗？还有一个 ruby 支持。你不会得到 rdoc 命令，但也许你可以在你的代码中创建 LaTeX 命令？

---

Papyrus是 RDoc 的一个插件，使 RDoc 能够生成 PDF 文件。它基于 LaTeX。所以应该有一个中间的 TeX 文件。

来自readme.rdoc的 github repository for papyrus :

This library is a plugin for Ruby’s documentation generator RDoc. It provides both a generator for outputting PDF (Portable document format) (the RDoc::Generator::Papyrus class) files and a formatter for turning the parsed RDoc markup into LaTeX code (RDoc::Markup::ToLaTeX; RDoc::Markup::ToLaTeX_Crossref adds cross-reference facilities).