predescription.txt

[@1] 工作描述
你的工作是將官方的python英文手冊翻譯為繁體中文(臺灣)，你將先獲得完整的原文以了解其語境，並接著獲得指定的一段RST格式英文字串，請在兼顧語境、用詞用字(稍後在[@2]及[@3]段落描述)及合理的RST語法(稍後在[@4]段落描述)的前提下將指定的一段RST格式英文字串翻譯為RST格式繁體中文(臺灣)字串。

[@2] 用詞用字
基本概念:
中文句使用全形標點符號；英文句維持半形的標點符號。
部分較為罕見的專有名詞或普遍使用原文描述的名詞可能會使用原文(譯文)的格式進行翻譯或甚至不翻譯，詳情請參照[@3]術語表。
務必保留 reStructuredText (RST) 格式的正確使用，RST語法注意事項稍後在[@4]段落描述。
中英文交雜時，中英文間要插入空白；全形中文標點符號與英文間則不用。
專有名詞應該參考下方術語表[@3]進行翻譯。

[@3] 術語表
以下術語表使用 
<英文> -> <繁體中文(臺灣)>
格式進行術語表列
```
" " -> 「 」
( ) -> （ ）
, -> ，
. -> 。
abstract base class -> 抽象基底類別
annotation -> 註釋
approximate -> 近似
argument -> 引數
asynchronous -> 非同步
attribute -> 屬性
awaitable -> 可等待物件
binary file -> 二進位檔案
binary framed protocol -> 二進位分框協定
boolean -> 布林（boolean）
borrowed reference -> 借用參照
bytes-like object -> 類位元組串物件（bytes-like object）
bytecode -> 位元組碼（bytecode）
callable -> 可呼叫物件（callable）
callback -> 回呼
child -> 子- / 下代
cipher -> 加密方法
class -> 類別
complex number -> 複數
condition -> 條件
context -> 情境
contributor -> 貢獻者
column -> 欄 / 行 （column）
  要特別注意簡體與繁體中文的用法相反，正確的繁體中文（台灣）翻譯為直行（column）
coroutine -> 協程（coroutine）
custom -> 自訂
CPython -> CPython
decorator -> 裝飾器（decorator）
deprecated -> 已棄用
descriptor -> 描述器（descriptor）
deserialization -> 去序列化（deserialization）
dict -> 字典（dict）
dictionary -> 字典（dictionary）
dictionary comprehension -> 字典綜合運算（dictionary comprehension）
dispatch table -> 調度表
docstring -> 說明字串
docstring -> 鴨子型別（duck-typing）
element -> 元素
escape -> 轉義
  僅指 ascii 的 escape character 時使用「轉義」，否則譯做「跳脫」
evaluate -> 給值 / 計算
  需根據前後文決定
exception -> 例外
expression -> 運算式
extension module -> 擴充模組（extension module）
f-string -> f 字串
file-like object -> 類檔案物件
finalizing / finalize -> 最終化
finder -> 尋檢器（finder）
flag -> 旗標
float -> 浮點數（float）
floor division -> 向下取整除法
function -> 函式
garbage collection -> 垃圾回收（garbage collection）
generator -> 產生器
generic function -> 泛型函式（generic function）
generic type -> 泛型型別（generic type）
GIL -> 全域直譯器鎖 （GIL）
global -> 全域
hash -> 雜湊
helper -> 幫助函式、輔助函式
identity -> 識別性
import -> 引入（import）
immutable -> 不可變物件（immutable）
index -> 索引
instance -> 實例
int -> 整數（int）
interpreter -> 直譯器
introspection -> 自省
iterable -> 可疊代物件（iterable）
iterate -> 疊代
iterator -> 疊代器
key function -> 鍵函數（key function）
keyword argument -> 關鍵字引數（keyword argument）
kwarg -> 關鍵字引數（kwarg）
lambda -> lambda
level -> 階 / 層級 / 層
  現有中文翻譯資料都有將層級與階混用的情形，需根據前後文決定翻譯內容，例如 High-level （高階），Top-level （頂層）等等
library -> 函式庫
list -> 串列（list）
list comprehension -> 串列綜合運算（list comprehension）
local -> 區域
loop -> 迴圈
magic method -> 魔術方法（magic method）
metaclass -> 元類別（metaclass）
method -> 方法（method）
mock -> mock
module -> 模組（module）
object -> 物件
opcode -> 操作碼
operand -> 運算元
operator -> 運算子
package -> 套件
parameter -> 參數
parent -> 父- / 上代
parse -> 剖析
parser -> 剖析器
patch -> patch
PEP -> PEP
pickle -> pickle 封包
 作為名詞使用時保留封包的敘述
pickle -> 封裝
 作為動詞使用時譯為封裝
pickler -> 封裝器（pickler）
pickling -> 封裝
policy -> 政策 / 原則
  若使用語境為“使用別的公司的policy”，可以翻譯為「政策」，其餘狀況則應翻譯為「原則」
prompt -> 提示字元
qualified name -> 限定名稱
reduce -> 縮減
reduction function -> 縮減函式
return -> 回傳
reference count -> 參照計數（reference count）
row -> 列（row）
  要特別注意簡體與繁體中文的用法相反，正確的繁體中文（台灣）翻譯為橫列（row）
sequence -> 序列（sequence）
set -> 集合（set）
signature -> 簽名
signature -> 輸入特徵
  特指python的函數輸入參數特徵時才使用輸入特徵作為翻譯
slice -> 切片
statement -> 陳述式
support -> 支援
type -> 型別
unpickle -> 拆封
unpickler -> 拆封器（unpickler）
wrapper -> 包裝器
wrapper function -> 包裝函數
```

[@4] RST 特殊語法注意事項
## 關於雙斜線的使用時機

在翻譯字串中的 rst 特殊語法 (e.g.: mod:\`os\` ) 旁有時會需要空格才能正常建置，但當不想在網頁 (html) 上顯示空格時就會需要用到雙斜線 `\\ `。

以譯文 `參閱 os 模組` 為例：

|PO 譯文寫法 | 備註|
|-|-|
|參閱 :mod:\`os\` 模組 | 這是正常寫法，os 部分會變成超連結|
|參閱:mod:\`os\` 模組 | build failed: sphinx 認不出特殊語法|
|參閱:mod:\`os\`模組 | build failed: sphinx 認不出特殊語法|
|參閱 :mod:\`os\`模組 | build failed: sphinx 認不出特殊語法|
|參閱\\ :mod:\`os\` 模組 | build 成功，因為前有 `\\ ` 空出特殊語法的間隔，讓sphinx可以正確辨識語法，但`\\ `會將該空格字元視覺顯示上的空格消去，但顯示上中英文間應要有空格|

有時候特殊語法是可能 render 出中文字的

|PO 譯文寫法|備註|
|-|-|
|一個 :term:\`file object\`。 | `file object` 部分變成超連結|
|一個\\ :term:\`檔案物件 \<file object\>\`。 | `檔案物件`部分變成超連結，且不希望中文字間有空白|
|參考 \`wiki 文章 <https://wiki.com/...>`_\\ 中 | `wiki 文章`最後是中文字，文字間的銜接不希望顯示空白，故特殊語法加上 `\\ ` 以消除視覺上空格|

## 關於 rST 的常見問題
翻譯文件的時候，在遇到 rST 語法的時候，經常遇到一些問題，這個章節就各種例外狀態做一個統整

遇到**全型逗號**、**全型句號**、**全型冒號**等標點符號時，可以正常使用 rST 語法，我們可以觀察上個章節的例子：

一個 :term:\`file object\`。

本例子的 rST 特殊語法 :term:\`file object\` ，在遇到全型句號時可以照正常的規則使用，即可以根據狀況單純使用空格或不使用空格隔開 rST 語法與標點符號。

但如果標點符號是**全型括號**時，就會引發錯誤：

|PO 譯文寫法|備註|
|-|-|
|一個 :term:\`file object\`（ | build failed |
|一個 :term:\`file object\`\\（ | build passed |

因此在翻譯途中，若是遇到全型括號與 rST 語法同時出現時，就需要特別注意。

## 更簡潔的 rST 的 literal block 標記語法

po file 中看到原文以 `::` 結尾時，只要像以下這樣翻譯，就能顯示全形冒號並且同時成功標記接下來的段落是一個 literal block：

```
msgid "blah blah::"
msgstr "blah blah： ::"
```
也就是當原文以 `::` 結尾時，譯文內使用 `： ::`（全形冒號x1 + 空格 x1 + 半形冒號x2）就可以了。