Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: translate library/socket.po intro section #733

Open
wants to merge 2 commits into
base: 3.12
Choose a base branch
from

Conversation

weijay0804
Copy link
Contributor

Issue: gh-611

久違的更新一下😆
但不知道為什麼,中間有一段沒有被 render 出來
截圖 2023-12-01 下午2 39 59

Copy link
Collaborator

@ken71301 ken71301 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

review part 1.

@@ -62,22 +65,27 @@ msgid ""
"operations on Python files, buffer allocation on receive operations is "
"automatic, and buffer length is implicit on send operations."
msgstr ""
"Python 介面是 Unix 系統呼叫和 socket 模組介面直譯成 Python 物件導向風格的簡單"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

這句的組成會讓我有點混淆,原文的語意的分割是下面哪一個?

  1. The Python interface is a straightforward transliteration of the Unix system call and library interface for sockets to Python's object-oriented style
  2. The Python interface is a straightforward transliteration of the Unix system call and library interface for sockets to Python's object-oriented style
    這邊的中文翻譯有點介於兩者之間,尤其在 直譯 轉換 上的錯置感很強烈,我個人是覺得可以修正

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

截圖 2024-02-26 22 00 58

好的
這邊我參考簡體的翻譯來做更改

@@ -62,22 +65,27 @@ msgid ""
"operations on Python files, buffer allocation on receive operations is "
"automatic, and buffer length is implicit on send operations."
msgstr ""
"Python 介面是 Unix 系統呼叫和 socket 模組介面直譯成 Python 物件導向風格的簡單"
"轉換::func:`.socket` 函數回傳一個 :dfn:`socket object`,其中實現了各種 "
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

methods漏翻


#: ../../library/socket.rst:38
msgid "Module :mod:`ssl`"
msgstr ":mod:`ssl` 模組"

#: ../../library/socket.rst:39
msgid "A TLS/SSL wrapper for socket objects."
msgstr ""
msgstr "對 socket 物件的 TLS/SSL 的封裝。"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wrapper 應為 包裝器

@mattwang44
Copy link
Collaborator

mattwang44 commented Dec 3, 2023

中間有一段沒有被 render 出來

代表 msgid 跟 CPython Doc 的字串對不上,可能有幾種原因:

  1. 你 local repo 的 3.12 branch 不是最新版
  2. 你 local build 的時候用的 cpython 還是舊版(要去 cpython repo 下個 git pull)
  3. (你遇到的原因是這個)CPython Doc 原文有更新過,但相關改動還沒被 merge 進到這個 repo(見 #696

而 3. 的解決方法有幾種

  • 你這個 PR 可以一併帶上新版的原文與翻譯
  • 你也可以把新版翻譯推到 #696 的 branch (cron/sync/3.12) 上
  • 等我 merge #696 再 rebase 並修正翻譯

Copy link
Collaborator

@ken71301 ken71301 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

rst:24 需要重新確認譯文

@@ -62,22 +65,27 @@ msgid ""
"operations on Python files, buffer allocation on receive operations is "
"automatic, and buffer length is implicit on send operations."
msgstr ""
"這個 Python 介面是將 Unix 系統呼叫和 socket 模組介面轉變成 Python 物件導向風格"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

這句要重新理順,全亂了歐

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

第一句的 straightforward transliteration 消失了,還有其他語句跟順暢度的問題,請修正
我個人的習慣是翻完會唸一遍譯文,確認語意通暢

@@ -32,12 +33,14 @@ msgid ""
"on all modern Unix systems, Windows, MacOS, and probably additional "
"platforms."
msgstr ""
"這個模組提供了操作 BSD *socket* 的介面。這在所有現代Unix系統、Windows、"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
"這個模組提供了操作 BSD *socket* 的介面。這在所有現代Unix系統、Windows、"
"這個模組提供了操作 BSD *socket* 的介面。這在所有現代 Unix 系統、Windows、"

@mattwang44
Copy link
Collaborator

@weijay0804 有空的話再記得幫忙修一下歐!

@weijay0804
Copy link
Contributor Author

@weijay0804 有空的話再記得幫忙修一下歐!

Ok! 抱歉最近比較沒時間

@mattwang44
Copy link
Collaborator

因應下週 python 正式 release 3.13,main branch 已經切換成 3.13 文件,要再麻煩你 rebase 並切換 target branch 🙏🏽

@mattwang44
Copy link
Collaborator

@weijay0804 這個 PR 放有點久了,如果最近沒時間處理的話我要先接手囉?

@weijay0804
Copy link
Contributor Author

@weijay0804 這個 PR 放有點久了,如果最近沒時間處理的話我要先接手囉?

拍謝!我最近會開始繼續處理🙏

@mattwang44
Copy link
Collaborator

@weijay0804 這個 PR 放有點久了,如果最近沒時間處理的話我要先接手囉?

拍謝!我最近會開始繼續處理🙏

沒問題 感謝~
看能否先壓個今年結束之前整理好、進下一輪 review,不然我就直接接手來改囉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants