是否有允许包含图表和图像的 Ruby 文档工具？答案

【问题标题】：Is there a Ruby documentation tool that allows inclusion of diagrams and images?是否有允许包含图表和图像的 Ruby 文档工具？
【发布时间】：2009-07-16 08:40:44
【问题描述】：

我是doxygen 的忠实粉丝，多年来我一直使用各种语言。特别是，我很欣赏它类似于 wiki 的能力，include images 并运行 Graphviz 点生成器以从 inline DOT code 或 external files 获得任意内联图。

RDoc 支持使用 Graphviz 生成类图，但我看不到任何包含任意图像或图表的方法。它似乎也不支持像氧气一样建立任意页面。

是否有任何工具可以为 Ruby 提供这些 Doxygen 风格的功能？

我浏览了 Ruby Toolbox list of tools，它们似乎都是 RDoc 的变体。

目前对我来说最可能的解决方案似乎是extending Yard。

【问题讨论】：

标签： ruby doxygen documentation-generation rdoc yard

【解决方案1】：

RDoc 会自动将 url 转换为 html 链接，指向图像文件的 url 会自动转换为 html 图像。

【讨论】：

【解决方案2】：

正如我上周在 Perth Agile Meetup 上被告知的那样，graphviz 集成是 now available 作为 yard 的一个分支。

【讨论】：