Translate CSV Module rst:71 to rst:152 (#582)

rockleona · web-flow · commit 732575d696e4 · 2023-08-15T12:53:11.000Z
* Translate rst:71 to rst:152

* Update with Reviewer's comment

* HOTFIX
diff --git a/library/csv.po b/library/csv.po
@@ -111,8 +111,8 @@ msgstr ""
 " [1]_ *dialect* 為一個可選填的參數，可以用為特定的 CSV dialect（方言）"
 " 定義一組參數。它可能為 :class:`Dialect` 的一個子類別 (subclass) 的實例"
 "或是由 :func:`list_dialects` 函式回傳的多個字串中的其中之一。"
-"另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中 override（覆寫）"
-"獨立的格式化參數 (formatting parameter)。關於 dialect 及格式化參數的完整"
+"另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中覆寫 (override) "
+"個別的格式化參數 (formatting parameter)。關於 dialect 及格式化參數的完整"
 "說明，請見段落 :ref:`csv-fmt-params`。"
 
 
@@ -123,6 +123,9 @@ msgid ""
 "format option is specified (in which case unquoted fields are transformed "
 "into floats)."
 msgstr ""
+"從 CSV 檔案讀取的每一列會回傳為一個字串列表。除非格式選項 "
+"``QUOTE_NONNUMERIC`` 有被指定（在這個情況之下，沒有引號的欄位"
+"都會被轉換成浮點數），否則不會進行自動資料型別轉換。"
 
 #: ../../library/csv.rst:75 ../../library/csv.rst:105 ../../library/csv.rst:178
 #: ../../library/csv.rst:216
@@ -149,6 +152,19 @@ msgid ""
 "returned from a ``cursor.fetch*`` call. All other non-string data are "
 "stringified with :func:`str` before being written."
 msgstr ""
+"回傳一個寫入器物件 (writer object)，其負責在給定的類檔案物件 (file-like "
+"object) 上將使用者的資料轉換為分隔字串 (delimited string)。*csvfile* 可以為"
+"具有 :func:`write` method 的任何物件。若 *csvfile* 為一個檔案物件，它應該使用"
+" ``newline=''`` 開啟 [1]_ 。*dialect* 為一個可選填的參數，可以用為特定的"
+" CSV dialect 定義一組參數。它可能為 :class:`Dialect` 的一個子類別的實例"
+"或是由 :func:`list_dialects` 函式回傳的多個字串中的其中之一。"
+"另一個可選填的關鍵字引數 *fmtparams* 可以在這個 dialect 中覆寫"
+"個別的格式化參數。關於 dialect 及格式化參數的完整說明，請見段落"
+" :ref:`csv-fmt-params`。為了更容易與有實作 DB API 的模組互相接合，"
+":const:`None` 值會被寫成空字串。雖然這不是一個可逆的變換，這使得"
+"dump （傾印） SQL NULL 資料值到 CSV 檔案上就無需讓 ``cursor.fetch*`` "
+"呼叫回傳的資料進行預處理 (preprocessing)。其餘非字串的資料則會在寫入之前"
+"用 :func:`str` 函式進行字串化 (stringify)。"
 
 #: ../../library/csv.rst:117
 msgid ""
@@ -158,40 +174,53 @@ msgid ""
 "parameters of the dialect. For full details about dialects and formatting "
 "parameters, see section :ref:`csv-fmt-params`."
 msgstr ""
+"將 *dialect* 與 *name* 進行關聯 (associate)。*name* 必須為字串。這個 dialect "
+"可以透過傳遞 :class:`Dialect` 的子類別進行指定；或是關鍵字引數 "
+"*fmtparams*；或是以上兩者皆是，並透過關鍵字引數來覆寫 dialect 的參數。"
+"關於 dialect 及格式化參數的完整說明，請見段落 :ref:`csv-fmt-params`。"
 
 #: ../../library/csv.rst:126
 msgid ""
 "Delete the dialect associated with *name* from the dialect registry.  An :"
 "exc:`Error` is raised if *name* is not a registered dialect name."
 msgstr ""
+"從 dialect 註冊表 (registry) 中，刪除與 *name* 關聯的 dialect。若 *name* 如"
+"果不是註冊的 dialect 名稱，則會產生一個 :exc:`Error`。"
 
 #: ../../library/csv.rst:132
 msgid ""
 "Return the dialect associated with *name*.  An :exc:`Error` is raised if "
 "*name* is not a registered dialect name.  This function returns an "
 "immutable :class:`Dialect`."
 msgstr ""
+"回傳一個與 *name* 關聯的 dialect。若 *name* 如果不是註冊的 dialect 名稱"
+"，則會產生一個 :exc:`Error`。這個函式會回傳一個 immutable （不可變物件） "
+":class:`Dialect`。"
 
 #: ../../library/csv.rst:138
 msgid "Return the names of all registered dialects."
-msgstr ""
+msgstr "回傳所有已註冊的 dialect 名稱。"
 
 #: ../../library/csv.rst:143
 msgid ""
 "Returns the current maximum field size allowed by the parser. If *new_limit* "
 "is given, this becomes the new limit."
 msgstr ""
+"回傳當前的剖析器 (parser) 允許的最大字串大小。如果 *new_limit* 被給定，"
+"則會變成新的最大字串大小。"
 
 #: ../../library/csv.rst:147
 msgid "The :mod:`csv` module defines the following classes:"
-msgstr ""
+msgstr ":mod:`csv` 模組定義了下列的類別："
 
 #: ../../library/csv.rst:152
 msgid ""
 "Create an object that operates like a regular reader but maps the "
 "information in each row to a :class:`dict` whose keys are given by the "
 "optional *fieldnames* parameter."
 msgstr ""
+"建立一個物件，其運作上就像一般的讀取器，但可以將每一列資訊 map （對映）"
+" 到 :class:`dict` 中，可以透過選填的參數 *fieldnames* 設定 key。"
 
 #: ../../library/csv.rst:156
 msgid ""
