github地址：https://github.com/qiudaoke/flowable-userguide

码云地址：https://gitee.com/Flowable/flowable-userguide

今天Flowable官方正式同意“分享牛”团队负责以及持续跟踪文档的汉化，设计器的汉化工作。这个争取的道路有些艰辛，本来Flowable团队是不愿意其他国家的人去进行文档以及设计器文件的本土化操作的。基于如下几个原因：

刚开始一时兴起，本土化定制，后续没人维护。比如葡萄牙语本土化之后，后续就没人再去维护。
官方大部分开发人员都是只会英文，对于其他语言也不尽完全精通，导致新增了一些功能之后，直接将英文属性复制到其他国家语言的文件中，缺乏实时性沟通以及通知问题。

Flowable中国社区是由“分享牛”领队并聚合了一帮志同道合（分享牛目前是开源框架Flowable中国社区贡献最多的贡献者，长期的贡献和关注已经得到了Flowable官方的信赖），长期从事工作流的爱好者一起维护。因此上述几个问题均不存在。为此Flowable官方Leader tijsrademakers同意让“分享牛”一群人长期维护文档的汉化，设计器的汉化工作。

分享牛曾经PR的反馈

如何贡献代码

一起成为开源代码贡献人员，欢迎大家加入qq交流群为社区贡献添砖加瓦：1023773998
点击链接加入群聊【Flowable官方中国社区群】：https://jq.qq.com/?_wv=1027&k=5tRwTr4

群主旨

群的主旨是尽量提一些Flowable框架的Bug,本群的爱好者、布道师、贡献者会根据反馈及时快速的修复并让官方合并。如果对于官方的汉化文档有歧义，我们也会快速进行修复。

文档汉化须知

如果觉得文档PR操作比较繁琐，可以直接现在GitHub issue中认领任务。然后直接下载文件，在Idea中打开，汉化之后，发到群文件也可以。

天下事有难易乎？为之，则难者亦易矣；不为，则易者亦难矣。文档汉化虽然简单，但是也需要有一定的BPMN/DMN/CMMN功底。如果对于上述的几个规范协议一无所知，也没有关系。我们重在参与。相信如果自己即使一点也不懂，但是经过长时间的文档通读和翻看其他贡献者的汉化记录，也会知其然。所谓熟能生巧就是这个道理。因为参与文档汉化的人员比较多，知识体系良莠不齐。为此我们必须要有高质量的翻译和校稿团队，才能保证尽可能的让翻译汉化的成果更好，为此我们专门开了一个项目，大家可以随时提交自己的翻译结果并联系分享牛、Activiti权威指南一书作者张志祥、郑州轻工业大学软件学院的张志峰教授一起把关、把脉。最后有“分享牛”一起提交到官方，文档中会罗列每一位贡献者的名字。争取让社区的力量发挥到极致，将错误概率降到最低。相信通过大家的努力我们会做的更好，走的更远，站得更高。

再次感谢每一位辛勤付出的贡献人员。

下文重点说一下文档汉化的注意点。

项目地址

项目托管于GitHub中，地址：https://github.com/qiudaoke/flowable-userguide

fork步骤

1、在浏览器打开上述的URL之后，可以“Start”下这个仓库，然后点击“Fork”按钮。

2、fork的前提是大家需要进行登录GitHub。

3、fork之后，该仓库内容会自动同步到GitHub登录用户的仓库中。

4、通过命令行或者客户端下载源代码即可。

5、自己仓库的代码怎么跟源仓库内容更新呢？

 git remote -v git remote add upstream git@github.com:qiudaoke/flowable-userguide.gitgit fetch upstream git merge upstream/master git push

源码导入

建议大家直接使用Idea开发工具，直接将下载之后的源码导入即可。

Idea插件安装

Idea需要安装一下AsciiDoc插件，如下图所示：

PR步骤

1、前提是自己进行了本地仓库文件有改动并且要提交才去这个操作。PR之前需要自己新建一个分支，然后切换到新建的分支，进行代码的提交和推送即可。下面是test分支的建立命令：

git branch test
git checkout test

2、打开地址：https://github.com/qiudaoke/flowable-userguide

点击“New pull request”按钮

选择base fork
选择head fork
点击Create pull request，并填写创建信息。
点击Merge pull request 合并从源fork来的代码。
qq交流群里面，联系分享牛合并代码即可。
完成。

源码目录说明

为了保证没一个版本都是高可用的，我在这个仓库中为每一个版本都新建了一个文件夹。这样咱们就能保证每一个版本的文档，下载下来就可以直接用。如下图所示：

点击该目录进去，如下图所示：

我们直接去找到flowable-userguide/V6.5/docs/userguide/src/zh_CN目录，打开里面.adoc文件进行汉化即可。

adoc文件预览

只要大家在idea中安装了上文提到的AsciiDoc插件，随便打开一个adoc文件就可以实时看到预览图，如下所示：

adoc文件汉化注意点

类似include::标签不要动，这个就是引入其他文件的标志。
base目录不要去修改，我们在汉化完毕之后，会统一加上所有参与人员的名字，一起提交到官方。

汉化的过程中，原有的内容不要删除，方便后续咱们一起校稿对比。在汉化过程中，可以直接复制一个，然后放到下面进行汉化即可（代码不用汉化）。 理想的结构是，一段英文，一段中文。原有的排版尽量别动，这样方便后续的排版。可以保证咱们去做更多有意义的事情。

汉化的时候，以adoc文件为单位进行汉化。这样更系统的去学习，翻译不是目的，目的是自己能看明白，学会。这样意义更大。
汉化的时候，可以一起去群里面商量下，这样尽量避免重复劳动。

后语

相信通过大家的努力我们会做的更好，走的更远，站得更高。再次感谢每一位辛勤付出的贡献人员。

Flowable官方指定中国社区成立了相关推荐

全球区块链（智媒链）技术交流暨中国社区成立大会圆满结束
2017年12月6日,全球区块链(智媒链)技术交流暨中国社区成立大会在杭州圆满落幕. 移除点击此处添加图片说明文字本次会议由瑞士智媒链基金会主办,中科传媒.信链app.rfinex.com. ...
Spring Cloud 中国社区一周年技术沙龙-北京站
一.活动介绍随着云计算.互联网公司云化基础设施.标准化代码管理等日趋成熟,DevOps.持续交付等概念深入人心,为传统IT系统的微服务云化扫清了技术和文化障碍,微服务在企业IT架构或云转型过程中发挥 ...
Dapr中国社区活动之分布式运行时开发者日（2022.09.03)
自2019年10月首次发布以来,Dapr(Distributed Application Runtime,分布式应用运行时)因其"更稳定"."更可靠".&quo ...
今日科技联播：搜索热度赶超214情人节，七夕成中国情侣“撒狗粮”官方指定时间...
点击关注云栖社区,置顶公众号专业的行业热点新闻及技术干货,不容错过 ---------------- 今日热点行行好,给单身狗一条活路呗,七夕已经当仁不让地成为"过浪漫".&q ...
长沙4月21日开发者大会暨.NET社区成立大会活动纪实
活动总结 2019年4月21日是一个斜风细雨.微风和煦的美好日子,由长沙.NET技术社区.腾讯云云加社区.微软Azure云技术社区.中国.NET技术社区.长沙柳枝行动.长沙互联网活动基地(唐胡子俱乐部 ...
祝福丨TF中文社区成立一周年
很多人把加入开源社区,形象地叫做"入坑",但这个坑值不值得进,一要看开源项目是否技术强大.稳定更新.有应用价值:二是看社区的开放和活跃程度,聚集了多少人气,做出了多少贡献. 那么, ...
在 RustCon Asia 开启之前，聊聊 Rust 中国社区那些事
2019独角兽企业重金招聘Python工程师标准>>> 亚洲首届 RustCon Asia 将在 4 月 20 日于北京开启(也就是下周六啦~),大会为期 4 天,包括 20 日全天 ...
联易融成为BSN合格开发者，供应链金融平台入选官方指定应用
近期,经BSN发展联盟审核批准,联易融区块链正式成为区块链服务网络(BSN)合格开发者,并将联易融自主研发区块链BeeTrust的供应链金融区块链服务平台入选供应链金融类BSN官方指定应用. 随着联易 ...
苦尽甘来——Ceph中国社区2016
作者 | 孙琦耿航校对 2016年12月11日,北京万寿宾馆,Ceph中国社区迎来了2016年最后一场活动,这是第一次.也是唯一一次全天的活动,到下午会议结束的一刻,整个会场仍然是满坑满谷,这也 ...
IPFS中国社区丨最简单全面介绍IPFS
作者丨IPFS中国社区:IP君文章来源丨www.ipfs.cn 原文地址丨http://www.ipfs.cn/news/info-100173.html · 互联网是我们日常生活中最重要的工具, ...

Flowable官方指定中国社区成立了