Ruby 有一些不错的文档生成器,例如 Yard、rDoc,甚至 Glyph。问题是 Sphinx 可以做网站、PDF、epub、LaTex 等。它在重组文本中完成所有这些事情。
在 Ruby 世界中有替代方案吗?也许是程序的组合?如果我也能使用 Markdown 就更好了。
最佳答案
自 1.0 版以来,Sphinx 有了“域”的概念,它是从 Python 和/或 C 以外的语言标记代码实体(如方法调用、对象、函数等)的方法。
有一个ruby domain , 所以你可以只使用 Sphinx 本身。您唯一会缺少的(我认为)是 Sphinx 使用 autodoc 从源代码自动创建文档的能力。扩展,专门用于 Python 代码。
关于Ruby 等同于 Sphinx 文档生成器?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/9372188/