Skip to content

Commit eee5cad

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ cb35f7e 🚀
1 parent 5f10495 commit eee5cad

File tree

555 files changed

+1174
-1135
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

555 files changed

+1174
-1135
lines changed

Diff for: ‎.buildinfo

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

Diff for: ‎_sources/about.rst.txt

+8-7
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
1-
=====================
2-
About these documents
3-
=====================
1+
========================
2+
About this documentation
3+
========================
44

55

6-
These documents are generated from `reStructuredText`_ sources by `Sphinx`_, a
7-
document processor specifically written for the Python documentation.
6+
Python's documentation is generated from `reStructuredText`_ sources
7+
using `Sphinx`_, a documentation generator originally created for Python
8+
and now maintained as an independent project.
89

910
.. _reStructuredText: https://docutils.sourceforge.io/rst.html
1011
.. _Sphinx: https://www.sphinx-doc.org/
@@ -20,14 +21,14 @@ volunteers are always welcome!
2021
Many thanks go to:
2122

2223
* Fred L. Drake, Jr., the creator of the original Python documentation toolset
23-
and writer of much of the content;
24+
and author of much of the content;
2425
* the `Docutils <https://docutils.sourceforge.io/>`_ project for creating
2526
reStructuredText and the Docutils suite;
2627
* Fredrik Lundh for his Alternative Python Reference project from which Sphinx
2728
got many good ideas.
2829

2930

30-
Contributors to the Python Documentation
31+
Contributors to the Python documentation
3132
----------------------------------------
3233

3334
Many people have contributed to the Python language, the Python standard

Diff for: ‎_sources/library/calendar.rst.txt

+8
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,14 @@ interpreted as prescribed by the ISO 8601 standard. Year 0 is 1 BC, year -1 is
138138

139139
:class:`TextCalendar` instances have the following methods:
140140

141+
.. method:: formatweek(theweek, w=0)
142+
143+
Return a single week in a string with no newline. If *w* is provided, it
144+
specifies the width of the date columns, which are centered. Depends
145+
on the first weekday as specified in the constructor or set by the
146+
:meth:`setfirstweekday` method.
147+
148+
141149
.. method:: formatmonth(theyear, themonth, w=0, l=0)
142150

143151
Return a month's calendar in a multi-line string. If *w* is provided, it

Diff for: ‎about.html

+17-14
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<meta charset="utf-8" />
66
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
77

8-
<title>關於這些說明文件 &#8212; Python 3.13.1 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
8+
<title>About this documentation &#8212; Python 3.13.1 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
99

1010
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=80d5e7a1" />
1111
<link rel="stylesheet" type="text/css" href="_static/pydoctheme.css?v=08c2cdb3" />
@@ -89,8 +89,8 @@
8989
<div>
9090
<h3><a href="contents.html">目錄</a></h3>
9191
<ul>
92-
<li><a class="reference internal" href="#">關於這些說明文件</a><ul>
93-
<li><a class="reference internal" href="#contributors-to-the-python-documentation">Python 文件的貢獻者們</a></li>
92+
<li><a class="reference internal" href="#">About this documentation</a><ul>
93+
<li><a class="reference internal" href="#contributors-to-the-python-documentation">Contributors to the Python documentation</a></li>
9494
</ul>
9595
</li>
9696
</ul>
@@ -151,7 +151,7 @@ <h3>瀏覽</h3>
151151
<a href="index.html">3.13.1 Documentation</a> &#187;
152152
</li>
153153

154-
<li class="nav-item nav-item-this"><a href="">關於這些說明文件</a></li>
154+
<li class="nav-item nav-item-this"><a href="">About this documentation</a></li>
155155
<li class="right">
156156

157157

@@ -181,18 +181,21 @@ <h3>瀏覽</h3>
181181
<div class="bodywrapper">
182182
<div class="body" role="main">
183183

184-
<section id="about-these-documents">
185-
<h1>關於這些說明文件<a class="headerlink" href="#about-these-documents" title="連結到這個標頭"></a></h1>
186-
<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>
184+
<section id="about-this-documentation">
185+
<h1>About this documentation<a class="headerlink" href="#about-this-documentation" title="連結到這個標頭"></a></h1>
186+
<p>Python's documentation is generated from <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a> sources
187+
using <a class="reference external" href="https://www.sphinx-doc.org/">Sphinx</a>, a documentation generator originally created for Python
188+
and now maintained as an independent project.</p>
187189
<p>如同 Python 自身，透過自願者的努力下產出文件與封裝後自動化執行工具。若想要回報臭蟲，請見 <a class="reference internal" href="bugs.html#reporting-bugs"><span class="std std-ref">處理錯誤 (Bug)</span></a> 頁面，內含相關資訊。我們永遠歡迎新的自願者加入！</p>
188190
<p>致謝：</p>
189191
<ul class="simple">
190-
<li><p>Fred L. Drake, Jr.，原始 Python 文件工具集的創造者以及一大部份內容的作者；</p></li>
192+
<li><p>Fred L. Drake, Jr., the creator of the original Python documentation toolset
193+
and author of much of the content;</p></li>
191194
<li><p>創造 reStructuredText 和 Docutils 工具組的 <a class="reference external" href="https://docutils.sourceforge.io/">Docutils</a> 專案；</p></li>
192195
<li><p>Fredrik Lundh 先生，Sphinx 從他的 Alternative Python Reference 計劃中獲得許多的好主意。</p></li>
193196
</ul>
194197
<section id="contributors-to-the-python-documentation">
195-
<h2>Python 文件的貢獻者們<a class="headerlink" href="#contributors-to-the-python-documentation" title="連結到這個標頭"></a></h2>
198+
<h2>Contributors to the Python documentation<a class="headerlink" href="#contributors-to-the-python-documentation" title="連結到這個標頭"></a></h2>
196199
<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>
197200
<p>正因為 Python 社群的撰寫與貢獻才有這份這麼棒的說明文件 -- 感謝所有貢獻過的人們！</p>
198201
</section>
@@ -208,8 +211,8 @@ <h2>Python 文件的貢獻者們<a class="headerlink" href="#contributors-to-the
208211
<div>
209212
<h3><a href="contents.html">目錄</a></h3>
210213
<ul>
211-
<li><a class="reference internal" href="#">關於這些說明文件</a><ul>
212-
<li><a class="reference internal" href="#contributors-to-the-python-documentation">Python 文件的貢獻者們</a></li>
214+
<li><a class="reference internal" href="#">About this documentation</a><ul>
215+
<li><a class="reference internal" href="#contributors-to-the-python-documentation">Contributors to the Python documentation</a></li>
213216
</ul>
214217
</li>
215218
</ul>
@@ -273,7 +276,7 @@ <h3>瀏覽</h3>
273276
<a href="index.html">3.13.1 Documentation</a> &#187;
274277
</li>
275278

276-
<li class="nav-item nav-item-this"><a href="">關於這些說明文件</a></li>
279+
<li class="nav-item nav-item-this"><a href="">About this documentation</a></li>
277280
<li class="right">
278281

279282

@@ -304,7 +307,7 @@ <h3>瀏覽</h3>
304307
版權
305308

306309
</a>
307-
2001-2024, Python Software Foundation.
310+
2001-2025, Python Software Foundation.
308311
<br />
309312
This page is licensed under the Python Software Foundation License Version 2.
310313
<br />
@@ -320,7 +323,7 @@ <h3>瀏覽</h3>
320323
<a href="https://www.python.org/psf/donations/">Please donate.</a>
321324
<br />
322325
<br />
323-
最後更新於 12月 29, 2024 (16:06 UTC)。
326+
最後更新於 1月 01, 2025 (12:00 UTC)。
324327

325328
<a href="/bugs.html">Found a bug</a>?
326329

Diff for: ‎bugs.html

+8-8
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<link rel="search" title="搜尋" href="search.html" />
2828
<link rel="copyright" title="版權" href="copyright.html" />
2929
<link rel="next" title="版權宣告" href="copyright.html" />
30-
<link rel="prev" title="關於這些說明文件" href="about.html" />
30+
<link rel="prev" title="About this documentation" href="about.html" />
3131

3232
<link rel="canonical" href="https://docs.python.org/3/bugs.html" />
3333

@@ -101,7 +101,7 @@ <h3><a href="contents.html">目錄</a></h3>
101101
<div>
102102
<h4>上個主題</h4>
103103
<p class="topless"><a href="about.html"
104-
title="上一章">關於這些說明文件</a></p>
104+
title="上一章">About this documentation</a></p>
105105
</div>
106106
<div>
107107
<h4>下個主題</h4>
@@ -137,7 +137,7 @@ <h3>瀏覽</h3>
137137
<a href="copyright.html" title="版權宣告"
138138
accesskey="N">下一頁</a> |</li>
139139
<li class="right" >
140-
<a href="about.html" title="關於這些說明文件"
140+
<a href="about.html" title="About this documentation"
141141
accesskey="P">上一頁</a> |</li>
142142

143143
<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=
231231
</section>
232232
<section id="getting-started-contributing-to-python-yourself">
233233
<span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭"></a></h2>
234-
<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>
234+
<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>
235235
</section>
236236
</section>
237237

@@ -257,7 +257,7 @@ <h3><a href="contents.html">目錄</a></h3>
257257
<div>
258258
<h4>上個主題</h4>
259259
<p class="topless"><a href="about.html"
260-
title="上一章">關於這些說明文件</a></p>
260+
title="上一章">About this documentation</a></p>
261261
</div>
262262
<div>
263263
<h4>下個主題</h4>
@@ -296,7 +296,7 @@ <h3>瀏覽</h3>
296296
<a href="copyright.html" title="版權宣告"
297297
>下一頁</a> |</li>
298298
<li class="right" >
299-
<a href="about.html" title="關於這些說明文件"
299+
<a href="about.html" title="About this documentation"
300300
>上一頁</a> |</li>
301301

302302
<li><img src="_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
@@ -343,7 +343,7 @@ <h3>瀏覽</h3>
343343
版權
344344

345345
</a>
346-
2001-2024, Python Software Foundation.
346+
2001-2025, Python Software Foundation.
347347
<br />
348348
This page is licensed under the Python Software Foundation License Version 2.
349349
<br />
@@ -359,7 +359,7 @@ <h3>瀏覽</h3>
359359
<a href="https://www.python.org/psf/donations/">Please donate.</a>
360360
<br />
361361
<br />
362-
最後更新於 12月 29, 2024 (16:06 UTC)。
362+
最後更新於 1月 01, 2025 (12:00 UTC)。
363363

364364
<a href="/bugs.html">Found a bug</a>?
365365

Diff for: ‎c-api/abstract.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -313,7 +313,7 @@ <h3>瀏覽</h3>
313313
版權
314314

315315
</a>
316-
2001-2024, Python Software Foundation.
316+
2001-2025, Python Software Foundation.
317317
<br />
318318
This page is licensed under the Python Software Foundation License Version 2.
319319
<br />
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
329329
<a href="https://www.python.org/psf/donations/">Please donate.</a>
330330
<br />
331331
<br />
332-
最後更新於 12月 29, 2024 (16:06 UTC)。
332+
最後更新於 1月 01, 2025 (12:00 UTC)。
333333

334334
<a href="/bugs.html">Found a bug</a>?
335335

Diff for: ‎c-api/allocation.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,7 @@ <h3>瀏覽</h3>
328328
版權
329329

330330
</a>
331-
2001-2024, Python Software Foundation.
331+
2001-2025, Python Software Foundation.
332332
<br />
333333
This page is licensed under the Python Software Foundation License Version 2.
334334
<br />
@@ -344,7 +344,7 @@ <h3>瀏覽</h3>
344344
<a href="https://www.python.org/psf/donations/">Please donate.</a>
345345
<br />
346346
<br />
347-
最後更新於 12月 29, 2024 (16:06 UTC)。
347+
最後更新於 1月 01, 2025 (12:00 UTC)。
348348

349349
<a href="/bugs.html">Found a bug</a>?
350350

Diff for: ‎c-api/apiabiversion.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -360,7 +360,7 @@ <h3>瀏覽</h3>
360360
版權
361361

362362
</a>
363-
2001-2024, Python Software Foundation.
363+
2001-2025, Python Software Foundation.
364364
<br />
365365
This page is licensed under the Python Software Foundation License Version 2.
366366
<br />
@@ -376,7 +376,7 @@ <h3>瀏覽</h3>
376376
<a href="https://www.python.org/psf/donations/">Please donate.</a>
377377
<br />
378378
<br />
379-
最後更新於 12月 29, 2024 (16:06 UTC)。
379+
最後更新於 1月 01, 2025 (12:00 UTC)。
380380

381381
<a href="/bugs.html">Found a bug</a>?
382382

Diff for: ‎c-api/arg.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -908,7 +908,7 @@ <h3>瀏覽</h3>
908908
版權
909909

910910
</a>
911-
2001-2024, Python Software Foundation.
911+
2001-2025, Python Software Foundation.
912912
<br />
913913
This page is licensed under the Python Software Foundation License Version 2.
914914
<br />
@@ -924,7 +924,7 @@ <h3>瀏覽</h3>
924924
<a href="https://www.python.org/psf/donations/">Please donate.</a>
925925
<br />
926926
<br />
927-
最後更新於 12月 29, 2024 (16:06 UTC)。
927+
最後更新於 1月 01, 2025 (12:00 UTC)。
928928

929929
<a href="/bugs.html">Found a bug</a>?
930930

Diff for: ‎c-api/bool.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -325,7 +325,7 @@ <h3>瀏覽</h3>
325325
版權
326326

327327
</a>
328-
2001-2024, Python Software Foundation.
328+
2001-2025, Python Software Foundation.
329329
<br />
330330
This page is licensed under the Python Software Foundation License Version 2.
331331
<br />
@@ -341,7 +341,7 @@ <h3>瀏覽</h3>
341341
<a href="https://www.python.org/psf/donations/">Please donate.</a>
342342
<br />
343343
<br />
344-
最後更新於 12月 29, 2024 (16:06 UTC)。
344+
最後更新於 1月 01, 2025 (12:00 UTC)。
345345

346346
<a href="/bugs.html">Found a bug</a>?
347347

Diff for: ‎c-api/buffer.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -1000,7 +1000,7 @@ <h3>瀏覽</h3>
10001000
版權
10011001

10021002
</a>
1003-
2001-2024, Python Software Foundation.
1003+
2001-2025, Python Software Foundation.
10041004
<br />
10051005
This page is licensed under the Python Software Foundation License Version 2.
10061006
<br />
@@ -1016,7 +1016,7 @@ <h3>瀏覽</h3>
10161016
<a href="https://www.python.org/psf/donations/">Please donate.</a>
10171017
<br />
10181018
<br />
1019-
最後更新於 12月 29, 2024 (16:06 UTC)。
1019+
最後更新於 1月 01, 2025 (12:00 UTC)。
10201020

10211021
<a href="/bugs.html">Found a bug</a>?
10221022

Diff for: ‎c-api/bytearray.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -384,7 +384,7 @@ <h3>瀏覽</h3>
384384
版權
385385

386386
</a>
387-
2001-2024, Python Software Foundation.
387+
2001-2025, Python Software Foundation.
388388
<br />
389389
This page is licensed under the Python Software Foundation License Version 2.
390390
<br />
@@ -400,7 +400,7 @@ <h3>瀏覽</h3>
400400
<a href="https://www.python.org/psf/donations/">Please donate.</a>
401401
<br />
402402
<br />
403-
最後更新於 12月 29, 2024 (16:06 UTC)。
403+
最後更新於 1月 01, 2025 (12:00 UTC)。
404404

405405
<a href="/bugs.html">Found a bug</a>?
406406

Diff for: ‎c-api/bytes.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -505,7 +505,7 @@ <h3>瀏覽</h3>
505505
版權
506506

507507
</a>
508-
2001-2024, Python Software Foundation.
508+
2001-2025, Python Software Foundation.
509509
<br />
510510
This page is licensed under the Python Software Foundation License Version 2.
511511
<br />
@@ -521,7 +521,7 @@ <h3>瀏覽</h3>
521521
<a href="https://www.python.org/psf/donations/">Please donate.</a>
522522
<br />
523523
<br />
524-
最後更新於 12月 29, 2024 (16:06 UTC)。
524+
最後更新於 1月 01, 2025 (12:00 UTC)。
525525

526526
<a href="/bugs.html">Found a bug</a>?
527527

Diff for: ‎c-api/call.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -636,7 +636,7 @@ <h3>瀏覽</h3>
636636
版權
637637

638638
</a>
639-
2001-2024, Python Software Foundation.
639+
2001-2025, Python Software Foundation.
640640
<br />
641641
This page is licensed under the Python Software Foundation License Version 2.
642642
<br />
@@ -652,7 +652,7 @@ <h3>瀏覽</h3>
652652
<a href="https://www.python.org/psf/donations/">Please donate.</a>
653653
<br />
654654
<br />
655-
最後更新於 12月 29, 2024 (16:06 UTC)。
655+
最後更新於 1月 01, 2025 (12:00 UTC)。
656656

657657
<a href="/bugs.html">Found a bug</a>?
658658

0 commit comments

Comments
 (0)