Merge branch '3.10' into feat/trans-library-pdb

Author: mattwang44

.github/workflows/ci.yml

@@ -17,5 +17,5 @@ jobs:
       - name: Install Dependencies
         run: sudo apt-get install gettext
 
-      - name: Build
-        run: VERSION=${{ github.event.pull_request.base.ref }} make
+      - name: Validate
+        run: VERSION=${{ github.event.pull_request.base.ref }} MODE=dummy make

Makefile

@@ -23,7 +23,7 @@ VENV := ~/.venvs/python-docs-i18n/
 PYTHON := $(shell which python3)
 MODE := autobuild-dev-html
 BRANCH := $(or $(VERSION), $(shell git describe --contains --all HEAD))
-JOBS = 1
+JOBS := 4
 
 
 .PHONY: all

README.rst

@@ -228,7 +228,8 @@ po 檔皆為首要的翻譯對象。你也可以幫忙校對已經翻譯過的
    在 Glossary 中的譯文仍保持原文，並加註市面上的翻譯。
 
    例如：``int``、``float``、``str``、``bytes``、``list``、``tuple``、
-   ``dict``、``set``、``iterator``、``generator``、``iterable``
+   ``dict``、``set``、``iterator``、``generator``、``iterable``、
+   ``pickle``
 
 
 括號的使用
@@ -313,46 +314,12 @@ rST 語法注意事項
 術語表 Glossary
 ===============
 
-為了讓翻譯保持統一，我們在這邊整理了一個術語列表，如果你有不同意的地方，歡迎\
-打開一個 issue 或是 pull request 一起討論。
-
-===================== =====================
-原文                  翻譯
-===================== =====================
-argument              引數
-attribute             屬性
-approximate           近似
-boolean               boolean（布林）
-class                 class（類別）
-condition             條件
-contributor           貢獻者
-deprecated            已棄用
-dictionary            dictionary（字典）
-element               元素
-exception             例外
-expression            運算式
-float                 float（浮點數）
-function              函式
-import                import（不翻譯）
-index                 索引
-instance              實例
-int                   int（整數）
-interpreter           直譯器
-iterate               疊代
-list                  list（串列）
-loop                  迴圈
-method                method（方法）
-module                module（模組）
-object                物件
-operand               運算元
-operator              運算子
-parameter             參數
-prompt                提示字元
-return                回傳
-set                   set（集合）
-statement             陳述式
-type                  型別
-===================== =====================
+為了讓翻譯保持統一，我們整理了一份 `術語列表 
+<https://airtable.com/shrHlRP52bZ9C7aY3/tbl7dhPe9Ph9XIAy3>`_ \
+如果翻譯過程中你覺得需要術語列表有所缺漏，請填寫 `術語列表擴充表單 \
+<https://airtable.com/shr6sU4HHSKAz0Y7J>`_。新增的術語，將會於每次\
+Sprint中共同討論是否合併進術語列表。
+
 
 
 問題回報與討論
@@ -361,7 +328,7 @@ type                  型別
 如果有需要共同討論的問題，請開設一個新的 Issue_。如果是翻譯上遇到困難需要\
 幫助，則可以使用 Telegram_。
 
-.. _Issue: https://github.com/python-doc-tw/python-docs-zh-tw/issues
+.. _Issue: https://github.com/python/python-docs-zh-tw/issues
 .. _Telegram: https://t.me/PyDocTW
 
 另外，此翻譯的 coordinator 為 `mattwang44 <https://github.com/mattwang44>`_ 和 \

TRANSLATORS

@@ -6,10 +6,36 @@ project, it may not be complete but you're always welcome to add your name
 here by making a pull request if you've contributed this project in any way.
 Kudos to any one who've contributed to this project!
 
-This list includes those who contributed on Transifex before May 2018, which
-is before the transition of the workflow from Transifex to GitHub. The names
-listed here are followed by the translator's Transifex user ID quoted using
-angle brackets, feel free to remove it if you prefer not to disclose it.
+Adrian Liaw (Wey-Han Liaw)
+Allen Wu (allen91wu)
+Benson Chen
+Grimmer
+Liang Bo Wang
+Patina Ho
+Scott Chang
+Sonia Wu
+Steven Hsu (StevenHsuYL)
+Taihsiang Ho (tai271828)
+Tsai, Chia-Wen
+Wei-Hsiang (Matt) Wang
+Wilson Wang (Josix)
+Yu Chun Yang
+Jason (chairco)
+chinghao.liu (chinghao-tw)
+jordanSu
+meowmeowcat
+nickbanana
+nienzu
+ttnppedr
+yichung
+zztin
+戴靖
+
+
+This list below includes those who contributed on Transifex before May 2018,
+which is before the transition of the workflow from Transifex to GitHub. The
+names listed here are followed by the translator's Transifex user ID quoted
+using angle brackets, feel free to remove it if you prefer not to disclose it.
 
 
 Liang-Bo Wang <ccwang002>

about.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:

bugs.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:

c-api/abstract.po

@@ -1,27 +1,30 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
-# aminzai <[email protected]>, 2015
+# aminzai <[email protected]>, 2017
+# Matt Wang <[email protected]>, 2021
+#
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2018-06-26 18:54+0800\n"
-"PO-Revision-Date: 2017-09-22 18:26+0000\n"
-"Last-Translator: aminzai <lagunawang@gmail.com>\n"
+"PO-Revision-Date: 2021-12-09 21:20+0800\n"
+"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
+"X-Generator: Poedit 3.0\n"
 
 #: ../../c-api/abstract.rst:7
 msgid "Abstract Objects Layer"
-msgstr "抽象物件層"
+msgstr "抽象物件層 (Abstract Objects Layer)"
 
 #: ../../c-api/abstract.rst:9
 msgid ""
@@ -30,6 +33,9 @@ msgid ""
 "or all sequence types).  When used on object types for which they do not "
 "apply, they will raise a Python exception."
 msgstr ""
+"本章中的函式與 Python 物件相互作用，無論其型別、或具有廣泛類別的物件型別（例"
+"如所有數值型別或所有序列型別）。當使用於不適用的物件型別時，他們會引發一個 "
+"Python 異常 (exception)。"
 
 #: ../../c-api/abstract.rst:14
 msgid ""
@@ -38,3 +44,5 @@ msgid ""
 "`PyList_New`, but whose items have not been set to some non-\\ ``NULL`` "
 "value yet."
 msgstr ""
+"這些函式是不可能用於未正確初始化的物件（例如一個由 :c:func:`PyList_New` 建立"
+"的 list 物件），而其中的項目沒有被設為一些非 ``NULL`` 的值。"

c-api/allocation.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:

c-api/apiabiversion.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:

c-api/arg.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
@@ -1011,35 +1011,35 @@ msgstr "將一個 C 的 :c:type:`short int` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:596
 msgid "Convert a C :c:type:`long int` to a Python integer object."
-msgstr "將一個 C 的 C :c:type:`long int` 轉換成 Python 整數物件。"
+msgstr "將一個 C 的 :c:type:`long int` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:599
 msgid "Convert a C :c:type:`unsigned char` to a Python integer object."
-msgstr "將一個 C 的 C :c:type:`unsigned char` 轉換成 Python 整數物件。"
+msgstr "將一個 C 的 :c:type:`unsigned char` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:602
 msgid "Convert a C :c:type:`unsigned short int` to a Python integer object."
 msgstr "將一個 C 的 :c:type:`unsigned short int` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:605
 msgid "Convert a C :c:type:`unsigned int` to a Python integer object."
-msgstr "將一個 C 的 C :c:type:`unsigned int` 轉換成 Python 整數物件。"
+msgstr "將一個 C 的 :c:type:`unsigned int` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:608
 msgid "Convert a C :c:type:`unsigned long` to a Python integer object."
-msgstr "將一個 C 的 C :c:type:`unsigned long` 轉換成 Python 整數物件。"
+msgstr "將一個 C 的 :c:type:`unsigned long` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:611
 msgid "Convert a C :c:type:`long long` to a Python integer object."
-msgstr "將一個 C 的 C :c:type:`long long` 轉換成 Python 整數物件。"
+msgstr "將一個 C 的 :c:type:`long long` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:614
 msgid "Convert a C :c:type:`unsigned long long` to a Python integer object."
 msgstr "將一個 C 的 :c:type:`unsigned long long` 轉換成 Python 整數物件。"
 
 #: ../../c-api/arg.rst:617
 msgid "Convert a C :c:type:`Py_ssize_t` to a Python integer."
-msgstr ""
+msgstr "將一個 C 的 :c:type:`Py_ssize_t` 轉換成 Python 整數。"
 
 #: ../../c-api/arg.rst:621
 msgid "``c`` (:class:`bytes` of length 1) [char]"
@@ -1059,11 +1059,11 @@ msgstr ""
 
 #: ../../c-api/arg.rst:628
 msgid "Convert a C :c:type:`double` to a Python floating point number."
-msgstr ""
+msgstr "將一個 C 的 :c:type:`double` 轉換成 Python 浮點數。"
 
 #: ../../c-api/arg.rst:631
 msgid "Convert a C :c:type:`float` to a Python floating point number."
-msgstr ""
+msgstr "將一個 C 的 :c:type:`float` 轉換成 Python 浮點數。"
 
 #: ../../c-api/arg.rst:634
 msgid "``D`` (:class:`complex`) [Py_complex \\*]"

c-api/bool.po

@@ -1,27 +1,30 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
 # Ching-Lung Chuang, 2015
+# Matt Wang <[email protected]>, 2021
+#
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2021-09-13 00:11+0000\n"
-"PO-Revision-Date: 2017-09-22 18:26+0000\n"
-"Last-Translator: Ching-Lung Chuang\n"
+"POT-Creation-Date: 2021-06-29 12:56+0000\n"
+"PO-Revision-Date: 2021-12-09 20:47+0800\n"
+"Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
+"X-Generator: Poedit 3.0\n"
 
 #: ../../c-api/bool.rst:6
 msgid "Boolean Objects"
-msgstr "布林物件"
+msgstr "Boolean（布林）物件"
 
 #: ../../c-api/bool.rst:8
 msgid ""
@@ -30,39 +33,49 @@ msgid ""
 "normal creation and deletion functions don't apply to booleans.  The "
 "following macros are available, however."
 msgstr ""
+"Python 中的 boolean 是以整數子類別化來實現的。只有 :const:`Py_False` 和 :"
+"const:`Py_True` 兩個 boolean。因此一般的建立和刪除函式並不適用於 boolean。但"
+"下列巨集 (macro) 是可用的。"
 
 #: ../../c-api/bool.rst:16
 msgid ""
 "Return true if *o* is of type :c:data:`PyBool_Type`.  This function always "
 "succeeds."
 msgstr ""
+"如果 *o* 的型別為 :c:data:`PyBool_Type` 則回傳真值。此函式總是會成功執行。"
 
 #: ../../c-api/bool.rst:22
 msgid ""
 "The Python ``False`` object.  This object has no methods.  It needs to be "
 "treated just like any other object with respect to reference counts."
 msgstr ""
+"Python 的 ``False`` 物件。此物件沒有任何方法。在參照 (reference) 計數上必須有"
+"著和其他物件一樣的處理方式。"
 
 #: ../../c-api/bool.rst:28
 msgid ""
 "The Python ``True`` object.  This object has no methods.  It needs to be "
 "treated just like any other object with respect to reference counts."
 msgstr ""
+"Python 的 ``True`` 物件。此物件沒有任何方法。在參照計數上必須有著和其他物件一"
+"樣的處理方式。"
 
 #: ../../c-api/bool.rst:34
 msgid ""
 "Return :const:`Py_False` from a function, properly incrementing its "
 "reference count."
-msgstr ""
+msgstr "從函式回傳 :const:`Py_False`\\ ，並適當的增加它的參照計數。"
 
 #: ../../c-api/bool.rst:40
 msgid ""
 "Return :const:`Py_True` from a function, properly incrementing its reference "
 "count."
-msgstr ""
+msgstr "從函式回傳 :const:`Py_True`\\ ，並適當的增加它的參照計數。"
 
 #: ../../c-api/bool.rst:46
 msgid ""
 "Return a new reference to :const:`Py_True` or :const:`Py_False` depending on "
 "the truth value of *v*."
 msgstr ""
+"根據 *v* 的實際值來回傳一個 :const:`Py_True` 或者 :const:`Py_False` 的新參"
+"照。"

c-api/buffer.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:
@@ -20,7 +20,7 @@ msgstr ""
 
 #: ../../c-api/buffer.rst:11
 msgid "Buffer Protocol"
-msgstr ""
+msgstr "緩衝協定 (Buffer Protocol)"
 
 #: ../../c-api/buffer.rst:18
 msgid ""

c-api/bytearray.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:

c-api/bytes.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 #
 # Translators:

c-api/call.po

@@ -1,5 +1,5 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2021, Python Software Foundation
+# Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 #