Apache Kafka 官方文档中文版
Apache Kafka是一个高吞吐量分布式消息系统。
Kafka在国内很多公司都有大规模的应用,但关于它的中文资料并不多,只找到了12年某版本的设计章节的翻译。
为了方便大家学习交流,尽最大努力翻译一下完整的官方的手册。
原文版本选择当前最新的Kafka 0.10.0的文档(2016-08)。
前辈们在OS China上翻译的设计章节非常优秀,如果之前没有阅读过推荐先参考一下。
** 翻译中 **
发现有小伙伴已经下载了,如果你发现后面还是英文不是我掺假是你着急了!
最近国内 Gitbook 比较不稳定,可以使用 Github Pages 地址阅读
Github Pages:Apache Kafka 官方文档中文版
源文档地址:Kafka 0.10.0 Documentation
Github: BeanMr/apache-kafka-documentation-cn
Gitbook下载: Apache Kafka Documentation CN
翻译采用章节中英文对照的形式进行,未翻译的章节保持原文。
译文章节组织及内容尽量保持与原文一直,但有时某些句子直译会有些蹩脚,所以可能会进行一些语句上调整。
因为本人能力和精力有限,译文如有不妥欢迎提issue,更期望大家能共同参与进来。
参与翻译Pull Request流程
小伙伴@numbbbbb在《The Swift Programming Language》对协作流程中进行了详细的介绍,小伙伴@looly在他的ES翻译中总结了一下,我抄过来并再次感谢他们的分享。
- 首先fork的项目apache-kafka-documentation-cn到你自己的Github
- 把fork过去的项目也就是你的项目clone到你的本地
- 运行
git remote add ddfeng
把我的库添加为远端库 - 运行
git pull ddfeng master
拉取并合并到本地 - 翻译内容或者更正之前的内容。
- commit后push到自己的库(
git push origin master
) - 登录Github在你首页可以看到一个
pull request
按钮,点击它,填写一些说明信息,然后提交即可。
1~3是初始化操作,执行一次即可。
在提交前请先执行第4步同步库,这样可以及时发现和避免冲突,然后执行5~7既可。
如果嫌以上过程繁琐,你只是准备指出一些不当翻译,也可以点击段落后‘+’直接评论。
小伙伴 @Ein Verne 建议统一中文排版并提供了参考规范,希望大家尽量采纳。
JustDoIT,您的任何建议和尝试都值得尊重!*
因为在我天朝Gitbook比Github还不稳定,所以本人做了个 Hook 来将 Gitbook 生成的内容发布到 Github Pages 上。
在发布的过程会保留 /docs 目录下的 CNAME 文件,如果你要发布到自己的 Github Pages 请注意修改。