python
diff --git a/‎c-api/intro.po‎
Lines changed: 33 additions & 17 deletions b/‎c-api/intro.po‎
Lines changed: 33 additions & 17 deletions
@@ -7,6 +7,7 @@
 # Fei Yin <[email protected]>, 2018
 # Tony Tong <[email protected]>, 2018
 # ww song <[email protected]>, 2018
+# Freesand Leo <[email protected]>, 2018
 # 
 #, fuzzy
 msgid ""
@@ -15,7 +16,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2018-06-30 05:56+0900\n"
 "PO-Revision-Date: 2017-02-16 17:36+0000\n"
-"Last-Translator: ww song <sww4718168@gmail.com>, 2018\n"
+"Last-Translator: Freesand Leo <yuqinju@163.com>, 2018\n"
 "Language-Team: Chinese (China) (https://www.transifex.com/python-doc/teams/5390/zh_CN/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -38,7 +39,11 @@ msgid ""
 "probably the most common use.  The second reason is to use Python as a "
 "component in a larger application; this technique is generally referred to "
 "as :dfn:`embedding` Python in an application."
-msgstr "Python的应用程序接口(API)使C和C ++程序员可以在各种不同的级别访问Python解释器。"
+msgstr ""
+"Python 的应用编程接口（API）使得 C 和 C++ 程序员可以在多个层级上访问 Python 解释器。该 API 在 C++ "
+"中同样可用，但为简化描述，通常将其称为 Python/C API。使用 Python/C API 有两个基本的理由。第一个理由是为了特定目的而编写 "
+"*扩展模块*；它们是扩展 Python 解释器功能的 C 模块。这可能是最常见的使用场景。第二个理由是将 Python "
+"用作更大规模应用的组件；这种技巧通常被称为在一个应用中 :dfn:`embedding` Python。"
 
 #: ../../c-api/intro.rst:20
 msgid ""
@@ -48,6 +53,8 @@ msgid ""
 "applications since its early existence, the process of embedding Python is "
 "less straightforward than writing an extension."
 msgstr ""
+"编写扩展模块的过程相对来说更易于理解，可以以“菜谱”的形式分步骤介绍。使用某些工具可在一定程度上自动化这一过程。虽然人们在其他应用中嵌入 Python "
+"的做法早已有之，但嵌入 Python 的过程没有编写扩展模块那样方便直观。"
 
 #: ../../c-api/intro.rst:26
 msgid ""
@@ -57,11 +64,12 @@ msgid ""
 "become familiar with writing an extension before  attempting to embed Python"
 " in a real application."
 msgstr ""
-"无论您是嵌入还是扩展Python，许多API函数都是有用的；此外，嵌入Python的大多数应用程序也需要提供自定义扩展，因此在尝试将Python嵌入到实际应用程序之前熟悉编写扩展应该是个好主意。"
+"许多 API 函数在你嵌入或是扩展 Python 这两种场景下都能发挥作用；此外，大多数嵌入 Python "
+"的应用程序也需要提供自定义扩展，因此在尝试在实际应用中嵌入 Python 之前先熟悉编写扩展应该会是个好主意。"
 
 #: ../../c-api/intro.rst:34
 msgid "Coding standards"
-msgstr ""
+msgstr "代码标准"
 
 #: ../../c-api/intro.rst:36
 msgid ""
@@ -71,6 +79,9 @@ msgid ""
 "these conventions is not necessary for your own third party extension "
 "modules, unless you eventually expect to contribute them to Python."
 msgstr ""
+"如果你想要编写可包含于 CPython 的 C 代码，你 **必须** 遵循在 :PEP:`7` "
+"中定义的指导原则和标准。这些指导原则适用于任何你所要扩展的 Python 版本。在编写你自己的第三方扩展模块时可以不必遵循这些规范，除非你准备在日后向 "
+"Python 贡献这些模块。"
 
 #: ../../c-api/intro.rst:46
 msgid "Include Files"
@@ -80,7 +91,7 @@ msgstr "包含文件"
 msgid ""
 "All function, type and macro definitions needed to use the Python/C API are "
 "included in your code by the following line::"
-msgstr "使用Python / C API所需的所有函数，类型和宏定义都包含在您的代码中，如下所示："
+msgstr "使用 Python/C API 所需要的全部函数、类型和宏定义可通过下面这行语句包含到你的代码之中："
 
 #: ../../c-api/intro.rst:53
 msgid ""
@@ -97,8 +108,8 @@ msgid ""
 "standard headers on some systems, you *must* include :file:`Python.h` before"
 " any standard headers are included."
 msgstr ""
-"由于Python可能会定义一些影响某些系统上标准头文件的预处理器定义，因此在包含任何标准头文件之前，您*必须* include "
-"这个文件：`Python.h`。"
+"由于 Python 可能会定义一些能在某些系统上影响标准头文件的预处理器定义，因此在包含任何标准头文件之前，你 *必须* 先包含 "
+":file:`Python.h`。"
 
 #: ../../c-api/intro.rst:63
 msgid ""
@@ -108,7 +119,8 @@ msgid ""
 "implementation and should not be used by extension writers. Structure member"
 " names do not have a reserved prefix."
 msgstr ""
-"Python.h定义的所有成员可见名称（除了由包含的标准头定义的那些）都有一个前缀“Py``或``_Py``。以``_Py``开头的名称供Python实现内部使用，不应由编写扩展者使用。结构成员名称没有保留前缀。"
+"Python.h 所定义的全部用户可见名称（由包含的标准头文件所定义的除外）都带有前缀 ``Py`` 或者 ``_Py``。以 ``_Py`` "
+"打头的名称是供 Python 实现内部使用的，不应被扩展编写者使用。结构成员名称没有保留前缀。"
 
 #: ../../c-api/intro.rst:68
 msgid ""
@@ -117,8 +129,8 @@ msgid ""
 "user code to future Python versions, which may define additional names "
 "beginning with one of these prefixes."
 msgstr ""
-"**重要：**  "
-"用户代码永远不应该定义以``Py``或``_Py``开头的名称。这会使读者感到困惑，并危及用户代码对未来Python版本的可移植性，这些版本可能会定义以这些前缀之一开头的其他名称。"
+"**重要：**  用户代码永远不应该定义以 ``Py` `或 ``_Py`` 开头的名称。这会使读者感到困惑，并危及用户代码对未来 Python "
+"版本的可移植性，因为未来版本可能会额外定义以这些前缀之一开头的名称。"
 
 #: ../../c-api/intro.rst:73
 msgid ""
@@ -131,9 +143,12 @@ msgid ""
 ":file:`{prefix}/include`, where :envvar:`prefix` is the installation "
 "directory specified to the installer."
 msgstr ""
-"头文件通常与Python一起安装。在Unix上，它们位于以下目录：file:`{prefix}/include/pythonversion/`和：file:`{exec_prefix}/include/pythonversion/`，其中：环境变量`prefix`和环境变量`exec_prefix"
-" "
-"`由Python程序的相应参数定义：配置文件脚本和版本号是由系统决定。在Windows上，头文件安装在：`{prefix}/include`中，其中：环境变量`prefix`是为安装程序指定的安装目录。"
+"头文件通常会与 Python 一起安装。在 Unix "
+"上，它们位于以下目录：:file:`{prefix}/include/pythonversion/` 和 "
+":file:`{exec_prefix}/include/pythonversion/`，其中 :envvar:`prefix` 和 "
+":envvar:`exec_prefix` 是由向 Python 的 :program:`configure` 脚本传入的对应形参所定义，而 "
+"*version* 则为 ``'%d.%d' % sys.version_info[:2]``。在 Windows 上，头文件安装于 "
+":file:`{prefix}/include`，其中 :envvar:`prefix` 是向安装程序指定的安装目录。"
 
 #: ../../c-api/intro.rst:82
 msgid ""
@@ -144,17 +159,18 @@ msgid ""
 " :envvar:`prefix` include the platform specific headers from "
 ":envvar:`exec_prefix`."
 msgstr ""
-"要包含头文件，请将两个目录（如果不同）全都放在编译器的包含搜索路径上。*不要*将父目录放在搜索路径上，然后使用``#include "
-"<pythonX.Y/Python.h>``；这将在跨平台环境中不可用，因为基于平台独立的头文件需要明确指定环境变量：`prefix`，和平台执行环境变量：`exec_prefix`。"
+"要包含头文件，请将两个目录（如果不同）都放到你所用编译器的包含搜索路径中。请 *不要* 将父目录放入搜索路径然后使用 ``#include "
+"<pythonX.Y/Python.h>``；这将使得多平台编译不可用，因为 :envvar:`prefix` 下平台无关的头文件需要包含来自 "
+":envvar:`exec_prefix` 下特定平台的头文件。"
 
 #: ../../c-api/intro.rst:89
 msgid ""
 "C++ users should note that though the API is defined entirely using C, the "
 "header files do properly declare the entry points to be ``extern \"C\"``, so"
 " there is no need to do anything special to use the API from C++."
 msgstr ""
-"C ++用户应该注意，尽管API完全使用C定义，但是头文件正确地将入口点声明为``extern”C“``，因此不需要做任何特殊的事情来使用C "
-"++中的API。"
+"C++ 用户应该注意，尽管 API 是完全使用 C 来定义的，但头文件正确地将入口点声明为 ``extern \"C\"``，因此 API 在 C++ "
+"中使用此 API 不必再做任何特殊处理。"
 
 #: ../../c-api/intro.rst:95
 msgid "Useful macros"