Translate introduction and key sections of descriptor primer

Copilot · mattwang44 · Copilot · commit b3a4eb3f410e · 2025-07-15T10:35:12.000Z
Co-authored-by: mattwang44 &lt;24987826+mattwang44@users.noreply.github.com&gt;
diff --git a/howto/descriptor.po b/howto/descriptor.po
@@ -57,19 +57,22 @@ msgid ""
 "The \"primer\" gives a basic overview, moving gently from simple examples, "
 "adding one feature at a time.  Start here if you're new to descriptors."
 msgstr ""
+"「入門」提供基本概述，從簡單範例開始逐步介紹，一次新增一個功能。如果你是描述器的新手，請從這裡開始。"
 
 #: ../../howto/descriptor.rst:21
 msgid ""
 "The second section shows a complete, practical descriptor example.  If you "
 "already know the basics, start there."
 msgstr ""
+"第二個章節展示完整、實用的描述器範例。如果你已經了解基礎知識，可以從那裡開始。"
 
 #: ../../howto/descriptor.rst:24
 msgid ""
 "The third section provides a more technical tutorial that goes into the "
 "detailed mechanics of how descriptors work.  Most people don't need this "
 "level of detail."
 msgstr ""
+"第三個章節提供更技術性的教學，深入探討描述器運作的詳細機制。大部分的人不需要這種程度的細節。"
 
 #: ../../howto/descriptor.rst:28
 msgid ""
@@ -79,26 +82,29 @@ msgid ""
 "like :func:`classmethod`, :func:`staticmethod`, :func:`property`, "
 "and :term:`__slots__`."
 msgstr ""
+"最後一個章節提供以 C 語言撰寫的內建描述器的純 Python 等價實作。如果你好奇函式如何轉變為綁定方法，或者想了解常見工具如 :func:`classmethod`、:func:`staticmethod`、:func:`property` 和 :term:`__slots__` 的實作方式，請閱讀此章節。"
 
 #: ../../howto/descriptor.rst:36
 msgid "Primer"
-msgstr ""
+msgstr "入門"
 
 #: ../../howto/descriptor.rst:38
 msgid ""
 "In this primer, we start with the most basic possible example and then we'll "
 "add new capabilities one by one."
 msgstr ""
+"在此入門教學中，我們從最基礎的範例開始，然後逐一新增新功能。"
 
 #: ../../howto/descriptor.rst:43
 msgid "Simple example: A descriptor that returns a constant"
-msgstr ""
+msgstr "簡單範例：回傳常數的描述器"
 
 #: ../../howto/descriptor.rst:45
 msgid ""
 "The :class:`!Ten` class is a descriptor whose :meth:`~object.__get__` method "
 "always returns the constant ``10``:"
 msgstr ""
+":class:`!Ten` 類別是一個描述器，它的 :meth:`~object.__get__` 方法總是回傳常數 ``10``："
 
 #: ../../howto/descriptor.rst:48
 msgid ""
@@ -115,6 +121,7 @@ msgid ""
 "To use the descriptor, it must be stored as a class variable in another "
 "class:"
 msgstr ""
+"要使用描述器，必須將它儲存為另一個類別的類別變數："
 
 #: ../../howto/descriptor.rst:56
 msgid ""
@@ -128,6 +135,7 @@ msgid ""
 "An interactive session shows the difference between normal attribute lookup "
 "and descriptor lookup:"
 msgstr ""
+"互動式工作階段顯示一般屬性查找和描述器查找之間的差異："
 
 #: ../../howto/descriptor.rst:65
 msgid ""
@@ -145,33 +153,38 @@ msgid ""
 "descriptor instance, recognized by its ``__get__`` method. Calling that "
 "method returns ``10``."
 msgstr ""
+"在 ``a.x`` 屬性查找中，點運算子在類別字典中找到 ``'x': 5``。在 ``a.y`` 查找中，點運算子找到一個描述器實例，透過其 ``__get__`` 方法來識別。呼叫該方法回傳 ``10``。"
 
 #: ../../howto/descriptor.rst:78
 msgid ""
 "Note that the value ``10`` is not stored in either the class dictionary or "
 "the instance dictionary.  Instead, the value ``10`` is computed on demand."
 msgstr ""
+"請注意，數值 ``10`` 並不儲存在類別字典或實例字典中。相反地，數值 ``10`` 是按需計算的。"
 
 #: ../../howto/descriptor.rst:81
 msgid ""
 "This example shows how a simple descriptor works, but it isn't very useful. "
 "For retrieving constants, normal attribute lookup would be better."
 msgstr ""
+"這個範例顯示了簡單描述器的運作方式，但它並不是很有用。對於取得常數，一般的屬性查找會比較好。"
 
 #: ../../howto/descriptor.rst:84
 msgid ""
 "In the next section, we'll create something more useful, a dynamic lookup."
 msgstr ""
+"在下一個章節中，我們將建立更有用的東西：動態查找。"
 
 #: ../../howto/descriptor.rst:88
 msgid "Dynamic lookups"
-msgstr ""
+msgstr "動態查找"
 
 #: ../../howto/descriptor.rst:90
 msgid ""
 "Interesting descriptors typically run computations instead of returning "
 "constants:"
 msgstr ""
+"有趣的描述器通常執行計算而不是回傳常數："
 
 #: ../../howto/descriptor.rst:93
 msgid ""
@@ -195,6 +208,7 @@ msgid ""
 "An interactive session shows that the lookup is dynamic — it computes "
 "different, updated answers each time::"
 msgstr ""
+"互動式工作階段顯示查找是動態的——每次都會計算不同的更新答案： ::"
 
 #: ../../howto/descriptor.rst:112
 msgid ""
@@ -221,10 +235,11 @@ msgid ""
 "parameter that lets the :meth:`~object.__get__` method learn the target "
 "directory.  The *objtype* parameter is the class *Directory*."
 msgstr ""
+"除了顯示描述器如何執行計算外，這個範例也揭示了 :meth:`~object.__get__` 參數的目的。*self* 參數是 *size*，一個 *DirectorySize* 的實例。*obj* 參數是 *g* 或 *s*，一個 *Directory* 的實例。正是 *obj* 參數讓 :meth:`~object.__get__` 方法得知目標目錄。*objtype* 參數是類別 *Directory*。"
 
 #: ../../howto/descriptor.rst:131
 msgid "Managed attributes"
-msgstr ""
+msgstr "受管理的屬性"
 
 #: ../../howto/descriptor.rst:133
 msgid ""
@@ -235,13 +250,15 @@ msgid ""
 "and :meth:`~object.__set__` methods are triggered when the public attribute "
 "is accessed."
 msgstr ""
+"描述器的一個常見用途是管理對實例資料的存取。描述器被指派給類別字典中的公開屬性，而實際資料則儲存為實例字典中的私有屬性。當存取公開屬性時，會觸發描述器的 :meth:`~object.__get__` 和 :meth:`~object.__set__` 方法。"
 
 #: ../../howto/descriptor.rst:139
 msgid ""
 "In the following example, *age* is the public attribute and *_age* is the "
 "private attribute.  When the public attribute is accessed, the descriptor "
 "logs the lookup or update:"
 msgstr ""
+"在以下範例中，*age* 是公開屬性，*_age* 是私有屬性。當存取公開屬性時，描述器會記錄查找或更新："
 
 #: ../../howto/descriptor.rst:143
 msgid ""
@@ -318,13 +335,14 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:213
 msgid "Customized names"
-msgstr ""
+msgstr "自訂名稱"
 
 #: ../../howto/descriptor.rst:215
 msgid ""
 "When a class uses descriptors, it can inform each descriptor about which "
 "variable name was used."
 msgstr ""
+"當類別使用描述器時，它可以告知每個描述器使用了哪個變數名稱。"
 
 #: ../../howto/descriptor.rst:218
 msgid ""
@@ -427,14 +445,15 @@ msgstr ""
 
 #: ../../howto/descriptor.rst:295
 msgid "Closing thoughts"
-msgstr ""
+msgstr "結語"
 
 #: ../../howto/descriptor.rst:297
 msgid ""
 "A :term:`descriptor` is what we call any object that "
 "defines :meth:`~object.__get__`, :meth:`~object.__set__`, "
 "or :meth:`~object.__delete__`."
 msgstr ""
+":term:`描述器 <descriptor>` 是我們對任何定義了 :meth:`~object.__get__`、:meth:`~object.__set__` 或 :meth:`~object.__delete__` 的物件的稱呼。"
 
 #: ../../howto/descriptor.rst:300
 msgid ""
