Translation guideline

翻譯守則 Translation Guideline (TG)

1. 譯文應兼顧前後文大意。
2. 中文句中使用大寫的標點符號；英文句維持小寫的標點符號。
   例如：「」（）、，。
   例如：Python is supported by Python Software Foundation (PSF).
3. 中英文交雜時要插入空白；符號英文間不用。
   例如：使用 CPU 運算、使用「CPU」運算。
4. 專有名詞應該參考 Transifex 上 Glossary 裡對照表的翻譯方式。
5. 專有名詞可以選擇不翻譯。
   例如：CPU、Unicode。
6. 在翻譯名稱不常用或不確定的情形，宜用刮號註解或直接保留原文。單頁只要首次出現有註解即可。
   例如：正規表示式（regular expression）、可攜式網路圖形（Portable Network Graphics）。
   例如：Network News Transfer Protocol。
7. po 檔單行不應超過 79 字元寬度（Transifex 會自動處理）
8. （實驗中）內建型別應保留原文（除該型別介紹頁與 Python 教學系列文外）。 這些詞出現頻繁，翻譯後反正較難理解市面上 Python 的文章。 在 Glossary 中會加上 [high freq] 與原文。
   例如：bool、int、float、str、bytes、list、tuple、dict、set、iterator、generator

rst 語法注意事項

• ```:xxx:`...```` 即為 rst 的語法，應該在譯文中保留。

• rst 諸多語法需要保留前後的空白。在中文裡，該空白可以用 \ 來取代，製造一個沒有寬度的分隔符號。
  例如：

  For more information, please see :ref:`detail-instruction`.
  

  翻譯為

  更多資訊請參考\ :ref:`detail-instruction`\ 。
  

• 超連結語法該要在譯文中保留原字串。
  例如：

  `Documentation bugs`_ on the Python issue tracker
  

  應更改為

  Python issue tracker 上\ `文件相關的錯誤 <Documentation bugs_>`_