Apply additional review feedback from @mattwang44 on embedding.po

Co-authored-by: mattwang44 <[email protected]>

Author: Copilot

extending/embedding.po

@@ -49,8 +49,8 @@ msgid ""
 "nothing to do with Python --- instead, some parts of the application "
 "occasionally call the Python interpreter to run some Python code."
 msgstr ""
-"嵌入 Python 與擴充它類似，但不完全相同。差別在於當你擴充 Python 時，應用程式"
-"的主程式仍然是 Python 直譯器，而如果你嵌入 Python，主程式可能與 Python "
+"嵌入 Python 與擴充 Python 類似，但不完全相同。差別在於當你擴充 Python 時，應用程式"
+"的主程式仍然是 Python 直譯器，而當你嵌入 Python，主程式可能與 Python "
 "無關 — 相反地，應用程式的某些部分偶爾會呼叫 Python 直譯器來執行一些 Python "
 "程式碼。"
 
@@ -65,7 +65,7 @@ msgid ""
 msgstr ""
 "所以如果你要嵌入 Python，你要提供自己的主程式。這個主程式必須做的事情之一是"
 "初始化 Python 直譯器，或至少必須要呼叫函式 :c:func:`Py_Initialize`。還有一些"
-"可選的呼叫來傳遞命令列引數給 Python。然後你可以在應用程式的任何部分呼叫直譯"
+"可選的呼叫來傳遞命令列引數給 Python。然後你就可以在應用程式的任何部分呼叫直譯"
 "器。"
 
 #: ../../extending/embedding.rst:32
@@ -77,7 +77,7 @@ msgid ""
 "level operations described in the previous chapters to construct and use "
 "Python objects."
 msgstr ""
-"有幾種不同的方式來呼叫直譯器：你可以傳遞一個包含 Python 敘述的字串給 :c:func:"
+"有幾種不同的方式來呼叫直譯器：你可以傳遞一個包含 Python 陳述式的字串給 :c:func:"
 "`PyRun_SimpleString`，或者你可以傳遞一個 stdio 檔案指標和檔案名稱（僅用於錯誤"
 "訊息中的識別）給 :c:func:`PyRun_SimpleFile`。你也可以呼叫前面章節中描述的較低"
 "層級操作來建構和使用 Python 物件。"
@@ -105,7 +105,7 @@ msgid ""
 "used to perform some operation on a file. ::"
 msgstr ""
 "嵌入 Python 最簡單的形式是使用非常高階的介面。此介面用於執行 Python 腳本而"
-"無需直接與應用程式互動。這例如可以用來對檔案執行一些操作。 ::"
+"無需直接與應用程式互動。例如這可以用來對檔案執行一些操作。 ::"
 
 #: ../../extending/embedding.rst:56
 msgid ""
@@ -187,7 +187,7 @@ msgid ""
 "string-and-buffers` for a description of this macro."
 msgstr ""
 "``#define PY_SSIZE_T_CLEAN`` 被用來指示某些 API 應該使用 ``Py_ssize_t`` 而不是 "
-"``int``。從 Python 3.13 開始不再必要，但我們在這裡保留它以維持向後相容性。"
+"``int``。從 Python 3.13 開始不再需要它，但我們保留它以維持向後相容性。"
 "關於此巨集的描述請參閱 :ref:`arg-parsing-string-and-buffers`。"
 
 #: ../../extending/embedding.rst:97
@@ -204,8 +204,8 @@ msgid ""
 "`PyRun_SimpleFile` function, which saves you the trouble of allocating "
 "memory space and loading the file contents."
 msgstr ""
-"設定 :c:member:`PyConfig.program_name` 應該在 :c:func:`Py_InitializeFromConfig` "
-"之前呼叫，以告知直譯器 Python run-time 函式庫的路徑。接下來，Python 直譯器用 :c:"
+":c:member:`PyConfig.program_name` 的設定應該在 :c:func:`Py_InitializeFromConfig` "
+"前呼叫，以告知直譯器 Python run-time 函式庫的路徑。接下來，Python 直譯器會用 :c:"
 "func:`Py_Initialize` 初始化，然後執行一個硬編碼的 Python 腳本來印出日期和時間。"
 "之後，:c:func:`Py_FinalizeEx` 呼叫會關閉直譯器，接著程式結束。在真實的程式中，"
 "你可能想要從另一個來源取得 Python 腳本，或許是文字編輯器例程、檔案或資料庫。"
@@ -224,9 +224,9 @@ msgid ""
 "calls. At the cost of having to write more C code, you can achieve almost "
 "anything."
 msgstr ""
-"高階介面讓你能夠從應用程式中執行任意的 Python 程式碼片段，但至少可以說交換資料"
-"值是相當麻煩的。如果你想要這樣做，你應該使用較低階的呼叫。以必須撰寫更多 C "
-"程式碼為代價，你幾乎可以達成任何事情。"
+"高階介面讓你能夠從應用程式中執行任意的 Python 程式碼片段，但交換資料"
+"值的過程可以說相當繁瑣。如果你想進行這類操作，應該使用較低階的呼叫。"
+"雖然需要撰寫更多的 C 程式碼，但幾乎可以實現任何功能。"
 
 #: ../../extending/embedding.rst:119
 msgid ""
@@ -235,17 +235,17 @@ msgid ""
 "previous chapters are still valid. To show this, consider what the extension "
 "code from Python to C really does:"
 msgstr ""
-"應該注意的是，儘管意圖不同，擴充 Python 和嵌入 Python 其實是相當相同的活動。"
-"前面章節討論的大部分主題仍然有效。為了說明這一點，考慮從 Python 到 C 的擴充"
-"程式碼真正做了什麼："
+"需要注意的是，雖然目的不同，但擴充 Python 與嵌入 Python 其實是非常相似的操作，"
+"前面章節討論的大多數主題在這裡同樣適用。為了說明這一點，請思考從 Python 到 C "
+"的擴充程式碼實際上做了什麼："
 
 #: ../../extending/embedding.rst:124
 msgid "Convert data values from Python to C,"
 msgstr "將資料值從 Python 轉換為 C，"
 
 #: ../../extending/embedding.rst:126
 msgid "Perform a function call to a C routine using the converted values, and"
-msgstr "使用轉換後的值對 C 例程執行函式呼叫，以及"
+msgstr "使用轉換後的值呼叫 C 例程，並"
 
 #: ../../extending/embedding.rst:128
 msgid "Convert the data values from the call from C to Python."
@@ -263,7 +263,7 @@ msgstr "將資料值從 C 轉換為 Python，"
 msgid ""
 "Perform a function call to a Python interface routine using the converted "
 "values, and"
-msgstr "使用轉換後的值對 Python 介面例程執行函式呼叫，以及"
+msgstr "使用轉換後的值呼叫 Python 介面例程，並"
 
 #: ../../extending/embedding.rst:137
 msgid "Convert the data values from the call from Python to C."
@@ -276,8 +276,8 @@ msgid ""
 "is the routine that you call between both data conversions. When extending, "
 "you call a C routine, when embedding, you call a Python routine."
 msgstr ""
-"如你所見，資料轉換步驟只是被交換來配合跨語言傳輸的不同方向。唯一的差別是你在"
-"兩個資料轉換之間呼叫的例程。當擴充時，你呼叫 C 例程，當嵌入時，你呼叫 Python "
+"如你所見，資料轉換的步驟只是互換了順序，以配合跨語言傳遞方向的不同。唯一的差別在於"
+"兩個資料轉換之間所呼叫的例程：在擴充時你呼叫的是 C 例程；在嵌入時則呼叫 Python "
 "例程。"
 
 #: ../../extending/embedding.rst:144
@@ -287,9 +287,9 @@ msgid ""
 "be understood.  Since these aspects do not differ from extending the "
 "interpreter, you can refer to earlier chapters for the required information."
 msgstr ""
-"本章不會討論如何將資料從 Python 轉換為 C 以及反之。此外，假設已經理解參考的"
-"正確使用和錯誤處理。由於這些方面與擴充直譯器沒有不同，你可以參考前面的章節"
-"來取得所需資訊。"
+"本章不會討論如何將資料從 Python 轉換為 C 或從 C 轉換回 Python，且假設讀者已經知道參照的"
+"正確使用方式與錯誤處理。由於這些部分與擴充直譯器時相同，"
+"相關資訊可參考前面的章節。"
 
 #: ../../extending/embedding.rst:153
 msgid "Pure Embedding"
@@ -393,8 +393,8 @@ msgid ""
 "(let's call the finished executable :program:`call`), and use it to execute "
 "a Python script, such as:"
 msgstr ""
-"此程式碼使用 ``argv[1]`` 載入 Python 腳本，並呼叫 ``argv[2]`` 中命名的函式。"
-"其整數引數是 ``argv`` 陣列的其他值。如果你 :ref:`編譯並連結 <compiling>` 此"
+"此程式碼使用 ``argv[1]`` 載入 Python 腳本，並呼叫 ``argv[2]`` 中所指定的函式。"
+"其整數引數則來自 ``argv`` 陣列中的其他值。如果你\\ :ref:`編譯並連結 <compiling>` 此"
 "程式（我們稱完成的可執行檔為 :program:`call`），並用它來執行 Python 腳本，"
 "例如："
 
@@ -434,8 +434,8 @@ msgid ""
 "is for data conversion between Python and C, and for error reporting.  The "
 "interesting part with respect to embedding Python starts with ::"
 msgstr ""
-"雖然對於其功能而言程式相當龐大，但大部分的程式碼是用於 Python 和 C 之間的資料"
-"轉換，以及錯誤回報。關於嵌入 Python 的有趣部分開始於： ::"
+"雖然以其功能而言這個程式相當龐大，但大部分的程式碼是用於 Python 與 C 之間的資料"
+"轉換以及錯誤回報。至於與嵌入 Python 有關的重點部分，則從以下開始： ::"
 
 #: ../../extending/embedding.rst:192
 msgid ""
@@ -486,9 +486,9 @@ msgid ""
 "proceeds by constructing a tuple of arguments as normal.  The call to the "
 "Python function is then made with::"
 msgstr ""
-"一旦腳本載入，我們要找的名稱使用 :c:func:`PyObject_GetAttrString` 檢索。如果"
-"名稱存在，且回傳的物件是可呼叫的，你可以安全地假設它是一個函式。程式接著以"
-"正常方式建構引數元組。對 Python 函式的呼叫接著以下面方式進行 ::"
+"腳本載入後，會使用 :c:func:`PyObject_GetAttrString` 來取得所需的名稱。如果"
+"該名稱存在，且回傳的物件是可呼叫的，便可安全地假設它是一個函式。接著，程式會以"
+"一般方式建立引數的元組。之後便以下列方式呼叫該 Python 函式： ::"
 
 #: ../../extending/embedding.rst:216
 msgid "pValue = PyObject_CallObject(pFunc, pArgs);"
@@ -500,7 +500,7 @@ msgid ""
 "reference to the return value of the function.  Be sure to release the "
 "reference after examining the value."
 msgstr ""
-"函式回傳時，``pValue`` 要不是 ``NULL`` 就是包含函式回傳值的參照。確保在檢查"
+"函式回傳時，``pValue`` 要不是 ``NULL`` 就是包含函式回傳值的參照。請務必在檢查"
 "值之後釋放參照。"
 
 #: ../../extending/embedding.rst:226
@@ -518,10 +518,10 @@ msgid ""
 "and write some glue code that gives Python access to those routines, just "
 "like you would write a normal Python extension.  For example::"
 msgstr ""
-"到目前為止，嵌入式 Python 直譯器無法存取應用程式本身的功能。Python API 透過"
-"擴充嵌入式直譯器來允許這樣做。也就是說，嵌入式直譯器被應用程式提供的例程所"
-"擴充。雖然聽起來複雜，但其實沒那麼糟。只要暫時忘記應用程式啟動 Python 直譯器"
-"這件事。相反，把應用程式當作一組子程序，並撰寫一些膠合程式碼讓 Python 存取"
+"到目前為止，嵌入式 Python 直譯器尚無法存取應用程式本身的功能。Python API 允許透過"
+"擴充嵌入式直譯器來達成這點。也就是說，嵌入式直譯器可以由應用程式所提供的例程加以"
+"擴充。雖然聽起來複雜但其實並不難。只要暫時忘記是應用程式啟動了 Python 直譯器，"
+"改以將應用程式視為一組子程序，並撰寫一些膠合程式碼讓 Python 能夠存取"
 "這些例程，就像你撰寫一般 Python 擴充一樣。例如： ::"
 
 #: ../../extending/embedding.rst:237
@@ -563,7 +563,7 @@ msgid ""
 "the following two statements before the call to :c:func:`Py_Initialize`::"
 msgstr ""
 "在 :c:func:`main` 函式的正上方插入上述程式碼。同時，在呼叫 :c:func:"
-"`Py_Initialize` 之前插入以下兩個敘述 ::"
+"`Py_Initialize` 之前插入以下兩個陳述式：::"
 
 #: ../../extending/embedding.rst:270
 msgid ""
@@ -579,8 +579,8 @@ msgid ""
 "emb.numargs` function accessible to the embedded Python interpreter. With "
 "these extensions, the Python script can do things like"
 msgstr ""
-"這兩行初始化 ``numargs`` 變數，並讓 :func:`!emb.numargs` 函式對嵌入式 Python "
-"直譯器可用。有了這些擴充，Python 腳本可以執行以下操作"
+"這兩行初始化 ``numargs`` 變數，並讓 :func:`!emb.numargs` 函式可供嵌入式 Python "
+"直譯器使用。有了這些擴充後，Python 腳本便可以執行像是以下的操作"
 
 #: ../../extending/embedding.rst:277
 msgid ""
@@ -624,8 +624,8 @@ msgid ""
 "implemented as C dynamic extensions (:file:`.so` files) linked against it."
 msgstr ""
 "要找到傳遞給編譯器（和連結器）的正確旗標以便將 Python 直譯器嵌入你的應用程式"
-"中，並不一定是簡單的事，特別是因為 Python 需要載入作為 C 動態擴充實作的函式庫"
-"模組（:file:`.so` 檔案）並連結到它。"
+"中，並不一定是簡單的事，特別是因為 Python 需要載入作為 C 動態擴充（:file:`.so` 檔案）實作的函式庫"
+"模組，而這些模組又必須與 Python 進行連結。"
 
 #: ../../extending/embedding.rst:311
 msgid ""
@@ -637,7 +637,7 @@ msgid ""
 msgstr ""
 "要找出所需的編譯器和連結器旗標，你可以執行作為安裝過程的一部分產生的 :file:"
 "`python{X.Y}-config` 腳本（也可能有 :file:`python3-config` 腳本可用）。此腳本"
-"有幾個選項，其中以下對你直接有用："
+"提供多種選項，其中以下幾個最為實用："
 
 #: ../../extending/embedding.rst:317
 msgid ""
@@ -678,8 +678,8 @@ msgid ""
 "that you use the absolute path to :file:`python{X.Y}-config`, as in the "
 "above example."
 msgstr ""
-"為了避免多個 Python 安裝之間的混淆（特別是系統 Python 和你自己編譯的 Python "
-"之間），建議你使用 :file:`python{X.Y}-config` 的絕對路徑，如上面的例子所示。"
+"為了避免多個 Python 安裝之間產生混淆（特別是系統自帶的 Python 與自行編譯的 Python "
+"之間），建議使用 :file:`python{X.Y}-config` 的絕對路徑，如上面的例子所示。"
 
 #: ../../extending/embedding.rst:339
 msgid ""
@@ -692,11 +692,11 @@ msgid ""
 "extract the configuration values that you will want to combine together.  "
 "For example:"
 msgstr ""
-"如果此程序對你不起作用（不保證對所有類 Unix 平台都有效；但是，我們歡迎 :ref:"
-"`錯誤回報 <reporting-bugs>`），你將必須閱讀系統關於動態連結的文件和/或檢查 "
-"Python 的 :file:`Makefile`（使用 :func:`sysconfig.get_makefile_filename` 來"
-"找到其位置）和編譯選項。在這種情況下，:mod:`sysconfig` 模組是一個有用的工具，"
-"可以程式化地擷取你想要組合在一起的組態值。例如："
+"如果此程序對你不起作用（並不保證在所有類 Unix 平台上都能運作；不過我們歡迎\\ :ref:"
+"`錯誤回報 <reporting-bugs>`），你將需要參閱系統的動態連結相關文件，並／或檢查 "
+"Python 的 :file:`Makefile`\\ （可使用 :func:`sysconfig.get_makefile_filename` 來"
+"找到其位置）和編譯選項。在這種情況下，:mod:`sysconfig` 模組是一個實用的工具，"
+"可用於以程式化方式擷取並組合所需的組態值。例如："
 
 #: ../../extending/embedding.rst:348
 msgid ""