beanmr/apache-kafka-documentation-cn

Apache Kafka官方文档中文版 Kafka 0.10.0 Documentation 翻译

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 请注意修改。

apache-kafka-documentation-cn's Issues

需要同步一份术语的词汇表翻译

目前翻译第四章时遇到些问题，有必要同步一下一些术语的翻译，目前 kafka 还在学习阶段，所以翻译难免有些生硬，见谅

• Replicated Logs 还有 replicas
• Pipeline 翻译成 管线 似乎总有些绕口
• In-Sync Replicas

http://kafkadoc.beanmr.com/ response Error 1016

关于 Serializer 和 Deserializer 的翻译

Serializer 的词典翻译是 串行器，转换器，总觉得这个翻译有些拗口，有更好的翻译吗？