參與 Qt 文檔翻譯專案實戰指南：從 Git 工作流到上游合併的完整路徑

前言：為何從文檔翻譯切入開源貢獻？

Qt 原始碼龐大，尋找代碼切入點極具挑戰。文檔翻譯門檻低、見效快、直接惠及全球開發者，是踏入 Qt 社群的最佳途徑。成果將併入 Qt 官方倉庫，隨版本釋出觸達百萬用戶。

Git 分散式版控核心觀念

• Pull/Clone：從遠端拉取完整歷史（SVN 對應 checkout）。
• Commit：提交至本地倉庫（SVN commit 直接推遠端，Git 不同）。
• Push：將本地提交推送至遠端倉庫（相當於 SVN commit）。
• 分散式意義：每個客戶端擁有完整倉庫副本，離線工作、分支實驗零負擔。

Qt 專案採用 Git，Linux Kernel 同樣。Windows 建議安裝 MSYS2 + Git 或 Git for Windows。

專案倉庫與工作流程

專案地址

https://gitorious.org/~cavendish/qt/qt-l10n-zh_cn

頁面提供三種存取協定：Git (SSH)、HTTP、Git (Read-only)。無 Committer 權限者僅見後兩者。

標準貢獻流程（已獲 Committer 權限）

1. Clone：git clone git://gitorious.org/~cavendish/qt/qt-l10n-zh_cn.git（約 800MB+，國內網路需耐心等待）。
2. 翻譯作業：原始文檔位於 doc/src/，將目標檔案複製至 doc/src/zh_CN/ 進行翻譯。嚴禁修改標籤（\list、{} 等），僅翻譯顯示文本。
3. 本地提交：git commit -m "Translate xxx"。
4. 推送遠端：git push 至 qt-l10n-zh_CN 倉庫。
5. 發起合併請求：點擊頁面 Request merge，簽署一次性法律協議（CLA）。獲批後，你的代碼即進入 Qt 上游倉庫。

無 Committer 權限者流程

1. 點擊頁面 Clone repository 建立個人 Fork。
2. 在 Fork 中翻譯、提交、推送。
3. 向 qt-l10n-zh_CN 發起 Merge Request。
4. 專案維護者審核合併後，統一由 Creator 向 Qt 上游發起 Merge Request。

翻譯實務建議

• 對照生成的 HTML/PDF 確認渲染位置與格式。
• 保持術語一致性，參考現有中文翻譯慣例。
• 分批次提交，每次專注單一模組/類別，便於審閱。

版控工具的長期價值

初學 Git 可能感到繁瑣，但掌握後將受益終身：專案歷史可追溯、協作無衝突、實驗性修改零風險。建議將其納入個人/團隊所有專案標準流程。