[po] auto sync

github-actions[bot] · github-actions[bot] · commit df6068d9cbd7 · 2021-10-28T19:50:26.000Z
diff --git a/extending/embedding.po b/extending/embedding.po
@@ -212,7 +212,7 @@ msgstr ""
 
 #: ../../extending/embedding.rst:141
 msgid "The code to run a function defined in a Python script is:"
-msgstr ""
+msgstr "要运行 Python 脚本中定义的函数，代码如下："
 
 #: ../../extending/embedding.rst:146
 msgid ""
@@ -245,6 +245,8 @@ msgid ""
 "argument, which is constructed using the :c:func:`PyUnicode_FromString` data"
 " conversion routine. ::"
 msgstr ""
+"初始化解释器之后，则用 :c:func:`PyImport_Import` 加载脚本。此函数的参数需是个 Python 字符串，一个用 "
+":c:func:`PyUnicode_FromString` 数据转换函数构建的字符串。"
 
 #: ../../extending/embedding.rst:191
 msgid ""
@@ -254,17 +256,20 @@ msgid ""
 "program then 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 "
+"函数："
 
 #: ../../extending/embedding.rst:199
 msgid ""
 "Upon return of the function, ``pValue`` is either ``NULL`` or it contains a "
 "reference to the return value of the function.  Be sure to release the "
 "reference after examining the value."
-msgstr ""
+msgstr "当函数返回时，``pValue`` 要么为 ``NULL``，要么包含对函数返回值的引用。请确保用完后释放该引用。"
 
 #: ../../extending/embedding.rst:207
 msgid "Extending Embedded Python"
-msgstr ""
+msgstr "对嵌入 Python 功能进行扩展"
 
 #: ../../extending/embedding.rst:209
 msgid ""
@@ -277,25 +282,30 @@ 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 扩展程序一样。 例如："
 
 #: ../../extending/embedding.rst:246
 msgid ""
 "Insert the above code just above the :c:func:`main` function. Also, insert "
 "the following two statements before the call to :c:func:`Py_Initialize`::"
-msgstr ""
+msgstr "在 :c:func:`main` 函数之前插入上述代码。并在调用 :c:func:`Py_Initialize` 之前插入以下两条语句："
 
 #: ../../extending/embedding.rst:252
 msgid ""
 "These two lines initialize the ``numargs`` variable, and make the "
 ":func:`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 脚本可以执行类似以下功能："
 
 #: ../../extending/embedding.rst:261
 msgid ""
 "In a real application, the methods will expose an API of the application to "
 "Python."
-msgstr ""
+msgstr "在真实的应用程序中，这种方法将把应用的 API 暴露给 Python 使用。"
 
 #: ../../extending/embedding.rst:271
 msgid "Embedding Python in C++"
@@ -309,6 +319,8 @@ msgid ""
 "and link your program.  There is no need to recompile Python itself using "
 "C++."
 msgstr ""
+"还可以将 Python 嵌入到 C++ 程序中去；确切地说，实现方式将取决于 C++ 系统的实现细节；一般需用 C++ 编写主程序，并用 C++ "
+"编译器来编译和链接 程序。不需要用 C++ 重新编译 Python 本身。"
 
 #: ../../extending/embedding.rst:282
 msgid "Compiling and Linking under Unix-like systems"
@@ -321,6 +333,8 @@ msgid ""
 "application, particularly because Python needs to load library modules "
 "implemented as C dynamic extensions (:file:`.so` files) linked against it."
 msgstr ""
+"为了将 Python 解释器嵌入应用程序，找到正确的编译参数传给编译器 (和链接器) 并非易事，特别是因为 Python 加载的库模块是以 C "
+"动态扩展（:file:`.so` 文件）的形式实现的。"
 
 #: ../../extending/embedding.rst:290
 msgid ""
@@ -330,18 +344,20 @@ msgid ""
 "available).  This script has several options, of which the following will be"
 " directly useful to you:"
 msgstr ""
+"为了得到所需的编译器和链接器参数，可执行 :file:`python{X.Y}-config` 脚本，它是在安装 Python 时生成的（也可能存在 "
+":file:`python3-config` 脚本）。该脚本有几个参数，其中以下几个参数会直接有用："
 
 #: ../../extending/embedding.rst:296
 msgid ""
 "``pythonX.Y-config --cflags`` will give you the recommended flags when "
 "compiling:"
-msgstr ""
+msgstr "``pythonX.Y-config --cflags`` 将给出建议的编译参数。"
 
 #: ../../extending/embedding.rst:304
 msgid ""
 "``pythonX.Y-config --ldflags`` will give you the recommended flags when "
 "linking:"
-msgstr ""
+msgstr "``pythonX.Y-config --ldflags`` 将给出建议的链接参数。"
 
 #: ../../extending/embedding.rst:313
 msgid ""
@@ -350,6 +366,8 @@ msgid ""
 "that you use the absolute path to :file:`python{X.Y}-config`, as in the "
 "above example."
 msgstr ""
+"为了避免多个 Python 安装版本引发混乱（特别是在系统安装版本和自己编译版本之间），建议用 :file:`python{X.Y}-config` "
+"指定绝对路径，如上例所述。"
 
 #: ../../extending/embedding.rst:318
 msgid ""
@@ -362,3 +380,7 @@ msgid ""
 "tool to programmatically extract the configuration values that you will want"
 " to combine together.  For example:"
 msgstr ""
+"如果上述方案不起作用（不能保证对所有 Unix 类平台都生效；欢迎提出 :ref:`bug 报告<reporting-"
+"bugs>`），就得阅读系统关于动态链接的文档，并检查 Python 的 :file:`Makefile` （用 "
+":func:`sysconfig.get_makefile_filename` 找到所在位置）和编译参数。这时 :mod:`sysconfig` "
+"模块会是个有用的工具，可用编程方式提取需组合在一起的配置值。比如："
diff --git a/library/imaplib.po b/library/imaplib.po
@@ -236,13 +236,13 @@ msgstr ""
 
 #: ../../library/imaplib.rst:174
 msgid "IMAP4 Objects"
-msgstr ""
+msgstr "IMAP4 对象"
 
 #: ../../library/imaplib.rst:176
 msgid ""
 "All IMAP4rev1 commands are represented by methods of the same name, either "
 "upper-case or lower-case."
-msgstr ""
+msgstr "所有 IMAP4rev1 命令都表示为同名的方法，可以为大写或小写形式。"
 
 #: ../../library/imaplib.rst:179
 msgid ""
@@ -255,6 +255,10 @@ msgid ""
 "(eg: the *flags* argument to ``STORE``) then enclose the string in "
 "parentheses (eg: ``r'(\\Deleted)'``)."
 msgstr ""
+"命令的所有参数都会被转换为字符串，只有 ``AUTHENTICATE`` 例外，而, and the last argument to "
+"``APPEND`` 的最后一个参数会被作为 IMAP4 字面值传入。 如有必要 (字符串包含 IMAP4 协议中的敏感字符并且未加圆括号或双引号) "
+"每个字符串都会被转码。 但是，``LOGIN`` 命令的 *password* 参数总是会被转码。 如果你想让某个参数字符串免于被转码 (例如: "
+"``STORE`` 的 *flags* 参数) 则要为该字符串加上圆括号 (例如: ``r'(\\Deleted)'``)。"
 
 #: ../../library/imaplib.rst:187
 msgid ""
@@ -264,6 +268,9 @@ msgid ""
 "``bytes``, or a tuple. If a tuple, then the first part is the header of the "
 "response, and the second part contains the data (ie: 'literal' value)."
 msgstr ""
+"每条命令均返回一个元组: ``(type, [data, ...])`` 其中 *type* 通常为 ``'OK'`` 或 ``'NO'``，而 "
+"*data* 为来自命令响应的文本，或为来自命令的规定结果。 每个 *data* 均为 ``bytes`` 或者元组。 "
+"如果为元组，则其第一部分是响应的标头，而第二部分将包含数据 (例如: 'literal' 值)。"
 
 #: ../../library/imaplib.rst:193
 msgid ""
@@ -273,29 +280,33 @@ msgid ""
 "contiguous ranges separated by commas (``'1:3,6:9'``).  A range can contain "
 "an asterisk to indicate an infinite upper bound (``'3:*'``)."
 msgstr ""
+"以下命令的 *message_set* 选项为指定要操作的一条或多条消息的字符串。 它可以是一个简单的消息编号 (``'1'``)，一段消息编号区间 "
+"(``'2:4'``)，或者一组以逗号分隔的非连续区间 (``'1:3,6:9'``)。 区间可以包含一个星号来表示无限的上界 (``'3:*'``)。"
 
 #: ../../library/imaplib.rst:199
 msgid "An :class:`IMAP4` instance has the following methods:"
-msgstr ""
+msgstr ":class:`IMAP4` 实例具有下列方法:"
 
 #: ../../library/imaplib.rst:204
 msgid "Append *message* to named mailbox."
-msgstr ""
+msgstr "将 *message* 添加到指定的邮箱。"
 
 #: ../../library/imaplib.rst:209
 msgid "Authenticate command --- requires response processing."
-msgstr ""
+msgstr "认证命令 --- 要求对响应进行处理。"
 
 #: ../../library/imaplib.rst:211
 msgid ""
 "*mechanism* specifies which authentication mechanism is to be used - it "
 "should appear in the instance variable ``capabilities`` in the form "
 "``AUTH=mechanism``."
 msgstr ""
+"*mechanism* 指明要使用哪种认证机制 —— 它应当在实例变量 ``capabilities`` 中以 ``AUTH=mechanism`` "
+"的形式出现。"
 
 #: ../../library/imaplib.rst:214
 msgid "*authobject* must be a callable object::"
-msgstr ""
+msgstr "*authobject* 必须是一个可调用对象::"
 
 #: ../../library/imaplib.rst:218
 msgid ""
@@ -304,22 +315,24 @@ msgid ""
 "that will be base64 encoded and sent to the server.  It should return "
 "``None`` if the client abort response ``*`` should be sent instead."
 msgstr ""
+"它将被调用以便处理服务器连续响应；传给它的 *response* 参数将为 ``bytes`` 类型。 它应当返回 base64 编码的 "
+"``bytes`` *数据* 并发送给服务器。 或者在客户端中止响应时返回 ``None`` 并应改为发送 ``*``。"
 
 #: ../../library/imaplib.rst:223
 msgid ""
 "string usernames and passwords are now encoded to ``utf-8`` instead of being"
 " limited to ASCII."
-msgstr ""
+msgstr "字符串形式的用户名和密码现在会被执行 ``utf-8`` 编码而不限于 ASCII 字符。"
 
 #: ../../library/imaplib.rst:230
 msgid "Checkpoint mailbox on server."
-msgstr ""
+msgstr "为服务器上的邮箱设置检查点。"
 
 #: ../../library/imaplib.rst:235
 msgid ""
 "Close currently selected mailbox. Deleted messages are removed from writable"
 " mailbox. This is the recommended command before ``LOGOUT``."
-msgstr ""
+msgstr "关闭当前选定的邮箱。 已删除的消息会从可写邮箱中被移除。 在 ``LOGOUT`` 之前建议执行此命令。"
 
 #: ../../library/imaplib.rst:241
 msgid "Copy *message_set* messages onto end of *new_mailbox*."
