文章摘要
oxdraw是一个用Rust编写的"图表即代码"工具,支持拖拽编辑功能。该项目托管在GitHub上,由RohanAdwankar开发维护,旨在通过代码方式创建和编辑图表,同时保留直观的拖拽操作体验。
文章总结
项目名称:oxdraw - 基于Rust的"图表即代码"工具(支持拖拽编辑)
项目概述: oxdraw是一个使用Rust编写的开源工具,旨在通过声明式语法创建和维护高质量图表。该项目结合了Mermaid语法和可视化编辑功能,主要特点包括:
- 核心功能
- 将.mmd文件编译为图像(SVG/PNG)
- 提供React构建的Web编辑界面
- 可视化调整后的修改会以注释形式保存回源文件
- 保持与标准Mermaid工具的兼容性
- 技术栈
- 后端:Rust CLI工具
- 前端:React框架
- 支持语言:Rust(55.7%)、TypeScript(40%)、CSS(3.4%)
项目愿景 解决Mermaid图表难以精细调整的问题,融合代码生成图表的可维护性与专业绘图软件(如Lucidchart)的灵活性。
使用方式
- 安装:通过Cargo安装(cargo install oxdraw)
- 基础命令: • 渲染图表:oxdraw --input flow.mmd • 启动编辑器:oxdraw --input flow.mmd --edit
- 主要特性
- 支持PNG/SVG输出格式
- 可调整输出缩放比例
- 提供节点/连线样式编辑器
- 包含智能路径计算算法
- 支持子图整体移动
项目状态: - 许可证:MIT - GitHub数据: • 星标:138 • Fork:5 • 最后更新:2025年10月(添加MIT许可证)
注:原文中大量GitHub界面导航菜单、用户交互元素等与项目核心内容无关的信息已省略,保留了项目介绍、功能说明和技术细节等关键内容。
评论总结
该评论内容主要围绕一个声明式图表工具项目展开,主要观点如下:
积极评价与需求契合
- 多位用户表示这正是他们长期寻找的工具,解决了现有工具布局调整困难的问题 "I have been looking for exactly this" (vanilla) "this is exactly what I'm missing from mermaid" (dixtel)
功能建议
- 希望增加悬停弹出信息/嵌套图表功能 "hover pop-up with more information or nested diagrams" (vanilla)
- 建议开放中间数据接口以便二次开发 "expose the intermediate data as inputs and outputs" (monkeycantype)
与竞品对比
- 相比PlantUML/Mermaid,该工具能更好地控制布局 "spending 20-30% of my time desperately trying to tweak the layout" (zmmmmm)
- 但仍有用户希望竞品能直接解决布局问题 "I really wish PlantUML would just solve this" (plmpsu)
技术建议
- 需补充许可证文件(当前仅代码中注明MIT) "Please add the license file" (gurjeet)
- 建议添加Git标签便于包管理 "Git tags / GitHub releases associated with your Cargo releases" (halostatue)
使用场景
- 可与AI结合实现架构设计工作流 "prompt AI to come up with an architecture" (eagleinparadise)
- 便于版本控制集成 "want the same commit that changes the code to also change the architecture diagram" (zmmmmm)
界面反馈
- 示例数据可能引起对可视化编程工具的误解 "causes a little confusion...visual programming tool" (hamburglar)