本 GitHub repository 含有 Python 官方說明文件的 zh_TW 翻譯。實際的翻譯內容\

在這個 repository 裡以 Python 的穩定發行版本作為 branch 名稱，請參考 3.6 等

在這個 repository 裡以 Python 的穩定發行版本作為 branch 名稱，請參考 3.7 等

branch 以查看目前的翻譯內容。此 master branch 則為專案的貢獻說明。

您可以在 https://python-doc-tw.github.io/ 瀏覽目前翻譯的成果。目前以

Python 3.6 為翻譯的對象，**暫時不考慮 Python 2.7 的翻譯工作**。未來有新的

Python 3.7 為翻譯的對象，**暫時不考慮 Python 2.7 的翻譯工作**。未來有新的

Python 發行版本時，也將會將翻譯滾動至新的版本。

想問問題、認識翻譯同好，歡迎加入 Telegram 聊天室 `t.me/PyDocTW`_

翻譯守則

#. 譯文應兼顧前後文大意。

``dict``、``set``、``iterator``、``generator``、``iterable``

括號的使用

如果括號中的文字包含中文，使用全形括號；如果括號中只有英文，使用半形括號並\

比照英文的形式加入前後文的空白。

例如：

- list（串列）是 Python 中很常見的資料型別。

- 在本情況使用 ``zip(*[iter(x)]*n)`` 是很常見的情況（Python 慣例）。

- 在超文件標示語言 (HTML) 中應注意跳脫符號。

rST 語法注意事項

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

- rST 諸多語法需要保留前後的空白。在中文裡，該空白可以用:literal:`\\\\`

來取代，製造一個沒有寬度的分隔符號。

例如：

..code-block::rst

翻譯為

..code-block::rst

- 超連結語法該要在譯文中保留原字串。

例如：

..code-block::rst

應更改為

..code-block::rst

才能正確顯示為「Python issue tracker 上\`文件相關的錯誤<#>`_」，連結與\

前文才不會有多餘的空白。

- 舉例中有程式碼時，前一段經常為 ``::`` 結尾，此記號\`具有特殊意義

<http://www.sphinx-doc.org/en/stable/rest.html#source-code>`_，除了該段落\

結尾為冒號外，也代表下段縮排為程式碼。翻譯時應改為全型冒號，並\**增加以**

``::`` **開頭的新段落**。

例如：

..code-block::rst

程式碼並不會出現在 po 檔之中，故在 po 檔中會顯示為

..code-block::rst

此時翻譯應為：

..code-block::rst

注意\**額外的空行是必須的**。

術語表 Glossary

為了讓翻譯保持統一，我們在這邊整理了一個術語列表，如果您有不同意的地方，歡迎\

打開一個 issue 或是 pull request 一起討論。

問題回報與討論

如果有需要共同討論的問題，請開設一個新的Issue_。如果是翻譯上遇到困難需要\

幫助，則可以使用Telegram_。

額外翻譯資源

- Telegram group `t.me/PyDocTW`_

- `Doc-SIG mailing list<https://mail.python.org/mailman/listinfo/doc-sig>`_