作為 Pulsar 社區的一員，想為社區做貢獻卻沒有頭緒嗎？最詳盡文檔翻譯指南來啦！Pulsar 中文社區貢獻者並不局限於貢獻代碼，撰寫、翻譯文檔也可以成為另一種意義上的 Pulsar Contributor！
本次為不熟悉文檔翻譯志願工作的小夥伴們帶來文檔翻譯貢獻指南，手把手帶你熟悉如何進行社區志願貢獻！
社區翻譯任務類型
當前，社區文檔翻譯任務分為三種：
•Apache Pulsar 官方文檔翻譯：主要任務是將 Apache Pulsar 網站上的英文文檔翻譯為中文，讓更多中文用戶更加容易閱讀。翻譯平台使用 Crowdin 進行翻譯提交、管理和審核；•Apache Pulsar 英文博客翻譯：內容範圍較廣，主要聚焦技術原理、案例等方向，英文文章翻譯在釋放給社區成員翻譯之前，我們均已取得原文作者授權；•Apache Pulsar Weekly（周報）翻譯：內容主要聚焦 Apache Pulsar 社區當周的亮點、重要特性、重要 bug 修復、活動和新聞、技術博文推薦幾個板塊。
術語庫
為了保證英文術語翻譯的統一，方便大家理解，我們長期以來都在維護與 Apache Pulsar 相關的術語庫，目前術語庫詞條已達 500 余條。建議在進行官方文檔和英文博客翻譯前，仔細閱讀術語庫，降低後續翻譯審閱工作量。
術語表地址：https://shimo.im/sheets/5jozGy5WIUQQf5JV/MODOC
翻譯流程
參與文檔、博客翻譯工作，簡要步驟如下：
1.掃描文末二維碼添加 Pulsar Bot 好友，回復「志願者」加入 Pulsar 中文社區志願者微信群，在Translation Library 翻譯內容看板[1]認領（在認領的Issue 上評論留言，並在群內@管理員 Tango 留言 Issue 序號進行認領）2.點擊認領的 Issue 任務，根據不同翻譯任務類型進入 Crowdin 平台或 Google Docs3.註冊/登錄自己的 Crowdin 賬號或 Google 賬戶（建議使用谷歌郵箱登陸）4.開始進行 Issue 任務5.任務完成後聯繫管理員進行審核工作
使用 Crowdin 翻譯技術文檔
1.請注意，把 Crowdin 圈紅處須設置成如圖所示（突出顯示未翻譯、已翻譯和 Review 後的字符串，以及是否顯示中文預覽），方便詳細的分辨需翻譯的內容。
2.此處的 ID、Lable 我們一般不翻譯，保留英文。
3.Crowdin 的翻譯是分段的，所以我們需要提前選定點擊所想要翻譯的英文段（如圖左側紅色區域），系統會在右上角（圈紅區域）自動生成默認文本，在藍色區域內輸入我們翻譯的內容。
4.文本中黃色內容為默認鏈接，翻譯時保持原狀即可（可以點擊上方黃色區域自動複製或點擊左下角紅框內的按鈕進行全文本複製後替換其中的英文）。
5.Crowdin 自帶翻譯校對區域（如下圖圈紅區域，內容翻譯僅供參考），所以在翻譯過程中大家可以參考此處內容，但須避免「翻譯腔」。
6.如何辨識 Crowdin 需完成的內容：
•未翻譯內容為紅色•已經翻譯待 Review 內容為淡綠色，文本為灰色•管理員已經 Review 的內容為綠色，文本為黑色
我們的目標就是把所有的紅色區域全部變成綠色！以上為 Crowdin 的基本操作，你 get 了嘛？
翻譯英文博客
1.打開認領的 Issue，圈紅部分為文檔翻譯的指南：
譯者指南：
•請將每段的翻譯一一對應放在相應段落下面，方便審核；•全文請按照 Markdown 格式進行編寫，包括文章代碼、標題、超鏈接、引用等等；•請在文章開頭添加個人簡介。感謝每一位翻譯的志願者，我們希望能讓社區看到你的付出；請在閱讀後將譯者指南刪除。
2.請在每段英文下方寫下對應的中文翻譯。3.完成後在群內同步，編輯將邀請來自 StreamNative 和社區的技術專家對文章翻譯進行審閱。4.譯者確認審閱意見，定稿。
翻譯 Weekly（周報）
1.打開認領的 Issue 內的文檔鏈接，圈紅部分為周報翻譯指南：
譯者指南：
•需向周報內填充的內容有：貢獻者名單、（本周亮點）、重要特性、重要 bug 修復、活動和新聞、博文推薦、結尾的 Pulsar 社區數據幾個板塊；•周報原文來自最新一期的Pulsar Community Weekly Update[2]，請複製後放在相應的板塊內；•每個部分皆有示例，注意事項請仔細閱讀並參考其中的示例樣式[3]進行編輯翻譯；•注意事項：•中英文之間需空格；•請在每段英文下方寫下對應的中文翻譯。•博文推薦需集合英文周報內 blog 與本期間微信公眾號上 Pulsar 相關內容；•文檔全篇請採用 markdown 格式，以便排版；
2.點擊右上角編輯模式（Editing）進行翻譯編輯。
3.按照文檔內圈紅位置示例填充（本周亮點）、重要特性、重要 bug 修復幾個板塊。
4.更新活動和新聞模塊（此處須放上該周內 Apache Pulsar 公眾號發布最新的活動、新聞動態內容）如下圖圈紅區域。
5.博文推薦模塊（如上圖圈藍處需放上該周內周報內博文部分與 Apache Pulsar 公眾號發布的中文博客鏈接）。
6.更新結尾的譯者簡介及 Pulsar 社區數據（如下圖圈紅區域）。
•Pulsar 社區貢獻者、Star、Fork 數量更新位置請參考本鏈接：https://github.com/apache/pulsar ，如下截圖圈紅位置：
• Contributor 數量更新位置如下圖：
7.請更新導語部分的貢獻者名單及該周周報的具體日期（如圖圈紅位置）。
Apache Pulsar GitHub 倉庫在此期間 merged PR 的貢獻者名單，地址：https://github.com/apache/pulsar/pulls?q=is%3Apr+is%3Aclosed
8.完成後請在群內同步，編輯將邀請來自 StreamNative 和社區的技術專家對文章翻譯進行審閱。9.譯者確認審閱意見，定稿。
文檔翻譯貢獻制度-積分制
在 Pulsar 社區，為社區出力的方式多種多樣，不只是代碼的貢獻者，如果你對文檔和內容的翻譯整理、活動的組織策劃、社區的運營感興趣，都可以成為志願者的一員。
Pulsar 社區志願者採用積分制，並非是為了比較大家貢獻的多少，而是記錄大家的熱情，方便我們定期為積極的小夥伴們定製獨有的 Pulsar 志願者周邊來感謝你們的付出和熱愛。
目前社區志願者貢獻採用積分制度：定期積分累計清零，將為積分前 3 的小夥伴郵寄一份專屬的定製禮品，詳情參考下方圖片👇
志願者積分制度與禮品示意圖
Pulsar 中文社區正在招募文檔翻譯志願者，歡迎請掃描下方二維碼回復「志願者」加入我們，趕緊行動起來吧！
掃碼添加 Bot 好友
引用鏈接
[1]Translation Library 翻譯內容看板:https://github.com/streamnative/pulsar-user-group-loc-cn/projects/1[2]Pulsar Community Weekly Update:https://weekly.streamnative.io[3]示例樣式:https://docs.google.com/document/d/1694NBQ2vHKIUDhhQ-sjyewltewNneTj_wrQukI9O31I/edit
▼ 關注「Apache Pulsar」，獲取乾貨與動態 ▼
留言列表