共计 2562 个字符，预计需要花费 7 分钟才能阅读完成。
作为 Pulsar 社区的一员，想为社区做奉献却没有脉络吗？最详尽文档翻译指南来啦！Pulsar 中文社区贡献者并不局限于奉献代码，撰写、翻译文档也能够成为另一种意义上的 Pulsar Contributor！
本次为不相熟文档翻译意愿工作的小伙伴们带来文档翻译奉献指南，手把手带你相熟如何进行社区意愿奉献！
社区翻译工作类型
以后，社区文档翻译工作分为三种：
- Apache Pulsar 官网文档翻译：次要工作是将 Apache Pulsar 网站上的英文文档翻译为中文，让更多中文用户更加容易浏览。翻译平台应用 Crowdin 进行翻译提交、治理和审核；
- Apache Pulsar 英文博客翻译：内容范畴较广，次要聚焦技术原理、案例等方向，英文文章翻译在开释给社区成员翻译之前，咱们均已获得原文作者受权；
- Apache Pulsar Weekly（周报）翻译：内容次要聚焦 Apache Pulsar 社区当周的亮点、重要个性、重要 bug 修复、流动和新闻、技术博文举荐几个板块。
术语库
为了保障英文术语翻译的对立，不便大家了解，咱们长期以来都在保护与 Apache Pulsar 相干的术语库，目前术语库词条已达 500 余条。倡议在进行官网文档和英文博客翻译前，仔细阅读术语库，升高后续翻译审阅工作量。
术语表地址：https://shimo.im/sheets/5jozG…
翻译流程
参加文档、博客翻译工作，简要步骤如下：
- 扫描文末二维码增加 Pulsar Bot 好友，回复「志愿者」退出 Pulsar 中文社区志愿者微信群，在 Translation Library 翻译内容看板认领（在认领的 Issue 上评论留言，并在群内 @管理员 Tango 留言 Issue 序号进行认领）
- 点击认领的 Issue 工作，依据不同翻译工作类型进入 Crowdin 平台或 Google Docs
- 注册 / 登录本人的 Crowdin 账号或 Google 账户（倡议应用谷歌邮箱登陆）
- 开始进行 Issue 工作
- 工作实现后分割管理员进行审核工作
应用 Crowdin 翻译技术文档
- 请留神，把 Crowdin 圈红处须设置成如图所示（突出显示未翻译、已翻译和 Review 后的字符串，以及是否显示中文预览），不便具体的分辨需翻译的内容。
- 此处的 ID、Lable 咱们个别不翻译，保留英文。
- Crowdin 的翻译是分段的，所以咱们须要提前选定点击所想要翻译的英文段（如图左侧红色区域），零碎会在右上角（圈红区域）主动生成默认文本，在蓝色区域内输出咱们翻译的内容。
- 文本中黄色内容为默认链接，翻译时保持原状即可（能够点击上方黄色区域主动复制或点击左下角红框内的按钮进行全文本复制后替换其中的英文）。
- Crowdin 自带翻译校对区域（如下图圈红区域，内容翻译仅供参考），所以在翻译过程中大家能够参考此处内容，但须 防止“翻译腔”。
- 如何辨识 Crowdin 需实现的内容：
- 未翻译内容为红色
- 曾经翻译待 Review 内容为淡绿色，文本为灰色
- 管理员曾经 Review 的内容为绿色，文本为彩色
咱们的指标就是把所有的红色区域全副变成绿色！以上为 Crowdin 的基本操作，你 get 了嘛？
翻译英文博客
- 关上认领的 Issue，圈红局部为文档翻译的指南：
译者指南：
- 请将每段的翻译一一对应放在相应段落上面，不便审核；
- 全文请依照 Markdown 格局进行编写，包含文章代码、题目、超链接、援用等等；
- 请在文章结尾增加个人简介。感激每一位翻译的志愿者，咱们心愿能让社区看到你的付出；请在浏览后将译者指南删除。
- 请在每段英文下方写下对应的中文翻译。3. 实现后在群内同步，编辑将邀请来自 StreamNative 和社区的技术专家对文章翻译进行审阅。4. 译者确认审阅意见，定稿。
翻译 Weekly（周报）
- 关上认领的 Issue 内的文档链接，圈红局部为周报翻译指南：
译者指南：
- 需向周报内填充的内容有：贡献者名单、（本周亮点）、重要个性、重要 bug 修复、流动和新闻、博文举荐、结尾的 Pulsar 社区数据几个板块；
- 周报原文来自最新一期的 Pulsar Community Weekly Update，请复制后放在相应的板块内；
- 每个局部皆有示例，注意事项请仔细阅读并参考其中的示例款式进行编辑翻译；
注意事项：- 中英文之间需空格；
- 请在每段英文下方写下对应的中文翻译。
- 博文举荐需汇合英文周报内 blog 与本期间微信公众号上 Pulsar 相干内容；
- 文档全篇请采纳 markdown 格局，以便排版；
- 点击右上角编辑模式（Editing）进行翻译编辑。
- 依照文档内圈红地位示例填充（本周亮点）、重要个性、重要 bug 修复几个板块。
- 更新流动和新闻模块（此处须放上该周内 Apache Pulsar 公众号公布最新的流动、新闻动态内容）如下图圈红区域。
- 博文举荐模块（如上图圈蓝处需放上该周内周报内博文局部与 Apache Pulsar 公众号公布的中文博客链接）。
- 更新结尾的译者简介及 Pulsar 社区数据（如下图圈红区域）。
- Pulsar 社区贡献者、Star、Fork 数量更新地位请参考本链接：https://github.com/apache/pulsar，如下截图圈红地位：
- Contributor 数量更新地位如下图：
- 请更新导语局部的贡献者名单及该周周报的具体日期（如图圈红地位）。
Apache Pulsar GitHub 仓库在此期间 merged PR 的贡献者名单，地址：https://github.com/apache/pul…
- 实现后请在群内同步，编辑将邀请来自 StreamNative 和社区的技术专家对文章翻译进行审阅。
- 译者确认审阅意见，定稿。
文档翻译奉献制度 - 积分制
在 Pulsar 社区，为社区出力的形式多种多样，不只是代码的贡献者，如果你对文档和内容的翻译整顿、流动的组织策动、社区的经营感兴趣，都能够成为志愿者的一员。
Pulsar 社区志愿者采纳积分制，并非是为了比拟大家奉献的多少，而是记录大家的激情，不便咱们定期为踊跃的小伙伴们定制独有的 Pulsar 志愿者周边来感激你们的付出和酷爱。
目前社区志愿者奉献采纳积分制度：定期积分累计清零，将为积分前 3 的小伙伴邮寄一份专属的定制礼品，详情参考下方图片👇
Pulsar 中文社区正在招募文档翻译志愿者，欢送请扫描下方二维码回复「志愿者」退出咱们，连忙口头起来吧！
“ 扫码增加 Bot 好友 ”
关注 公众号「Apache Pulsar」，获取干货与动静
