作为参与者的的第一个开源项目献给了PlantUML
,这是一个部分基于Graphviz
的UML
绘图工具,提供Eclipse插件和命令行使用方法,支持单不仅限于Java,提供自己的一套绘图语言(非常简单),并且直接支持Graphviz
的dot
语法和ditaa
语法,很赞的一个项目,官方主页:http://plantuml.sourceforge.net。
下面是自己参与该项目文档翻译的一些感想。该项目有一个单独的翻译网页:
http://http://translate.plantuml.com。
- 优点
翻译的形式很好,直接把英文一条条拎出来,翻译者就跟做填空题一样,把英文句子对应的中文翻译填进去就好了,直接在线翻译,后台自动转换成pdf格式供预览、下载,让新参与者零门槛参与,很赞。 - 缺点
- 健壮性。翻译的时候会有些特殊格式,比如字体倾斜效果:
\textit{plantuml}
,这种格式非常容易导致后台转换为pdf时出错,比如少些了一个大括号}
,一旦出现这种错误pdf就无法正常输出,可恶的是还没有错误提醒,导致翻译者翻译了一章之后,下载新的pdf文件,发现这一章以后后面的所有章节都没有了,而如果此时其他用户下载文件,也会感觉到莫名其妙。 - 用户反馈。遇到错误没有可以反馈的地方,虽然有个官方论坛,但是似乎活跃度很低,也没有maillist,参与者遇到错误根本不知道去哪里反馈,跟其他参与者互动的机会就更别提了。
- 健壮性。翻译的时候会有些特殊格式,比如字体倾斜效果:
暂时还没有参与到别的开源项目,不知道这是否是通病,不过非常著名的开源项目一般都会提供maillist的,希望多多参与。