Deploying to gh-pages from @ cb35f7e 🚀

.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 1b44886422cbc702b5b11fb043c64e25
+config: 6cf0775369be5d8a262285b94041e119
 tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/about.rst.txt

@@ -1,10 +1,11 @@
-=====================
-About these documents
-=====================
+========================
+About this documentation
+========================
 
 
-These documents are generated from `reStructuredText`_ sources by `Sphinx`_, a
-document processor specifically written for the Python documentation.
+Python's documentation is generated from `reStructuredText`_ sources
+using `Sphinx`_, a documentation generator originally created for Python
+and now maintained as an independent project.
 
 .. _reStructuredText: https://docutils.sourceforge.io/rst.html
 .. _Sphinx: https://www.sphinx-doc.org/
@@ -20,14 +21,14 @@ volunteers are always welcome!
 Many thanks go to:
 
 * Fred L. Drake, Jr., the creator of the original Python documentation toolset
-  and writer of much of the content;
+  and author of much of the content;
 * the `Docutils <https://docutils.sourceforge.io/>`_ project for creating
   reStructuredText and the Docutils suite;
 * Fredrik Lundh for his Alternative Python Reference project from which Sphinx
   got many good ideas.
 
 
-Contributors to the Python Documentation
+Contributors to the Python documentation
 ----------------------------------------
 
 Many people have contributed to the Python language, the Python standard

_sources/library/calendar.rst.txt

@@ -138,6 +138,14 @@ interpreted as prescribed by the ISO 8601 standard.  Year 0 is 1 BC, year -1 is
 
    :class:`TextCalendar` instances have the following methods:
 
+   .. method:: formatweek(theweek, w=0)
+
+      Return a single week in a string with no newline. If *w* is provided, it
+      specifies the width of the date columns, which are centered. Depends
+      on the first weekday as specified in the constructor or set by the
+      :meth:`setfirstweekday` method.
+
+
    .. method:: formatmonth(theyear, themonth, w=0, l=0)
 
       Return a month's calendar in a multi-line string. If *w* is provided, it

about.html

@@ -5,7 +5,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>關於這些說明文件 &#8212; Python 3.13.1 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>About this documentation &#8212; Python 3.13.1 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
 
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=80d5e7a1" />
     <link rel="stylesheet" type="text/css" href="_static/pydoctheme.css?v=08c2cdb3" />
@@ -89,8 +89,8 @@
   <div>
     <h3><a href="contents.html">目錄</a></h3>
     <ul>
-<li><a class="reference internal" href="#">關於這些說明文件</a><ul>
-<li><a class="reference internal" href="#contributors-to-the-python-documentation">Python 文件的貢獻者們</a></li>
+<li><a class="reference internal" href="#">About this documentation</a><ul>
+<li><a class="reference internal" href="#contributors-to-the-python-documentation">Contributors to the Python documentation</a></li>
 </ul>
 </li>
 </ul>
@@ -151,7 +151,7 @@ <h3>瀏覽</h3>
       <a href="index.html">3.13.1 Documentation</a> &#187;
     </li>
 
-        <li class="nav-item nav-item-this"><a href="">關於這些說明文件</a></li>
+        <li class="nav-item nav-item-this"><a href="">About this documentation</a></li>
                 <li class="right">
 
 
@@ -181,18 +181,21 @@ <h3>瀏覽</h3>
         <div class="bodywrapper">
           <div class="body" role="main">
 
-  <section id="about-these-documents">
-<h1>關於這些說明文件<a class="headerlink" href="#about-these-documents" title="連結到這個標頭">¶</a></h1>
-<p>這些說明文件是透過 <a class="reference external" href="https://www.sphinx-doc.org/">Sphinx</a> （一個專為 Python 說明文件所撰寫的文件處理器）將使用 <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a> 撰寫的原始檔轉換而成。</p>
+  <section id="about-this-documentation">
+<h1>About this documentation<a class="headerlink" href="#about-this-documentation" title="連結到這個標頭">¶</a></h1>
+<p>Python's documentation is generated from <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a> sources
+using <a class="reference external" href="https://www.sphinx-doc.org/">Sphinx</a>, a documentation generator originally created for Python
+and now maintained as an independent project.</p>
 <p>如同 Python 自身，透過自願者的努力下產出文件與封裝後自動化執行工具。若想要回報臭蟲，請見 <a class="reference internal" href="bugs.html#reporting-bugs"><span class="std std-ref">處理錯誤 (Bug)</span></a> 頁面，內含相關資訊。我們永遠歡迎新的自願者加入！</p>
 <p>致謝：</p>
 <ul class="simple">
-<li><p>Fred L. Drake, Jr.，原始 Python 文件工具集的創造者以及一大部份內容的作者；</p></li>
+<li><p>Fred L. Drake, Jr., the creator of the original Python documentation toolset
+and author of much of the content;</p></li>
 <li><p>創造 reStructuredText 和 Docutils 工具組的 <a class="reference external" href="https://docutils.sourceforge.io/">Docutils</a> 專案；</p></li>
 <li><p>Fredrik Lundh 先生，Sphinx 從他的 Alternative Python Reference 計劃中獲得許多的好主意。</p></li>
 </ul>
 <section id="contributors-to-the-python-documentation">
-<h2>Python 文件的貢獻者們<a class="headerlink" href="#contributors-to-the-python-documentation" title="連結到這個標頭">¶</a></h2>
+<h2>Contributors to the Python documentation<a class="headerlink" href="#contributors-to-the-python-documentation" title="連結到這個標頭">¶</a></h2>
 <p>許多人都曾為 Python 這門語言、Python 標準函式庫和 Python 說明文件貢獻過。Python 所發佈的原始碼中含有部份貢獻者的清單，請見 <a class="extlink-source reference external" href="https://github.com/python/cpython/tree/3.13/Misc/ACKS">Misc/ACKS</a> 。</p>
 <p>正因為 Python 社群的撰寫與貢獻才有這份這麼棒的說明文件 -- 感謝所有貢獻過的人們！</p>
 </section>
@@ -208,8 +211,8 @@ <h2>Python 文件的貢獻者們<a class="headerlink" href="#contributors-to-the
   <div>
     <h3><a href="contents.html">目錄</a></h3>
     <ul>
-<li><a class="reference internal" href="#">關於這些說明文件</a><ul>
-<li><a class="reference internal" href="#contributors-to-the-python-documentation">Python 文件的貢獻者們</a></li>
+<li><a class="reference internal" href="#">About this documentation</a><ul>
+<li><a class="reference internal" href="#contributors-to-the-python-documentation">Contributors to the Python documentation</a></li>
 </ul>
 </li>
 </ul>
@@ -273,7 +276,7 @@ <h3>瀏覽</h3>
       <a href="index.html">3.13.1 Documentation</a> &#187;
     </li>
 
-        <li class="nav-item nav-item-this"><a href="">關於這些說明文件</a></li>
+        <li class="nav-item nav-item-this"><a href="">About this documentation</a></li>
                 <li class="right">
 
 
@@ -304,7 +307,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -320,7 +323,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

bugs.html

@@ -27,7 +27,7 @@
     <link rel="search" title="搜尋" href="search.html" />
     <link rel="copyright" title="版權" href="copyright.html" />
     <link rel="next" title="版權宣告" href="copyright.html" />
-    <link rel="prev" title="關於這些說明文件" href="about.html" />
+    <link rel="prev" title="About this documentation" href="about.html" />
 
     <link rel="canonical" href="https://docs.python.org/3/bugs.html" />
 
@@ -101,7 +101,7 @@ <h3><a href="contents.html">目錄</a></h3>
   <div>
     <h4>上個主題</h4>
     <p class="topless"><a href="about.html"
-                          title="上一章">關於這些說明文件</a></p>
+                          title="上一章">About this documentation</a></p>
   </div>
   <div>
     <h4>下個主題</h4>
@@ -137,7 +137,7 @@ <h3>瀏覽</h3>
           <a href="copyright.html" title="版權宣告"
              accesskey="N">下一頁</a> |</li>
         <li class="right" >
-          <a href="about.html" title="關於這些說明文件"
+          <a href="about.html" title="About this documentation"
              accesskey="P">上一頁</a> |</li>
 
           <li><img src="_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
@@ -231,7 +231,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://mail.python.org/mailman3/lists/core-mentorship.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://devguide.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
+<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>
 </section>
 </section>
 
@@ -257,7 +257,7 @@ <h3><a href="contents.html">目錄</a></h3>
   <div>
     <h4>上個主題</h4>
     <p class="topless"><a href="about.html"
-                          title="上一章">關於這些說明文件</a></p>
+                          title="上一章">About this documentation</a></p>
   </div>
   <div>
     <h4>下個主題</h4>
@@ -296,7 +296,7 @@ <h3>瀏覽</h3>
           <a href="copyright.html" title="版權宣告"
              >下一頁</a> |</li>
         <li class="right" >
-          <a href="about.html" title="關於這些說明文件"
+          <a href="about.html" title="About this documentation"
              >上一頁</a> |</li>
 
           <li><img src="_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
@@ -343,7 +343,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -359,7 +359,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/abstract.html

@@ -313,7 +313,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/allocation.html

@@ -328,7 +328,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -344,7 +344,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/apiabiversion.html

@@ -360,7 +360,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -376,7 +376,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/arg.html

@@ -908,7 +908,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -924,7 +924,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/bool.html

@@ -325,7 +325,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -341,7 +341,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/buffer.html

@@ -1000,7 +1000,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -1016,7 +1016,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/bytearray.html

@@ -384,7 +384,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -400,7 +400,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/bytes.html

@@ -505,7 +505,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -521,7 +521,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

c-api/call.html

@@ -636,7 +636,7 @@ <h3>瀏覽</h3>
     版權
 
       </a>
-     2001-2024, Python Software Foundation.
+     2001-2025, Python Software Foundation.
     <br />
     This page is licensed under the Python Software Foundation License Version 2.
     <br />
@@ -652,7 +652,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 12月 29, 2024 (16:06 UTC)。
+      最後更新於 1月 01, 2025 (12:00 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?