Deploy preview for PR 1148 🛫

Author: mattwang44

pr-preview/pr-1148/_sources/c-api/capsule.rst.txt

@@ -15,7 +15,7 @@ Refer to :ref:`using-capsules` for more information on using these objects.
 .. c:type:: PyCapsule
 
    This subtype of :c:type:`PyObject` represents an opaque value, useful for C
-   extension modules who need to pass an opaque value (as a :c:expr:`void*`
+   extension modules which need to pass an opaque value (as a :c:expr:`void*`
    pointer) through Python code to other C code.  It is often used to make a C
    function pointer defined in one module available to other modules, so the
    regular import mechanism can be used to access C APIs defined in dynamically

pr-preview/pr-1148/_sources/c-api/code.rst.txt

@@ -289,7 +289,7 @@ may change without deprecation warnings.
 
 .. c:function:: Py_ssize_t PyUnstable_Eval_RequestCodeExtraIndex(freefunc free)
 
-   Return a new an opaque index value used to adding data to code objects.
+   Return a new opaque index value used to adding data to code objects.
 
    You generally call this function once (per interpreter) and use the result
    with ``PyCode_GetExtra`` and ``PyCode_SetExtra`` to manipulate

pr-preview/pr-1148/about.html

@@ -314,7 +314,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/bugs.html

@@ -190,13 +190,9 @@ <h3>導航</h3>
 <section id="documentation-bugs">
 <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title="連結到這個標頭">¶</a></h2>
 <p>如果你在這份說明文件中發現了錯誤並想要提出改進方案，請將錯誤報告提交到<a class="reference internal" href="#using-the-tracker"><span class="std std-ref">錯誤追蹤系統 (issue tracker)</span></a>。如果你有相應的修正建議，請一併提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 <a class="reference external" href="https://github.com/python/python-docs-zh-tw/issues">https://github.com/python/python-docs-zh-tw/issues</a>。）</p>
-<p>If the bug or suggested improvement concerns the translation of this
-documentation, submit the report to the
-<a class="reference external" href="https://github.com/python/python-docs-zh-tw">translation’s repository</a> instead.</p>
+<p>如果錯誤或建議的改進涉及此文件的翻譯，請將報告提交到<a class="reference external" href="https://github.com/python/python-docs-zh-tw">翻譯存儲庫</a>。</p>
 <p>你也可以在我們的<a class="reference external" href="https://discuss.python.org/c/documentation/26">說明文件 Discourse 討論區</a>中新增一個討論事項。</p>
-<p>If you find a bug in the theme (HTML / CSS / JavaScript) of the
-documentation, please submit a bug report on the <a class="reference external" href="https://github.com/python/python-docs-theme">python-doc-theme issue
-tracker</a>.</p>
+<p>如果你發現文件主題 (HTML / CSS / JavaScript) 中存在錯誤，請在 <a class="reference external" href="https://github.com/python/python-docs-theme">python-doc-theme 問題追蹤系統</a>上提交錯誤報告。</p>
 <div class="admonition seealso">
 <p class="admonition-title">也參考</p>
 <dl class="simple">
@@ -233,7 +229,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
 </section>
 <section id="getting-started-contributing-to-python-yourself">
 <span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭">¶</a></h2>
-<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://devguide.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
+<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://devguide.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
 </section>
 </section>
 
@@ -355,7 +351,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/abstract.html

@@ -323,7 +323,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/allocation.html

@@ -432,7 +432,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/apiabiversion.html

@@ -471,7 +471,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/arg.html

@@ -91,7 +91,7 @@ <h3><a href="../contents.html">目錄</a></h3>
     <ul>
 <li><a class="reference internal" href="#">剖析引數與建置數值</a><ul>
 <li><a class="reference internal" href="#parsing-arguments">剖析引數</a><ul>
-<li><a class="reference internal" href="#strings-and-buffers">Strings and buffers</a></li>
+<li><a class="reference internal" href="#strings-and-buffers">字串與緩衝區</a></li>
 <li><a class="reference internal" href="#numbers">數字</a></li>
 <li><a class="reference internal" href="#other-objects">其他物件</a></li>
 <li><a class="reference internal" href="#api-functions">API 函式</a></li>
@@ -210,7 +210,7 @@ <h2>剖析引數<a class="headerlink" href="#parsing-arguments" title="連結到
 the format unit; and the entry in [square] brackets is the type of the C
 variable(s) whose address should be passed.</p>
 <section id="strings-and-buffers">
-<span id="arg-parsing-string-and-buffers"></span><h3>Strings and buffers<a class="headerlink" href="#strings-and-buffers" title="連結到這個標頭">¶</a></h3>
+<span id="arg-parsing-string-and-buffers"></span><h3>字串與緩衝區<a class="headerlink" href="#strings-and-buffers" title="連結到這個標頭">¶</a></h3>
 <div class="admonition note">
 <p class="admonition-title">備註</p>
 <p>On Python 3.12 and older, the macro <code class="xref c c-macro docutils literal notranslate"><span class="pre">PY_SSIZE_T_CLEAN</span></code> must be
@@ -405,14 +405,14 @@ <h3>數字<a class="headerlink" href="#numbers" title="連結到這個標頭">¶
 </dd>
 <dt><code class="docutils literal notranslate"><span class="pre">k</span></code> (<a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></a>) [unsigned long]</dt><dd><p>將一個 Python 整數轉換成 C 的 <span class="c-expr sig sig-inline c"><span class="kt">unsigned</span><span class="w"> </span><span class="kt">long</span></span>，轉換過程無溢位檢查。</p>
 <div class="versionchanged">
-<p><span class="versionmodified changed">在 3.14 版的變更: </span>Use <a class="reference internal" href="../reference/datamodel.html#object.__index__" title="object.__index__"><code class="xref py py-meth docutils literal notranslate"><span class="pre">__index__()</span></code></a> if available.</p>
+<p><span class="versionmodified changed">在 3.14 版的變更: </span>如有提供則使用 <a class="reference internal" href="../reference/datamodel.html#object.__index__" title="object.__index__"><code class="xref py py-meth docutils literal notranslate"><span class="pre">__index__()</span></code></a>。</p>
 </div>
 </dd>
 <dt><code class="docutils literal notranslate"><span class="pre">L</span></code> (<a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></a>) [long long]</dt><dd><p>將一個 Python 整數轉換成 C 的 <span class="c-expr sig sig-inline c"><span class="kt">long</span><span class="w"> </span><span class="kt">long</span></span>。</p>
 </dd>
 <dt><code class="docutils literal notranslate"><span class="pre">K</span></code> (<a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></a>) [unsigned long long]</dt><dd><p>將一個 Python 整數轉換成 C 的 <span class="c-expr sig sig-inline c"><span class="kt">unsigned</span><span class="w"> </span><span class="kt">long</span><span class="w"> </span><span class="kt">long</span></span>，轉換過程無溢位檢查。</p>
 <div class="versionchanged">
-<p><span class="versionmodified changed">在 3.14 版的變更: </span>Use <a class="reference internal" href="../reference/datamodel.html#object.__index__" title="object.__index__"><code class="xref py py-meth docutils literal notranslate"><span class="pre">__index__()</span></code></a> if available.</p>
+<p><span class="versionmodified changed">在 3.14 版的變更: </span>如有提供則使用 <a class="reference internal" href="../reference/datamodel.html#object.__index__" title="object.__index__"><code class="xref py py-meth docutils literal notranslate"><span class="pre">__index__()</span></code></a>。</p>
 </div>
 </dd>
 <dt><code class="docutils literal notranslate"><span class="pre">n</span></code> (<a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></a>) [<a class="reference internal" href="intro.html#c.Py_ssize_t" title="Py_ssize_t"><code class="xref c c-type docutils literal notranslate"><span class="pre">Py_ssize_t</span></code></a>]</dt><dd><p>將一個 Python 整數轉換成 C 的 <a class="reference internal" href="intro.html#c.Py_ssize_t" title="Py_ssize_t"><code class="xref c c-type docutils literal notranslate"><span class="pre">Py_ssize_t</span></code></a>。</p>
@@ -841,7 +841,7 @@ <h3><a href="../contents.html">目錄</a></h3>
     <ul>
 <li><a class="reference internal" href="#">剖析引數與建置數值</a><ul>
 <li><a class="reference internal" href="#parsing-arguments">剖析引數</a><ul>
-<li><a class="reference internal" href="#strings-and-buffers">Strings and buffers</a></li>
+<li><a class="reference internal" href="#strings-and-buffers">字串與緩衝區</a></li>
 <li><a class="reference internal" href="#numbers">數字</a></li>
 <li><a class="reference internal" href="#other-objects">其他物件</a></li>
 <li><a class="reference internal" href="#api-functions">API 函式</a></li>
@@ -954,7 +954,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/bool.html

@@ -334,7 +334,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/buffer.html

@@ -213,7 +213,7 @@ <h3>導航</h3>
 <ul class="simple" id="index-1">
 <li><p>on the producer side, a type can export a &quot;buffer interface&quot; which allows
 objects of that type to expose information about their underlying buffer.
-This interface is described in the section <a class="reference internal" href="typeobj.html#buffer-structs"><span class="std std-ref">Buffer Object Structures</span></a>; for
+This interface is described in the section <a class="reference internal" href="typeobj.html#buffer-structs"><span class="std std-ref">緩衝區物件結構</span></a>; for
 Python see <a class="reference internal" href="../reference/datamodel.html#python-buffer-protocol"><span class="std std-ref">Emulating buffer types</span></a>.</p></li>
 <li><p>on the consumer side, several means are available to obtain a pointer to
 the raw underlying data of an object (for example a method parameter). For
@@ -853,7 +853,7 @@ <h2>Buffer-related functions<a class="headerlink" href="#buffer-related-function
 <span class="kt"><span class="pre">int</span></span><span class="w"> </span><span class="sig-name descname"><span class="n"><span class="pre">PyObject_CopyData</span></span></span><span class="sig-paren">(</span><a class="reference internal" href="structures.html#c.PyObject" title="PyObject"><span class="n"><span class="pre">PyObject</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">dest</span></span>, <a class="reference internal" href="structures.html#c.PyObject" title="PyObject"><span class="n"><span class="pre">PyObject</span></span></a><span class="w"> </span><span class="p"><span class="pre">*</span></span><span class="n"><span class="pre">src</span></span><span class="sig-paren">)</span><a class="headerlink" href="#c.PyObject_CopyData" title="連結到這個定義">¶</a><br /></dt>
 <dd><em class="stableabi"> 為 <a class="reference internal" href="stable.html#stable"><span class="std std-ref">穩定 ABI 的一部分</span></a> 自 3.11 版本開始.</em><p>Copy data from <em>src</em> to <em>dest</em> buffer. Can convert between C-style and
 or Fortran-style buffers.</p>
-<p><code class="docutils literal notranslate"><span class="pre">0</span></code> is returned on success, <code class="docutils literal notranslate"><span class="pre">-1</span></code> on error.</p>
+<p>成功時回傳 <code class="docutils literal notranslate"><span class="pre">0</span></code>，錯誤時回傳 <code class="docutils literal notranslate"><span class="pre">-1</span></code>。</p>
 </dd></dl>
 
 <dl class="c function">
@@ -1016,7 +1016,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 25, 2025 (00:20 UTC)。
+      最後更新於 10月 25, 2025 (22:15 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？