ruby-graphviz 家族树构建指南FamilyTree 类生成精美关系图的完整教程【免费下载链接】Ruby-Graphviz[MIRROR] Ruby interface to the GraphViz graphing tool项目地址: https://gitcode.com/gh_mirrors/ru/Ruby-Graphvizruby-graphviz是 Ruby 语言对接 GraphViz 图形引擎的官方接口库其中内置的GraphViz::FamilyTree家族树类让你用几行 Ruby 代码就能绘制出生动的家族关系图family tree。本指南面向 Ruby 新手手把手教你从安装到生成精美家族树图片的完整流程全程只需掌握一套简单的 DSL 语法 为什么选择 ruby-graphviz 绘制家族树 手动用 GraphViz 的 DOT 语言画家谱往往要写大量节点和边定义。而 ruby-graphviz 的FamilyTree家族树类把这些细节全部封装好了声明式 DSL直接写abraham.is_a_man(Abraham)这样贴近自然语言的代码自动排版底层调用 neato 布局引擎按代际自动分配位置语义化标记婚姻、离婚、丧偶、过世都有专用方法图形自动换色零配置gem install后即可运行无需手写任何 DOT 文件一分钟安装 ruby-graphviz在 Gemfile 中加入依赖gem ruby-graphviz执行bundle install安装或者手动运行gem install ruby-graphviz。安装完成后确保系统已装有 GraphViz 图形引擎即可。快速上手用 3 行代码创建家族树实例创建家族树的核心就是一条语句——GraphViz::FamilyTree.new配合一个 DSL 块入口源码位于lib/graphviz/family_tree.rbrequire graphviz/family_tree tree GraphViz::FamilyTree.new do # 在这里声明每一代人和关系 end块内的代码由类自动instance_eval执行因此你可以直接说出家族故事而不必关心图形对象本身。家族树核心概念generation、Person 与 Couple理解 3 个模块类就能玩转整套 DSL源码位于lib/graphviz/family_tree/目录模块文件路径职责Generationgeneration.rb划分代际每一段generation do ... end就是一代Personperson.rb每个人负责性别标记与关系声明Couplecouple.rb夫妻/伴侣单元用kids声明子女小技巧在 DSL 块中写bart.is_a_boy(Bart)时bart这个名字无需提前声明Generation类通过动态方法查找自动创建 Person 对象——变量名即人物 ID非常优雅。实战绘制完整的家族树示例下面是一个完整的家族树构建示例参考 sample33.rb涵盖两代人、多组婚姻和子女声明tree GraphViz::FamilyTree.new do generation do abraham.is_a_man(Abraham) mona.is_a_woman(Mona) abraham.is_maried_with mona end generation do herb.is_a_man(Herb) homer.is_a_man(Homer) marge.is_a_woman(Marge) homer.is_maried_with marge end couple(abraham, mona).kids(herb, homer) couple(homer, marge).kids(bart, lisa, maggie) end tree.graph.save(:png family.png)运行后会看到控制台打印世代统计信息并在当前目录生成family.png家族树图片。进阶用法婚姻、离婚、丧偶与过世标记Person类提供了一组语义化关系方法图形会自动使用不同颜色区分is_maried_with黑色连接线表示结婚is_divorced_with红色连接线表示离婚见 sample99.rbis_widower_of绿色连接线表示丧偶is_dead节点填充样式表示已故此外还支持is_a_boy/is_a_girl表示孩子以及单人kids方法——例如ling.kids(selma)可为单亲声明子女。更多变体可参考 sample53.rb。输出与保存家族树图片调用tree.graph取得底层 GraphViz 图对象graph方法定义在 family_tree.rb再用save导出指定格式tree.graph.save(:png tree.png) # 输出 PNG 图片 puts tree.graph.save(:none String) # 输出 DOT 源码同样支持 SVG、PS 等 GraphViz 全部输出格式。tree.size还能返回家族树中的人物总数方便做数据统计。常见问题解答 FAQQ家族树为什么不是严格的上下层级A家族树使用 neato 布局引擎见FamilyTree.new中:use :neato它按无约束力模型自动布局适合表现跨代、重组家庭等复杂关系。Q同一个人的名字写错会怎样A变量名会被当作新的人物 ID 创建节点。请保持变量命名一致同一人物在不同代际中复用同一个变量名。Q想自定义节点颜色或形状可以吗A可以Person 的节点就是标准 GraphViz 节点可在 person.rb 的基础上二次开发也可以直接使用 GraphViz 完整 DSL 自由组合。总结ruby-graphviz 的 FamilyTree 家族树类把画家谱变成了写故事generation分代、is_a_man/is_a_woman定义人物、is_maried_with连接婚姻、couple(...).kids(...)声明子女最后save一步出图。只需几分钟你就能为自己的家庭生成一张专业的关系图 更多示例代码可浏览 examples/ 目录中的 sample33、sample53、sample99 文件。【免费下载链接】Ruby-Graphviz[MIRROR] Ruby interface to the GraphViz graphing tool项目地址: https://gitcode.com/gh_mirrors/ru/Ruby-Graphviz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考