Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit52277b8

Browse files
authored
Merge branch 'python:3.12' into string-meetup1125
2 parentsf59bce3 +3d1b20d commit52277b8

38 files changed

+3320
-3174
lines changed

‎.scripts/summarize_progress/main.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ def get_github_issues() -> list:
7777
match=re.search("(?P<dirname>[^\s`][a-zA-z-]+)/(?P<filename>[a-zA-Z0-9._-]+(.po)?)",title)
7878
ifnotmatch:
7979
continue
80-
80+
8181
dirname,filename=match.group('dirname','filename')
8282
ifnotfilename.endswith('.po'):
8383
filename+='.po'
@@ -98,7 +98,7 @@ def format_line_directory(dirname: str) -> str:
9898
issue_list=get_github_issues()
9999

100100
'''
101-
Search all the po file in the directory,
101+
Search all the po file in the directory,
102102
and record the translation progress of each files.
103103
'''
104104
BASE_DIR=Path("../")

‎Makefile‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,14 +69,16 @@ $(VENV)/bin/activate:
6969
$(VENV)/bin/sphinx-build:$(VENV)/bin/activate
7070
.$(VENV)/bin/activate; python3 -m pip install sphinx python-docs-theme
7171

72+
$(VENV)/bin/sphinx-lint:$(VENV)/bin/activate
73+
.$(VENV)/bin/activate; python3 -m pip install sphinx-lint
7274

7375
$(VENV)/bin/blurb:$(VENV)/bin/activate
7476
.$(VENV)/bin/activate; python3 -m pip install blurb
7577

7678

7779
.PHONY: upgrade_venv
7880
upgrade_venv:$(VENV)/bin/activate## Upgrade the venv that compiles the doc
79-
.$(VENV)/bin/activate; python3 -m pip install --upgrade sphinx python-docs-theme blurb
81+
.$(VENV)/bin/activate; python3 -m pip install --upgrade sphinx python-docs-theme blurb sphinx-lint
8082

8183

8284
.PHONY: progress
@@ -127,3 +129,7 @@ fuzzy: ## Find fuzzy strings
127129
.PHONY: rm_cpython
128130
rm_cpython:## Remove cloned cpython repo
129131
rm -rf$(CPYTHON_CLONE)
132+
133+
.PHONY: lint
134+
lint:$(VENV)/bin/sphinx-lint## Run sphinx-lint
135+
$(VENV)/bin/sphinx-lint --enable default-role

‎README.rst‎

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ the PSF for inclusion in the documentation.
123123
.. _GitHub Flow:https://guides.github.com/introduction/flow/
124124

125125
首先，`新增一個 issue<https://github.com/python/python-docs-zh-tw/issues>`_\
126-
，如：「翻譯 tutorial/introduction.po」，讓大家知道你正在翻譯這個檔案。可以使用 `make todo` 列出尚待翻譯的檔案。
126+
，如：「翻譯 tutorial/introduction.po」，讓大家知道你正在翻譯這個檔案。可以使用 ``make todo`` 列出尚待翻譯的檔案。
127127

128128
接著在 terminal 裡按照以下步驟：
129129

@@ -138,12 +138,18 @@ the PSF for inclusion in the documentation.
138138

139139
poedit glossary.po
140140

141-
3. 存檔以後，執行以下列指令編譯輸出文件，以確保你的修改沒有rST 的語法錯誤或警告 ::
141+
3. 存檔以後，執行以下列指令編譯輸出完整文件，以確保你的修改沒有reST 的語法錯誤或警告 ::
142142

143143
VERSION=3.12 make all
144144

145+
或者只想快速檢查是否有 reST 語法錯誤 ::
146+
147+
VERSION=3.12 make lint
148+
149+
確保輸出中沒有任何關於正在翻譯的檔案的警告訊息。
150+
145151
如果你還沒有執行 `維護、預覽`_ 的 clone CPython 的動作，此指令會自動幫你 clone CPython，\
146-
並且會使用 Sphinx 幫你檢查rST 語法錯誤，我們盡量保持沒有 warning \
152+
並且會使用 Sphinx 幫你檢查reST 語法錯誤，我們盡量保持沒有 warning \
147153
的狀態，因此如果有出現 warning 的話請修復它。另外也記得檢查是否符合\
148154
`翻譯守則`_
149155

@@ -252,11 +258,11 @@ po 檔皆為首要的翻譯對象。你也可以幫忙校對已經翻譯過的
252258
- 在本情況使用 ``zip(*[iter(x)]*n)`` 是很常見的情況（Python 慣例）。
253259
- 在超文件標示語言 (HTML) 中應注意跳脫符號。
254260

255-
rST 語法注意事項
261+
reST 語法注意事項
256262
----------------
257263

258-
- ``:xxx:`...``` 即為rST 的語法，應該在譯文中保留。
259-
-rST 諸多語法需要保留前後的空白。在中文裡，該空白可以用:literal:`\\\\`
264+
- ``:xxx:`...``` 即為reST 的語法，應該在譯文中保留。
265+
-reST 諸多語法需要保留前後的空白。在中文裡，該空白可以用:literal:`\\\\`
260266
來取代，製造一個沒有寬度的分隔符號。
261267

262268
例如：
@@ -322,8 +328,8 @@ rST 語法注意事項
322328
術語表 Glossary
323329
===============
324330

325-
為了讓翻譯保持統一，我們整理了一份`術語列表
326-
<https://github.com/python/python-docs-zh-tw/wiki/%E8%A1%93%E8%AA%9E%E5%88%97%E8%A1%A8>`_ \
331+
為了讓翻譯保持統一，我們整理了一份\
332+
`術語列表<https://github.com/python/python-docs-zh-tw/wiki/%E8%A1%93%E8%AA%9E%E5%88%97%E8%A1%A8>`_ \
327333
如果翻譯過程中你覺得需要術語列表有所缺漏，請至 `Discussion \
328334
<https://github.com/python/python-docs-zh-tw/discussions>`_ 開啟新的討論補充術語。\
329335
新增的術語，將會於每次 Sprint 中共同討論是否合併進術語列表。

‎c-api/function.po‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ msgid ""
1010
msgstr ""
1111
"Project-Id-Version:Python 3.12\n"
1212
"Report-Msgid-Bugs-To:\n"
13-
"POT-Creation-Date:2023-07-17 17:39+0800\n"
13+
"POT-Creation-Date:2023-12-07 00:03+0000\n"
1414
"PO-Revision-Date:2022-11-12 15:45+0800\n"
1515
"Last-Translator:Matt Wang <mattwang44@gmail.com>\n"
1616
"Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -66,22 +66,24 @@ msgid ""
6666
"The function's docstring and name are retrieved from the code object. "
6767
"*__module__* is retrieved from *globals*. The argument defaults, annotations "
6868
"and closure are set to ``NULL``. *__qualname__* is set to the same value as "
69-
"the code object's``co_qualname`` field."
69+
"the code object's:attr:`~codeobject.co_qualname` field."
7070
msgstr""
7171
"函式的文件字串 (docstring) 和名稱是從程式碼物件所取得，*__module__* 是自 "
7272
"*globals* 所取得。引數預設值、標註 (annotation) 和閉包 (closure) 被設為 "
73-
"``NULL``，*__qualname__* 被設為和程式碼物件 ``co_qualname`` 欄位相同的值。"
73+
"``NULL``，*__qualname__* 被設為和程式碼物件 :attr:`~codeobject.co_qualname` "
74+
"欄位相同的值。"
7475

7576
#:../../c-api/function.rst:45
7677
msgid""
7778
"As :c:func:`PyFunction_New`, but also allows setting the function object's "
7879
"``__qualname__`` attribute. *qualname* should be a unicode object or "
7980
"``NULL``; if ``NULL``, the ``__qualname__`` attribute is set to the same "
80-
"value as the code object's``co_qualname`` field."
81+
"value as the code object's:attr:`~codeobject.co_qualname` field."
8182
msgstr""
8283
"和 :c:func:`PyFunction_New` 相似，但也允許函式物件 ``__qualname__`` 屬性的設"
8384
"定，*qualname* 應為一個 unicode 物件或是 ``NULL``；如為 ``NULL``，"
84-
"``__qualname__`` 屬性會被設為與程式碼物件 ``co_qualname`` 欄位相同的值。"
85+
"``__qualname__`` 屬性會被設為與程式碼物件 :attr:`~codeobject.co_qualname` 欄"
86+
"位相同的值。"
8587

8688
#:../../c-api/function.rst:55
8789
msgid"Return the code object associated with the function object *op*."

‎c-api/import.po‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version:Python 3.12\n"
1010
"Report-Msgid-Bugs-To:\n"
11-
"POT-Creation-Date:2023-07-29 00:03+0000\n"
11+
"POT-Creation-Date:2023-12-07 00:03+0000\n"
1212
"PO-Revision-Date:2018-05-23 14:06+0000\n"
1313
"Last-Translator:Adrian Liaw <adrianliaw2000@gmail.com>\n"
1414
"Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -154,7 +154,8 @@ msgstr ""
154154
#:../../c-api/import.rst:140
155155
msgid""
156156
"The module's :attr:`__file__` attribute will be set to the code object's :"
157-
"attr:`!co_filename`. If applicable, :attr:`__cached__` will also be set."
157+
"attr:`~codeobject.co_filename`. If applicable, :attr:`__cached__` will also "
158+
"be set."
158159
msgstr""
159160

160161
#:../../c-api/import.rst:144

‎c-api/iterator.po‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,17 +31,19 @@ msgid ""
3131
"value, calling the callable for each item in the sequence, and ending the "
3232
"iteration when the sentinel value is returned."
3333
msgstr""
34-
"Python 提供了兩種通用的疊代器 (Iterator) 物件，第一種是序列 (sequence)。疊代"
35-
"器能夠與有支援 :meth:`~object.__getitem__`方法的任意序列使用，第二種是與可呼"
36-
"叫 (callable) 物件和哨兵值 (sentinel value) 一起使用，會呼叫序列中的每個可呼"
37-
"叫物件，當回傳哨兵值時就結束疊代。"
34+
"Python 提供了兩種通用的疊代器 (iterator) 物件，第一種是序列疊代器 (sequence"
35+
"iterator)，適用於支援 :meth:`~object.__getitem__`方法的任意序列，第二種是與"
36+
"可呼叫 (callable) 物件和哨兵值 (sentinel value) 一起使用，會呼叫序列中的每個"
37+
"可呼叫物件，當回傳哨兵值時就結束疊代。"
3838

3939
#:../../c-api/iterator.rst:17
4040
msgid""
4141
"Type object for iterator objects returned by :c:func:`PySeqIter_New` and the "
4242
"one-argument form of the :func:`iter` built-in function for built-in "
4343
"sequence types."
4444
msgstr""
45+
"此型別物件用於由 :c:func:`PySeqIter_New` 所回傳的疊代器物件以及用於內建序列型"
46+
"別的內建函式 :func:`iter` 的單引數形式。"
4547

4648
#:../../c-api/iterator.rst:24
4749
msgid""

‎c-api/typeobj.po‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version:Python 3.12\n"
99
"Report-Msgid-Bugs-To:\n"
10-
"POT-Creation-Date:2023-08-29 12:27+0000\n"
10+
"POT-Creation-Date:2023-12-07 00:03+0000\n"
1111
"PO-Revision-Date:2018-05-23 14:33+0000\n"
1212
"Last-Translator:Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -417,12 +417,13 @@ msgstr ":c:member:`~PyTypeObject.tp_dict`"
417417
#:../../c-api/typeobj.rst:0../../c-api/typeobj.rst:113
418418
#:../../c-api/typeobj.rst:132../../c-api/typeobj.rst:134
419419
#:../../c-api/typeobj.rst:136../../c-api/typeobj.rst:140
420-
#:../../c-api/typeobj.rst:341../../c-api/typeobj.rst:356
421-
#:../../c-api/typeobj.rst:368../../c-api/typeobj.rst:370
422-
#:../../c-api/typeobj.rst:381../../c-api/typeobj.rst:392
423-
#:../../c-api/typeobj.rst:404../../c-api/typeobj.rst:406
424-
#:../../c-api/typeobj.rst:412../../c-api/typeobj.rst:414
425-
#:../../c-api/typeobj.rst:416../../c-api/typeobj.rst:431
420+
#:../../c-api/typeobj.rst:341../../c-api/typeobj.rst:346
421+
#:../../c-api/typeobj.rst:356../../c-api/typeobj.rst:368
422+
#:../../c-api/typeobj.rst:370../../c-api/typeobj.rst:381
423+
#:../../c-api/typeobj.rst:392../../c-api/typeobj.rst:404
424+
#:../../c-api/typeobj.rst:406../../c-api/typeobj.rst:412
425+
#:../../c-api/typeobj.rst:414../../c-api/typeobj.rst:416
426+
#:../../c-api/typeobj.rst:429../../c-api/typeobj.rst:431
426427
#:../../c-api/typeobj.rst:435../../c-api/typeobj.rst:440
427428
#:../../c-api/typeobj.rst:446
428429
msgid":c:type:`PyObject` *"
@@ -533,8 +534,7 @@ msgid "[:c:member:`~PyTypeObject.tp_subclasses`]"
533534
msgstr"[:c:member:`~PyTypeObject.tp_subclasses`]"
534535

535536
#:../../c-api/typeobj.rst:0../../c-api/typeobj.rst:138
536-
#:../../c-api/typeobj.rst:279../../c-api/typeobj.rst:346
537-
#:../../c-api/typeobj.rst:348../../c-api/typeobj.rst:429
537+
#:../../c-api/typeobj.rst:279../../c-api/typeobj.rst:348
538538
msgid"void *"
539539
msgstr"void *"
540540

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp