Skip to content

Commit

Permalink
docs(howto/sockets.po): 翻譯 IPCUsing a Socket 區塊 (python#493) (p…
Browse files Browse the repository at this point in the history
…ython#502)

* docs(howto/sockets.po): 翻譯 `IPC` 與 `Using a Socket` 區塊

pythongh-466

Original PR python#493. Cherry-pick from 3.11 to 3.12

Co-authored-by: Jay <74105438+weijay0804@users.noreply.github.com>
  • Loading branch information
cschan1828 and weijay0804 committed Jul 25, 2023
1 parent 860a8e7 commit f4f16ff
Showing 1 changed file with 32 additions and 41 deletions.
73 changes: 32 additions & 41 deletions howto/sockets.po
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: Python 3.12\n"
"Project-Id-Version: Python 3.11\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-06-10 00:16+0000\n"
"PO-Revision-Date: 2023-07-19 20:17+0800\n"
Expand Down Expand Up @@ -64,13 +64,13 @@ msgid ""
"blocking sockets. But I'll start by talking about blocking sockets. You'll "
"need to know how they work before dealing with non-blocking sockets."
msgstr ""
"我只會討論關於 INET(例如:IPv4)的 sockets,但它們涵蓋了幾乎 99% 的 sockets "
"使用場景。而我也將僅討論關於 STREAM(比如:TCP)類型的 sockets - 除非你真的知"
"道你在做什麼(在這種情況下,這份指南可能不適合你),使用 STREAM 類型的 "
"socket 會獲得比其他 sockets 類型更好的表現和性能。我將會嘗試解釋 socket 是什"
",以及如何使用阻塞 (blocking) 和非阻塞 (non-blocking) sockets 的一些建議。"
"但首先我會先談論阻塞 sockets。在處理非阻塞 sockets 之前,你需要了解它們的工作"
"原理。"
"我只會討論關於 INET(例如:IPv4)的 sockets,但它們涵蓋了幾乎 99% 的 "
"sockets 使用場景。而我也將僅討論關於 STREAM(比如:TCP)類型的 sockets - "
"非你真的知道你在做什麼(在這種情況下,這份指南可能不適合你),使用 STREAM "
"類型的 socket 會獲得比其他 sockets 類型更好的表現和性能。我將會嘗試解釋 "
"socket 是什麼,以及如何使用阻塞 (blocking) 和非阻塞 (non-blocking) sockets "
"一些建議。但首先我會先談論阻塞 sockets。在處理非阻塞 sockets 之前,你需要了解"
"它們的工作原理。"

#: ../../howto/sockets.rst:31
msgid ""
Expand All @@ -82,12 +82,12 @@ msgid ""
"sockets exclusively; the web server it's talking to uses both \"server\" "
"sockets and \"client\" sockets."
msgstr ""
"要理解這些東西的困難點之一在於 \"scoket\" 可以代表多種具有些微差異的東西,"
"主要取決於上下文。所以首先,讓我們先區分「用戶端 (client)」socket 和「伺服器"
" (server)」socket 的差別,「用戶端」socket 表示通訊的一端,「伺服器端」"
"socket 更像是一個電話總機接線員。用戶端應用程式(例如:你的瀏覽器)只能使用"
"「用戶端」socket; 它所連接的網路伺服器則同時使用「伺服器端」socket 和 「用戶"
"」socket 來進行通訊。"
"要理解這些東西的困難點之一在於 \"scoket\" 可以代表多種具有些微差異的東西,這主要"
"取決於上下文。所以首先,讓我們先區分「用戶端 (client)」socket 和「伺服器端"
" (server)」socket 的差別,「用戶端」socket 表示通訊的一端,「伺服器端」"
"socket 更像是一個電話總機接線員。用戶端應用程式(例如:你的瀏覽器)只能使"
"「用戶端」socket; 它所連接的網路伺服器則同時使用「伺服器端」socket 和 "
"「用戶端」socket 來進行通訊。"

#: ../../howto/sockets.rst:40
msgid "History"
Expand All @@ -111,8 +111,8 @@ msgid ""
"of sockets with INET makes talking to arbitrary machines around the world "
"unbelievably easy (at least compared to other schemes)."
msgstr ""
"Sockets 作為 Unix 的 BSD 分支的一部分在 Berkeley 被發明出來。它們隨著網際網路"
"的普及而迅速蔓延開來。這是有很好的理由 — sockets 和 INET 的結合讓世界各地任何"
"Sockets 作為 Unix 的 BSD 分支的一部分在 Berkeley 被發明出來。它們隨著網際網路的普"
"及而迅速蔓延開來。這是有很好的理由 — sockets 和 INET 的結合讓世界各地任何"
"的機器之間的通訊變得非常簡單(至少與其它方案相比是如此)。"

#: ../../howto/sockets.rst:54
Expand All @@ -136,16 +136,16 @@ msgid ""
"used for one exchange (or a small set of sequential exchanges)."
msgstr ""
"當 ``connect`` 完成時,這個 socket ``s`` 可以用來發送請求來取得頁面的文本。同"
"一個 socket 也會讀取回傳值,然後再被銷毀。是的,會被銷毀。用戶端 socket 通常"
"只用來做一次交換(或是一小組連續交換)。"
"一個 socket 也會讀取回傳值,然後再被銷毀。是的,會被銷毀。用戶端 socket 通常只"
"用來做一次交換(或是一小組連續交換)。"

#: ../../howto/sockets.rst:70
msgid ""
"What happens in the web server is a bit more complex. First, the web server "
"creates a \"server socket\"::"
msgstr ""
"網路伺服器 (web server) 的運作就稍微複雜一點。首先,網路伺服器會建立一個「"
"服器端 socket」:\n"
"網路伺服器 (web server) 的運作就稍微複雜一點。首先,網路伺服器會建立一個「伺服器端 "
"socket」:\n"
"\n"
"::"

Expand All @@ -158,19 +158,19 @@ msgid ""
"machine. ``s.bind(('', 80))`` specifies that the socket is reachable by any "
"address the machine happens to have."
msgstr ""
"有幾件事需要注意:我們使用了 ``socket.gethostname()``,這樣 socket 才能對外部"
"網路可見。如果我們使用了 ``s.bind(('localhost', 80))`` 或 ``s."
"bind(('127.0.0.1', 80))``,我們會得到一個「伺服器端」socket,但是只能在同一台"
"機器內可見。``s.bind(('', 80))`` 指定 socket 可以透過機器的任何地址存取。"
"有幾件事需要注意:我們使用了 ``socket.gethostname()``,這樣 socket 才能對外"
"部網路可見。如果我們使用了 ``s.bind(('localhost', 80))`` 或 ``s."
"bind(('127.0.0.1', 80))``,我們會得到一個「伺服器端」socket,但是只能在同一"
"台機器內可見。``s.bind(('', 80))`` 指定 socket 可以透過機器的任何地址存取。"

#: ../../howto/sockets.rst:87
msgid ""
"A second thing to note: low number ports are usually reserved for \"well "
"known\" services (HTTP, SNMP etc). If you're playing around, use a nice high "
"number (4 digits)."
msgstr ""
"第二個要注意的是:數字小的連接埠 (port) 通常保留給「廣為人知的」服務(HTTP、"
"SNMP等)。如果你只是想執行程式,可以使用一個數字較大的連接埠(4 位數字)。"
"第二個要注意的是:數字小的連接埠 (port) 通常保留給「廣為人知的」服務(HTTP、SNMP"
")。如果你只是想執行程式,可以使用一個數字較大的連接埠(4 位數字)。"

#: ../../howto/sockets.rst:91
msgid ""
Expand Down Expand Up @@ -209,24 +209,15 @@ msgid ""
"allocated port which will be recycled when the conversation ends."
msgstr ""
"事實上,有三種方法可以讓這個迴圈運作 - 分配一個執行緒 (thread) 來處理 "
"``clientsocket`` 、建立一個新行程 (process) 來處理 ``clientsocket``,或者將這"
"個程式重新改寫成使用非阻塞 socket,並使用 ``select`` 在我們的「伺服器端」"
"``clientsocket`` 、建立一個新行程 (process) 來處理 ``clientsocket``,或者將"
"這個程式重新改寫成使用非阻塞 socket,並使用 ``select`` 在我們的「伺服器端」"
"socket 和任何有效的 ``clientsocket`` 之間進行多工處理。稍後將會更詳細的介紹。"
<<<<<<< HEAD
"現在最重要的是理解:這就是「伺服器端」socket 做的\\ *所有* \\事情。它不會發送"
"任何資料、也不接收任何資料,它只會建立「伺服器端」socket。每個 "
"``clientsocket`` 都是為了回應某些\\ *其他* \\ ``connect()`` 到我們綁定的主機"
"上的「用戶端」socket。一但 ``clientsocket`` 建立完成,就會繼續監聽更多的連接"
"請求。兩個「用戶端」可以隨意的通訊 - 它們使用的是一些動態分配的連接埠,會在通"
"訊結束的時候被回收並重新利用。"
=======
"現在最重要的是理解:這就是「伺服器端」socket 做的\\ *所有* \\事情。它不會發送任何"
"資料、也不接收任何資料,它只會建立「伺服器端」socket。每個 ``clientsocket`` "
"都是為了回應某些\\ *其他* \\ ``connect()`` 到我們綁定的主機上的「用戶端」socket。"
"一但 ``clientsocket`` 建立完成,就會繼續監聽更多的連線請求。兩個「用戶端」可"
"以隨意的通訊 - 它們使用的是一些動態分配的連接埠,會在通訊結束的時候被回收並重新"
"利用。"
>>>>>>> 445d5a27 (docs(howto/sockets.po): 翻譯 `IPC` 與 `Using a Socket` 區塊 (#493))

#: ../../howto/sockets.rst:121
msgid "IPC"
Expand Down Expand Up @@ -443,10 +434,10 @@ msgstr ""
#: ../../howto/sockets.rst:262
msgid ""
"Socket libraries have calls for converting 16 and 32 bit integers - ``ntohl, "
"htonl, ntohs, htons`` where \"n\" means *network* and \"h\" means *host*, "
"\"s\" means *short* and \"l\" means *long*. Where network order is host "
"order, these do nothing, but where the machine is byte-reversed, these swap "
"the bytes around appropriately."
"htonl, ntohs, htons`` where \"n\" means *network* and \"h\" means *host*, \"s"
"\" means *short* and \"l\" means *long*. Where network order is host order, "
"these do nothing, but where the machine is byte-reversed, these swap the "
"bytes around appropriately."
msgstr ""

#: ../../howto/sockets.rst:268
Expand Down

0 comments on commit f4f16ff

Please sign in to comment.