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


译者:@D2Feng @Ein Verne

翻译采用章节中英文对照的形式进行,未翻译的章节保持原文。

译文章节组织及内容尽量保持与原文一直,但有时某些句子直译会有些蹩脚,所以可能会进行一些语句上调整。

因为本人能力和精力有限,译文如有不妥欢迎提issue,更期望大家能共同参与进来。

参与翻译Pull Request流程

小伙伴@numbbbbb在《The Swift Programming Language》对协作流程中进行了详细的介绍,小伙伴@looly在他的ES翻译中总结了一下,我抄过来并再次感谢他们的分享。

  1. 首先fork的项目apache-kafka-documentation-cn到你自己的Github
  2. 把fork过去的项目也就是你的项目clone到你的本地
  3. 运行 git remote add ddfeng 把我的库添加为远端库
  4. 运行 git pull ddfeng master 拉取并合并到本地
  5. 翻译内容或者更正之前的内容。
  6. commit后push到自己的库(git push origin master
  7. 登录Github在你首页可以看到一个 pull request 按钮,点击它,填写一些说明信息,然后提交即可。

1~3是初始化操作,执行一次即可。

在提交前请先执行第4步同步库,这样可以及时发现和避免冲突,然后执行5~7既可。

如果嫌以上过程繁琐,你只是准备指出一些不当翻译,也可以点击段落后‘+’直接评论。

小伙伴 @Ein Verne 建议统一中文排版并提供了参考规范,希望大家尽量采纳。

JustDoIT,您的任何建议和尝试都值得尊重!*


因为在我天朝Gitbook比Github还不稳定,所以本人做了个 Hook 来将 Gitbook 生成的内容发布到 Github Pages 上。

在发布的过程会保留 /docs 目录下的 CNAME 文件,如果你要发布到自己的 Github Pages 请注意修改。