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

Commitf2f1d63

Browse files
authored
Merge branch 'python:3.9' into glossary
2 parents29cb707 +4edb0b4 commitf2f1d63

File tree

78 files changed

+3837
-2973
lines changed

Some content is hidden

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

78 files changed

+3837
-2973
lines changed

‎README.rst

Lines changed: 47 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Python 官方說明文件臺灣繁體中文翻譯計畫
88

99
這是 Python 3.9 官方說明文件的臺灣繁體中文（zh_TW）翻譯。
1010

11-
翻譯之前，請務必詳讀並同意\`授權與 License`_。參與方式請參考\`參加翻譯`_。
11+
翻譯之前，請務必詳讀並同意\`授權與 License`_。參與方式請參考\`參與翻譯`_。
1212

1313
您可以在 https://python.github.io/python-docs-zh-tw/ 瀏覽目前翻譯的成果。
1414

@@ -61,19 +61,26 @@ the PSF for inclusion in the documentation.
6161
您在對 PSF 送出說明文件貢獻的同時，即表示同意上述的協議。
6262

6363

64-
參加翻譯
64+
參與翻譯
6565
========
6666

67-
如何參加翻譯
67+
關於 po (Portable Object) 檔
68+
-----------------------------
69+
70+
此為所需翻譯的文字檔，副檔名為 ``.po``，不同語系就會有一個 po 檔。主要內容為翻譯的參考原始字串 (*msgid*)，\
71+
及需要填入的翻譯字串 (*msgstr*)。有時你會看到 ``#, fuzzy`` 的註記，它代表此翻譯字串需要校閱。
72+
73+
翻譯流程
6874
------------
6975

70-
**事先需要有：**
76+
事先需要有
77+
~~~~~~~~~~
7178

7279
- 一個 `GitHub 帳號<https://github.com/join>`_
7380
- `安裝好 git<https://help.github.com/articles/set-up-git/>`_\（Windows
7481
上請參考 https://gitforwindows.org/）
75-
- 一個 ``.po`` 檔的編輯器，如果還沒有的話請使用 `poedit<https://poedit.net>`_
76-
-MacOS 的使用者還需要先利用 `homebrew<https://brew.sh/index_zh-tw>`_ 安裝 gettext，屆時 Sphinx 會使用到。
82+
- 一個 ``.po`` 檔的編輯器。推薦使用 `Poedit<https://poedit.net>`_，若熟悉 po 檔用一般文字編輯器亦可。
83+
-macOS 的使用者還需要先利用 `homebrew<https://brew.sh/index_zh-tw>`_ 安裝 gettext，屆時 Sphinx 會使用到。
7784
..code-block::bash
7885
7986
brew install gettext
@@ -84,7 +91,10 @@ the PSF for inclusion in the documentation.
8491
按鈕），這樣會把整個專案複製一份到你的 GitHub 帳號底下，你可以對這個 fork
8592
進行修改。
8693

87-
在\**第一次貢獻以前**\（還沒有 clone 過），請在 terminal 裡依照以下步驟：
94+
第一次貢獻以前（還沒有 clone 過)
95+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
96+
97+
請在 terminal 裡依照以下步驟：
8898

8999
..code-block::bash
90100
@@ -97,7 +107,10 @@ the PSF for inclusion in the documentation.
97107
# 將 python/python-docs-zh-tw 設為 upstream remote
98108
git remote add upstream https://github.com/python/python-docs-zh-tw.git
99109
100-
在\**每一次翻譯時**\請遵照以下步驟（`GitHub Flow`_）：
110+
每一次翻譯時
111+
~~~~~~~~~~~~
112+
113+
請遵照以下步驟（`GitHub Flow`_）：
101114

102115
.. _GitHub Flow:https://guides.github.com/introduction/flow/
103116

@@ -106,27 +119,30 @@ the PSF for inclusion in the documentation.
106119

107120
接著在 terminal 裡按照以下步驟：
108121

109-
1. 基於最新版本的 ``upstream/3.9`` 開啟一個 branch，現在假設我們想要翻譯 Glossary
122+
1. 基於最新版本的 ``upstream/3.9`` 開啟一個 branch，現在假設我們想要翻譯 Glossary \
110123
所以把這個 branch 叫做 ``glossary`` ::
111124

112125
git fetch upstream
113126
git checkout -b glossary upstream/3.9
114127

115-
2. 接著就可以開始翻譯，你可以使用 Poedit應用程式將檔案打開，或是用以下指令\
116-
（翻譯不同檔案時將 glossary 換成別的檔名） ::
128+
2. 接著就可以開始翻譯（翻譯時可參考`翻譯守則`_），你可以手動開啟 Poedit應用程式再選檔案或用以下指令請 Poedit 將檔案\
129+
打開，翻譯不同檔案時將 glossary 換成別的檔名） ::
117130

118131
poedit glossary.po
119132

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

122135
make
123136

124-
這個過程中 Sphinx 會幫你檢查 rST 語法錯誤，我們盡量保持沒有 warning
137+
如果你還沒有執行 `維護、預覽`_ 的 clone CPython 的動作，此指令會自動幫你 clone CPython，\
138+
並且會使用 Sphinx 幫你檢查 rST 語法錯誤，我們盡量保持沒有 warning \
125139
的狀態，因此如果有出現 warning 的話請修復它。另外也記得檢查是否符合\
126140
`翻譯守則`_
127141

128-
4. 在瀏覽器中打開編譯出來的文件以確認整份文件的語意通暢\
129-
（翻譯別的檔案時將 glossary 換成別的檔名） ::
142+
4. 輸出的文件會被放置在您的本地端 CPython clone（見 `維護、預覽`_ 段落的圖示）\
143+
底下的 ``Doc/build/html``，切換到該目錄再使用 ``python3 -m http.server`` \
144+
或類似的靜態網頁伺服器即可以預覽成果。你可以執行下列指令請瀏覽器打開編譯出來的文件\
145+
以確認整份文件的語意通暢（翻譯別的檔案時將 glossary 換成別的檔名） ::
130146

131147
open ../cpython/Doc/build/html/glossary.html
132148

@@ -165,8 +181,10 @@ the PSF for inclusion in the documentation.
165181
要翻譯哪些東西
166182
--------------
167183

168-
最簡單的貢獻方式就是更新 *fuzzy entries*，讓翻譯的內容保持與最新版本的文件\
169-
同步。請參考 `尋找 fuzzy entries`_ 段落。
184+
主要是填入翻譯字串 (*msgid*) 以及更新有標記為 ``#, fuzzy`` 的字串。
185+
186+
其中最簡單的貢獻方式就是更新 *fuzzy entries*，讓曾經翻譯的內容保持與最新版本的文件\
187+
同步。請參考 `尋找有翻譯過但需校閱的 fuzzy entries`_ 段落。
170188

171189
此外，當前的目標為完成 **Tutorial** 的翻譯，因此在 ``tutorial/`` 底下的所有
172190
po 檔皆為首要的翻譯對象。您也可以幫忙校對已經翻譯過的內容。
@@ -344,7 +362,7 @@ type 型別
344362
幫助，則可以使用Telegram_。
345363

346364
.. _Issue:https://github.com/python-doc-tw/python-docs-zh-tw/issues
347-
.. _Telegram:https://t.me/PyDocT
365+
.. _Telegram:https://t.me/PyDocTW
348366

349367
另外，此翻譯的 coordinator 為 `adrianliaw<https://github.com/adrianliaw>`_，\
350368
您也可以透過此 email 聯繫：``adrianliaw2000 at gmail dot com``。
@@ -382,36 +400,28 @@ type 型別
382400
這樣可以避免下載完整的 commit 歷史（對輸出文件沒什麼幫助），但仍然能把所有的
383401
branch clone 下來。
384402

385-
與 CPython 同步最新的 pot 檔
386-
----------------------------
403+
與 CPython 同步最新的 pot 檔 (目前由 GitHub Actions 定時代為執行)
404+
----------------------------------------------------------
405+
406+
pot 檔為翻譯的樣板檔案，它包含需要翻譯的原始字串 (*msgid*) 跟其對應的空白翻譯字串 (*msgstr*)，\
407+
此步驟會參考最新的 CPython 中的 pot 檔來更新 po 檔。如果是之前在 po 檔中已填入過翻譯字串但參考的 \
408+
pot 檔的 ``msgid`` 已有變動，則此指令會自動加上 ``#, fuzzy`` 的標記，代表內容有些許差異需要更新。
387409

388410
..code-block::bash
389411
390412
$ make merge
391413
392-
尋找 fuzzy entries
393-
------------------
414+
尋找有翻譯過但需校閱的 fuzzy entries
415+
---------------------------------
394416

395-
*Fuzzy entries* 係指更新 po 檔的原始字串（*msgid*）以後，大部分內容相同但有\
396-
些許差異的字串，即表示該字串的翻譯需要更新。在 po 檔中，您會看到 ``#, fuzzy``
397-
的字樣，這就表示了接下來的字串是 fuzzy entry，需要更新翻譯。
417+
在 po 檔中，您會看到 ``#, fuzzy`` 的字樣，這就表示了接下來的字串是 fuzzy entry，需要更新翻譯。\
418+
您可以自行用習慣的文字編輯器、Linux 指令搜尋有包含此字樣的檔案，但請記得 ``#, fuzzy`` 標記的翻譯字串\
419+
有可能是尚未翻譯過的空白字串 (*msgstr*)。執行下列指令會列出有 *Fuzzy entries* 的檔案且會排除這個情形。
398420

399421
..code-block::bash
400422
401423
$ make fuzzy
402424
403-
本地端編譯輸出文件
404-
------------------
405-
406-
輸出的文件會被放置在您的本地端 CPython clone（見 `維護、預覽`_ 段落的圖示）\
407-
底下的 ``Doc/build/html``，切換到該目錄再使用 ``python3 -m http.server``
408-
或類似的靜態網頁伺服器即可以預覽成果。編譯程序則使用：
409-
410-
..code-block::bash
411-
412-
$ make
413-
414-
415425
Project History
416426
===============
417427

‎c-api/call.po

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version:Python 3.9\n"
1010
"Report-Msgid-Bugs-To:\n"
11-
"POT-Creation-Date:2021-09-13 00:11+0000\n"
11+
"POT-Creation-Date:2021-10-07 00:10+0000\n"
1212
"PO-Revision-Date:YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator:FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team:LANGUAGE <LL@li.org>\n"
@@ -254,7 +254,7 @@ msgstr ""
254254
msgid""
255255
"Various functions are available for calling a Python object. Each converts "
256256
"its arguments to a convention supported by the called object – either "
257-
"*tp_call* or vectorcall. In order to do aslitle conversion as possible, "
257+
"*tp_call* or vectorcall. In order to do aslittle conversion as possible, "
258258
"pick one that best fits the format of data you have available."
259259
msgstr""
260260

‎c-api/index.po

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
# SOME DESCRIPTIVE TITLE.
2-
# Copyright (C) 2001-2018, Python Software Foundation
2+
# Copyright (C) 2001-2021, Python Software Foundation
33
# This file is distributed under the same license as the Python package.
44
#
55
# Translators:
66
# Leon H., 2017
77
# 豆豆 (Tommy Lin) <gnat_lin@hotmail.com>, 2017
8+
# Steven Hsu <hsuhaochun@gmail.com>, 2021
89
msgid ""
910
msgstr ""
10-
"Project-Id-Version:Python 3.7\n"
11+
"Project-Id-Version:Python 3.9\n"
1112
"Report-Msgid-Bugs-To:\n"
1213
"POT-Creation-Date:2018-06-26 18:54+0800\n"
13-
"PO-Revision-Date:2017-11-24 09:04+0000\n"
14+
"PO-Revision-Date:2021-07-05 21:11+0800\n"
1415
"Last-Translator:豆豆 (Tommy Lin) <gnat_lin@hotmail.com>\n"
1516
"Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
1617
"tw)\n"
@@ -19,10 +20,11 @@ msgstr ""
1920
"Content-Type:text/plain; charset=UTF-8\n"
2021
"Content-Transfer-Encoding:8bit\n"
2122
"Plural-Forms:nplurals=1; plural=0;\n"
23+
"X-Generator:Poedit 2.4.3\n"
2224

2325
#:../../c-api/index.rst:5
2426
msgid"Python/C API Reference Manual"
25-
msgstr"Python /C API 參考手冊"
27+
msgstr"Python/C API 參考手冊"
2628

2729
#:../../c-api/index.rst:7
2830
msgid""
@@ -31,3 +33,6 @@ msgid ""
3133
"`extending-index`, which describes the general principles of extension "
3234
"writing but does not document the API functions in detail."
3335
msgstr""
36+
"對於想要編寫擴充模組或是嵌入 Python 的 C 和 C++ 程式設計師們，這份手冊記錄"
37+
"了可使用的 API（應用程式介面）。在\\ :ref:`extending-index`\\ 中也有相關的"
38+
"內容，它描述了編寫擴充的一般原則，但並沒有詳細說明 API 函式。"

‎c-api/init.po

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version:Python 3.7\n"
99
"Report-Msgid-Bugs-To:\n"
10-
"POT-Creation-Date:2021-09-13 00:11+0000\n"
10+
"POT-Creation-Date:2021-09-24 00:11+0000\n"
1111
"PO-Revision-Date:2018-05-23 14:06+0000\n"
1212
"Last-Translator:Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -618,7 +618,7 @@ msgid ""
618618
"name (set by :c:func:`Py_SetProgramName` above) and some environment "
619619
"variables. The returned string consists of a series of directory names "
620620
"separated by a platform dependent delimiter character. The delimiter "
621-
"character is ``':'`` on Unix andMac OS X, ``';'`` on Windows. The returned "
621+
"character is ``':'`` on Unix andmacOS, ``';'`` on Windows. The returned "
622622
"string points into static storage; the caller should not modify its value. "
623623
"The list :data:`sys.path` is initialized with this value on interpreter "
624624
"startup; it can be (and usually is) modified later to change the search path "
@@ -632,8 +632,8 @@ msgid ""
632632
"default search path but uses the one provided instead. This is useful if "
633633
"Python is embedded by an application that has full knowledge of the location "
634634
"of all modules. The path components should be separated by the platform "
635-
"dependent delimiter character, which is ``':'`` on Unix andMac OS X, "
636-
"``';'``on Windows."
635+
"dependent delimiter character, which is ``':'`` on Unix andmacOS, ``';'`` "
636+
"on Windows."
637637
msgstr""
638638

639639
#:../../c-api/init.rst:475
@@ -676,10 +676,10 @@ msgid ""
676676
"Return the platform identifier for the current platform. On Unix, this is "
677677
"formed from the\"official\" name of the operating system, converted to "
678678
"lower case, followed by the major revision number; e.g., for Solaris 2.x, "
679-
"which is also known as SunOS 5.x, the value is ``'sunos5'``. OnMac OS X, "
680-
"itis ``'darwin'``. On Windows, it is ``'win'``. The returned string "
681-
"pointsinto static storage; the caller should not modify its value. The "
682-
"value isavailable to Python code as ``sys.platform``."
679+
"which is also known as SunOS 5.x, the value is ``'sunos5'``. OnmacOS, it "
680+
"is ``'darwin'``. On Windows, it is ``'win'``. The returned string points "
681+
"into static storage; the caller should not modify its value. The value is "
682+
"available to Python code as ``sys.platform``."
683683
msgstr""
684684

685685
#:../../c-api/init.rst:521

‎c-api/type.po

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version:Python 3.7\n"
99
"Report-Msgid-Bugs-To:\n"
10-
"POT-Creation-Date:2021-09-13 00:11+0000\n"
10+
"POT-Creation-Date:2021-09-19 00:12+0000\n"
1111
"PO-Revision-Date:2015-12-09 17:51+0000\n"
1212
"Last-Translator:Liang-Bo Wang <me@liang2.tw>\n"
1313
"Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -209,7 +209,7 @@ msgstr ""
209209
msgid""
210210
"The *module* argument can be used to record the module in which the new "
211211
"class is defined. It must be a module object or ``NULL``. If not ``NULL``, "
212-
"the module is associated with the new type and can later beretreived with :"
212+
"the module is associated with the new type and can later beretrieved with :"
213213
"c:func:`PyType_GetModule`. The associated module is not inherited by "
214214
"subclasses; it must be specified for each class individually."
215215
msgstr""

0 commit comments

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