Translate reference/introduction #1175
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
rockleona
requested changes
Nov 24, 2025
Collaborator
rockleona
left a comment
rockleona
left a comment
There was a problem hiding this comment.
Review 1st round:
感謝你的貢獻！回覆你的問題
- 我們只專注在 po 檔案中的翻譯內容，如果沒出現的話就可以忽略了🤣
- 這部分沒問題，個人認為
token這個詞的翻譯太仰賴前後文，但還是麻煩你有空去 Discussion 開一個討論吧！
Comment on lines
+64
to
+67
| "在一份語言的參考文件中加入太多實作細節，是很危險的——這些細節將來可能變化，同" | ||
| "一個語言的其他實作也可能有不一樣的運作方式。然而，CPython 是一個廣泛使用的 " | ||
| "Python 實作，而有時候它的一些特別古怪之處確實值得提及，尤其當那樣的實作作法帶" | ||
| "來了額外限制。基於這個原因，手冊內你會發現簡短的實作細節說明散落在各處。" |
Collaborator
There was a problem hiding this comment.
這句好像沒有翻譯到？
(although alternate implementations continue to gain support)
Suggested change
| "在一份語言的參考文件中加入太多實作細節，是很危險的——這些細節將來可能變化，同" | |
| "一個語言的其他實作也可能有不一樣的運作方式。然而，CPython 是一個廣泛使用的 " | |
| "Python 實作，而有時候它的一些特別古怪之處確實值得提及，尤其當那樣的實作作法帶" | |
| "來了額外限制。基於這個原因，手冊內你會發現簡短的實作細節說明散落在各處。" | |
| "在一份語言的參考文件中加入太多實作細節，是很危險的——這些細節將來可能變化，同" | |
| "一個語言的其他實作也可能有不一樣的運作方式。然而，CPython 是一個廣泛使用的 " | |
| "Python 實作，而有時候它的一些特別古怪之處確實值得提及，尤其當那樣的實作作法帶" | |
| "來了額外限制。基於這個原因，手冊內你會發現簡短的實作細節說明散落在各處。" |
Comment on lines
+105
to
+106
| "以 C 語言開發，是 Python 一開始的實作，同時也是維護程度最好的。新的語言特性通" | ||
| "常會先在這裡問世。" |
Collaborator
There was a problem hiding this comment.
這邊我直覺會想到「功能」，翻譯成「特性」感覺超譯了
Suggested change
| "以 C 語言開發，是 Python 一開始的實作，同時也是維護程度最好的。新的語言特性通" | |
| "常會先在這裡問世。" | |
| "以 C 語言開發，是 Python 一開始的實作，同時也是維護程度最好的。新的語言功能通" | |
| "常會先在這裡問世。" |
Author
There was a problem hiding this comment.
好啊，我發現 whatsnew 部分就是用很多「新功能」、「xx 功能」，配合那邊蠻好的
我想了一下覺得特性偏向東西的本質，但本質的東西不太會變
功能感覺就容易不斷出現新的
| #: ../../reference/introduction.rst:59 | ||
| msgid "Python for .NET" | ||
| msgstr "" | ||
| msgstr "Python.NET" |
Collaborator
There was a problem hiding this comment.
雖然你的寫法也是正確的，但這邊建議保留原文即可
Suggested change
| msgstr "Python.NET" | |
| msgstr "Python for .NET" |
Comment on lines
+135
to
+137
| "這個實作實際上使用到 CPython，但它是託管式的 .NET 應用程式，也使得 .NET 函式" | ||
| "庫可用。它是由 Brian Lloyd 所設計。如需更多資訊，請參閱 `Python.NET 首頁 " | ||
| "<https://pythonnet.github.io/>`_。" |
Collaborator
There was a problem hiding this comment.
嘗試修改的通順一些，看你覺得如何（BTW 請注意 msgstr 單行長度限制）
Suggested change
| "這個實作實際上使用到 CPython，但它是託管式的 .NET 應用程式，也使得 .NET 函式" | |
| "庫可用。它是由 Brian Lloyd 所設計。如需更多資訊，請參閱 `Python.NET 首頁 " | |
| "<https://pythonnet.github.io/>`_。" | |
| "這個實作實際上使用 CPython 的實作內容，但它是託管式的 .NET 應用程式，也使得 .NET 函式" | |
| "庫可用。它是由 Brian Lloyd 所設計。如需更多資訊，請參閱 `Python.NET 首頁 " | |
| "<https://pythonnet.github.io/>`_。" |
rockleona
requested changes
Nov 25, 2025
Collaborator
rockleona
left a comment
rockleona
left a comment
There was a problem hiding this comment.
Review 2nd round，再麻煩修正，感謝！
Comment on lines
+220
to
+221
| "每一條規則的開頭即規則名稱，接著一個分號 ``:``。分號右側是由下列語法元素所構" | ||
| "成的規則定義 ：" |
Collaborator
There was a problem hiding this comment.
(which identifies the rule that's being defined) 這句話好像沒翻譯到
Author
There was a problem hiding this comment.
括號這句我有點不解，好像是不必要的、很抽象的說明？
我是覺得略過這句也無礙對這段的理解
| #: ../../reference/introduction.rst:126 | ||
| msgid "``'if'``: A name in single quotes denotes a :ref:`keyword <keywords>`." | ||
| msgstr "" | ||
| msgstr "``'if'``：單引號內的文字為 :ref:`keyword <keywords>`。" |
Collaborator
There was a problem hiding this comment.
- :ref:
keyword <keywords>可以翻譯喔
Suggested change
| msgstr "``'if'``：單引號內的文字為 :ref:`keyword <keywords>`。" | |
| msgstr "``'if'``：單引號內的文字為 :ref:`關鍵字 <keywords>`。" |
Author
There was a problem hiding this comment.
喔喔知道了
我對這個 ref 有些誤會，原來只是單純超連結，角括號左邊部分要自己翻XD
| "``\"case\"``: A name in double quotes denotes a :ref:`soft-keyword <soft-" | ||
| "keywords>`." | ||
| msgstr "" | ||
| msgstr "``\"case\"``：雙引號內的文字為 :ref:`soft-keyword <soft-keywords>`。" |
Collaborator
There was a problem hiding this comment.
同上
Suggested change
| msgstr "``\"case\"``：雙引號內的文字為 :ref:`soft-keyword <soft-keywords>`。" | |
| msgstr "``\"case\"``：雙引號內的文字為 :ref:`軟關鍵字 <soft-keywords>`。" |
Comment on lines
+263
to
+264
| "``'@'``：單引號內的非字母（非 ``letter``）符號為 :py:data:`~token.OP` token，" | ||
| "也就是 :ref:`delimiter <delimiters>` 或 :ref:`operator <operators>`。" |
Collaborator
There was a problem hiding this comment.
這邊的 delimiter, operator 也可以翻譯
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Issue #1168
Done
這部分大概有兩個問題：