貢獻 Python document 翻譯的流程

[nicehorse06]

流程

• fork https://github.com/python/python-docs-zh-tw
• git clone 剛剛fork的檔案
• git remote add upstream https://github.com/python/python-docs-zh-tw
• git fetch upstream
• git checkout -b feat/logging upstream/3.12
• 更改翻譯
• VERSION=3.12 make all
• 切到 cd ../cpython
  • 執行 python3 -m http.server 8081 確認有沒有錯誤
  • 去 http://localhost:8081/library/logging.html#module-logging 看翻譯有沒有正確
• 截圖
• commit 和 git push origin feat/logging
• 去fork的repo 發merge request附上截圖
• 如果reviewer要修正 就更改玩再發commit到branch 該branch會對應到PR
  • PR 會提醒reviewer持續更動

基本規則

• po 翻譯長度 不要超過原文
• 標點符號要用中文全行
• 如果是rst語法 叫用英文符號
• 有些字不確定要不要翻就留英文比如 logging
• poedit編輯器去編輯會比較方便 會自動幫你注意長度
• 看文本的文章參照 去看翻譯比較準確 有些不用翻譯
• 翻譯之前要去原始repo issue喊一下自己要翻譯哪一段