[po] auto sync

github-actions[bot] · github-actions[bot] · commit 71973e092e7c · 2020-03-11T07:30:36.000Z
diff --git a/howto/curses.po b/howto/curses.po
@@ -6,8 +6,9 @@
 # Translators:
 # Fei Yin <icebirds@163.com>, 2018
 # Junkai Shao <skaifun.dev@gmail.com>, 2018
-# Freesand Leo <yuqinju@163.com>, 2018
 # ppcfish <ppcfish@gmail.com>, 2019
+# Siyuan Xu <mf20070535@126.com>, 2020
+# Freesand Leo <yuqinju@163.com>, 2020
 # 
 #, fuzzy
 msgid ""
@@ -16,7 +17,7 @@ msgstr ""
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-02-09 12:40+0000\n"
 "PO-Revision-Date: 2017-02-16 17:44+0000\n"
-"Last-Translator: ppcfish <ppcfish@gmail.com>, 2019\n"
+"Last-Translator: Freesand Leo <yuqinju@163.com>, 2020\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"
@@ -146,6 +147,10 @@ msgid ""
 ":c:func:`mvwaddstr` into a single :meth:`~curses.window.addstr` method.  "
 "You'll see this covered in more detail later."
 msgstr ""
+"此 Python 模块相当简单地封装了 curses 提供的 C 函数；如果你已经熟悉在 C 语言中使用 curses 编程，把这些知识转移的 "
+"Python 是非常容易的。最大的差异在于 Python 中的接口通过把不同的 C 函数合并来让事情变得更简单，比如 "
+":c:func:`addstr`、:c:func:`mvaddstr` 和 :c:func:`mvwaddstr` 三个 C 函数被并入 "
+":meth:`~curses.window.addstr` 这一个方法。下文中会描述更多的细节。"
 
 #: ../../howto/curses.rst:76
 msgid ""
@@ -154,6 +159,9 @@ msgid ""
 "that, see the Python library guide's section on ncurses, and the C manual "
 "pages for ncurses.  It will, however, give you the basic ideas."
 msgstr ""
+"本 HOWTO 是关于使用 curses 和 Python 编写文本模式程序的概述。它并不被设计为一个 curses API "
+"的完整指南；如需完整指南，请参见 ncurses 的 Python 库指南章节和 ncurses 的 C 手册页。相对地，本 HOWTO "
+"将会给你一些基本思路。"
 
 #: ../../howto/curses.rst:83
 msgid "Starting and ending a curses application"
@@ -168,6 +176,9 @@ msgid ""
 "object representing the entire screen; this is usually called ``stdscr`` "
 "after the name of the corresponding C variable. ::"
 msgstr ""
+"在做任何事情之前，curses 必须先被初始化。可以通过调用函数 :func:`~curses.initscr` "
+"来实现，它将查明终端的类型，向终端发送任何必须的设置代码，并创建多种内部数据结构。如果此操作成功，:func:`initscr` "
+"将会返回一个代表整个屏幕的窗口对象；它通常会遵循对应的 C 变量名被称作 ``stdscr``："
 
 #: ../../howto/curses.rst:96
 msgid ""
@@ -176,13 +187,15 @@ msgid ""
 " circumstances.  This requires calling the :func:`~curses.noecho` function. "
 "::"
 msgstr ""
+"使用 curses 的应用程序通常会关闭按键自动上屏，目的是读取按键并只在特定情况下展示它们。这需要调用函数 "
+":func:`~curses.noecho`："
 
 #: ../../howto/curses.rst:103
 msgid ""
 "Applications will also commonly need to react to keys instantly, without "
 "requiring the Enter key to be pressed; this is called cbreak mode, as "
 "opposed to the usual buffered input mode. ::"
-msgstr ""
+msgstr "应用程序也会广泛地需要立即响应按键，而不需要按下回车键；这被称为 “cbreak” 模式，与通常的缓冲输入模式相对："
 
 #: ../../howto/curses.rst:109
 msgid ""
@@ -193,19 +206,22 @@ msgid ""
 ":const:`curses.KEY_LEFT`.  To get curses to do the job, you'll have to "
 "enable keypad mode. ::"
 msgstr ""
+"终端通常会以多字节转义序列的形式返回特殊按键，比如光标键和导航键比如 Page Up 键和 Home "
+"键。尽管你可以编写你的程序来应对这些序列，curses 能够代替你做到这件事，返回一个特殊值比如 "
+":const:`curses.KEY_LEFT`。为了让 curses 做这项工作，你需要启用 keypad 模式："
 
 #: ../../howto/curses.rst:118
 msgid ""
 "Terminating a curses application is much easier than starting one. You'll "
 "need to call::"
-msgstr ""
+msgstr "终止一个 curses 应用程序比建立一个容易得多，你只需要调用："
 
 #: ../../howto/curses.rst:125
 msgid ""
 "to reverse the curses-friendly terminal settings. Then call the "
 ":func:`~curses.endwin` function to restore the terminal to its original "
 "operating mode. ::"
-msgstr ""
+msgstr "来还原对终端作出的 curses 友好设置。然后，调用函数 :func:`~curses.endwin` 来将终端还原到它的原始操作模式："
 
 #: ../../howto/curses.rst:131
 msgid ""
@@ -215,12 +231,15 @@ msgid ""
 " raises an uncaught exception.  Keys are no longer echoed to the screen when"
 " you type them, for example, which makes using the shell difficult."
 msgstr ""
+"调试一个 curses 应用程序时常会发生，一个应用程序还未能还原终端到原本的状态就意外退出了，这会搅乱你的终端。在 Python "
+"中这常常会发生在你的代码中有 bug 并引发了一个未捕获的异常。当你尝试输入时按键不会上屏，这使得使用终端变得困难。"
 
 #: ../../howto/curses.rst:137
 msgid ""
 "In Python you can avoid these complications and make debugging much easier "
 "by importing the :func:`curses.wrapper` function and using it like this::"
 msgstr ""
+"在 Python 中你可以避免这些复杂问题并让调试变得更简单，只需要导入 :func:`curses.wrapper` 函数并像这样使用它："
 
 #: ../../howto/curses.rst:156
 msgid ""
@@ -234,17 +253,21 @@ msgid ""
 "be left in a funny state on exception and you'll be able to read the "
 "exception's message and traceback."
 msgstr ""
+"函数 :func:`~curses.wrapper` 接受一个可调用对象并首先进行上述初始化过程，在终端支持着色时还会初始化颜色。接着 "
+":func:`wrapper` 运行你提供的可调用对象。当该可调用对象返回时，:func:`wrapper` 会还原终端到初始状态。该可调用对象会在 "
+":keyword:`try`...\\ :keyword:`except` "
+"这样的结构内被调用，当它捕获到异常时，会先还原终端再重新引发这个异常。所以你的终端不会因为异常而被留在一个搞笑的状态，你也可以正常阅读异常消息和回溯信息。"
 
 #: ../../howto/curses.rst:168
 msgid "Windows and Pads"
-msgstr "Windows 和 Pad"
+msgstr "窗口和面板"
 
 #: ../../howto/curses.rst:170
 msgid ""
 "Windows are the basic abstraction in curses.  A window object represents a "
 "rectangular area of the screen, and supports methods to display text, erase "
 "it, allow the user to input strings, and so forth."
-msgstr ""
+msgstr "窗口是 curses 中的基本抽象。一个窗口对象表示了屏幕上的一个矩形区域，并且提供方法来显示文本、擦除文本、允许用户输入字符串等等。"
 
 #: ../../howto/curses.rst:174
 msgid ""
@@ -255,6 +278,9 @@ msgid ""
 ":func:`~curses.newwin` function creates a new window of a given size, "
 "returning the new window object. ::"
 msgstr ""
+"函数 :func:`~curses.initscr` 返回的 ``stdscr`` "
+"对象覆盖整个屏幕。许多程序可能只需要这一个窗口，但你可能希望把屏幕分割为多个更小的窗口，来分别重绘或者清楚它们。函数 "
+":func:`~curses.newwin` 根据给定的尺寸创建一个新窗口，并返回这个新的窗口对象："
 
 #: ../../howto/curses.rst:185
 msgid ""
@@ -265,6 +291,8 @@ msgid ""
 "difference from most other computer applications, but it's been part of "
 "curses since it was first written, and it's too late to change things now."
 msgstr ""
+"注意 curses 使用的坐标系统与寻常的不同。坐标始终是以 *y,x* 的顺序传递，并且左上角是坐标 (0,0)。这打破了正常的坐标处理约定，即 "
+"*x* 坐标在前。这是一个与其他计算机应用程序糟糕的差异，但这从 curses 最初被编写出来就已是它的一部分，现在想要修改它已为时已晚。"
 
 #: ../../howto/curses.rst:193
 msgid ""
@@ -273,6 +301,8 @@ msgid ""
 " *x* sizes.  Legal coordinates will then extend from ``(0,0)`` to "
 "``(curses.LINES - 1, curses.COLS - 1)``."
 msgstr ""
+"你的应用程序能够查明屏幕的尺寸，:data:`curses.LINES` 和 :data:`curses.COLS` 分别代表了 *y* 和 *x* "
+"方向上的尺寸。合理的坐标应位于 ``(0,0)`` 到 ``(curses.LINES - 1, curses.COLS - 1)`` 范围内。"
 
 #: ../../howto/curses.rst:198
 msgid ""
@@ -281,6 +311,8 @@ msgid ""
 ":meth:`~curses.window.refresh` method of window objects to update the "
 "screen."
 msgstr ""
+"当你调用一个方法来显示或擦除文本时，效果并不会立即显示。相反，你必须调用窗口对象的 :meth:`~curses.window.refresh` "
+"方法来更新屏幕。"
 
 #: ../../howto/curses.rst:203
 msgid ""
@@ -292,6 +324,9 @@ msgid ""
 "window and then clears the window, there's no need to send the original text"
 " because they're never visible."
 msgstr ""
+"这是因为 curses 最初是为 300 波特的龟速终端连接编写的；在这些终端上，压制重绘屏幕的时间就非常重要。相对地，当你调用 "
+":meth:`refresh` 时，curses "
+"会累积屏幕的修改并以效率最高的方式显示它们。打个比方，如果你的程序在一个窗口内显示一些文本然后清楚了这个窗口，那么这些原始文本不需要被发送，因为它们甚至不曾能被看见。"
 
 #: ../../howto/curses.rst:212
 msgid ""
@@ -303,6 +338,9 @@ msgid ""
 "``stdscr.refresh()`` or the :meth:`refresh` method of some other relevant "
 "window."
 msgstr ""
+"在实践中，显式地告诉 curses 来重绘一个窗口并不会太复杂化 curses "
+"编程。大部分程序会显示一堆内容然后等待按键或者其他某些用户侧动作。你要做的事情就是，保证屏幕在暂停并等待用户输入前被重绘，只需要先调用 "
+"``stdscr.refresh()`` 或者其他相关窗口的 :meth:`refresh` 方法。"
 
 #: ../../howto/curses.rst:220
 msgid ""
@@ -312,6 +350,7 @@ msgid ""
 "giving the coordinates of the on-screen area where a subsection of the pad "
 "will be displayed.  ::"
 msgstr ""
+"一个面板是一种特殊的窗口，它可以比实际的显示屏幕更大，并且能只显示它的一部分。创建面板需要指定面板的高度和宽度，但刷新一个面板需要给出屏幕坐标和面板的需要显示的局部。"
 
 #: ../../howto/curses.rst:241
 msgid ""
@@ -321,31 +360,35 @@ msgid ""
 "Beyond that difference, pads are exactly like ordinary windows and support "
 "the same methods."
 msgstr ""
+"此 :meth:`refresh` 调用会在屏幕坐标 (5,5) 到坐标 (20,75) 的矩形范围内显示面板的一个部分，被显示的部分在面板上的坐标是 "
+"(0,0)。除了上述差异，面板与常规的窗口相同，也支持相同的方法。"
 
 #: ../../howto/curses.rst:247
 msgid ""
 "If you have multiple windows and pads on screen there is a more efficient "
 "way to update the screen and prevent annoying screen flicker as each part of"
 " the screen gets updated.  :meth:`refresh` actually does two things:"
 msgstr ""
+"如果你在屏幕上有多个窗口和面板，有一个更有效率的方法来更新窗口，避免每个部分单独更新时烦人的屏幕闪烁。:meth:`refresh` 实际上做了两件事："
 
 #: ../../howto/curses.rst:252
 msgid ""
 "Calls the :meth:`~curses.window.noutrefresh` method of each window to update"
 " an underlying data structure representing the desired state of the screen."
-msgstr ""
+msgstr "调用每个窗口的  :meth:`~curses.window.noutrefresh` 方法来更新一个表达屏幕期望状态的底层的数据结构。"
 
 #: ../../howto/curses.rst:255
 msgid ""
 "Calls the function :func:`~curses.doupdate` function to change the physical "
 "screen to match the desired state recorded in the data structure."
-msgstr ""
+msgstr "调用函数 :func:`~curses.doupdate` 来改变物理屏幕来符合这个数据结构中记录的期望状态。"
 
 #: ../../howto/curses.rst:258
 msgid ""
 "Instead you can call :meth:`noutrefresh` on a number of windows to update "
 "the data structure, and then call :func:`doupdate` to update the screen."
 msgstr ""
+"你可以改为调用在多个窗口上 :meth:`noutrefresh` 方法来更新该数据结构，然后调用函数 :func:`doupdate` 来更新屏幕。"
 
 #: ../../howto/curses.rst:264
 msgid "Displaying Text"
@@ -361,6 +404,10 @@ msgid ""
 "allows specifying a window to use instead of using ``stdscr`` by default. "
 ":c:func:`mvwaddstr` allows specifying both a window and a coordinate."
 msgstr ""
+"从一名 C 语言程序员的视角来看，curses 有时看起来就像是一堆略有差异的函数组成的扭曲迷宫。举个例子，:c:func:`addstr` 在 "
+"``stdscr`` 窗口的当前光标位置显示一个字符串，而 :c:func:`mvaddstr` 则是先移动到一个给定的 y,x "
+"坐标再显示字符串。:c:func:`waddstr` 与 :c:func:`addstr` 类似，但允许指定一个窗口而非默认的 "
+"``stdscr``。:c:func:`mvwaddstr` 允许同时指定一个窗口和一个坐标。"
 
 #: ../../howto/curses.rst:275
 msgid ""
@@ -369,6 +416,8 @@ msgid ""
 ":meth:`~curses.window.addstr` accept multiple argument forms.  Usually there"
 " are four different forms."
 msgstr ""
+"幸运的是，Python 接口隐藏了所有这些细节。``stdscr`` 和其他任何窗口一样是一个窗口对象，并且诸如 "
+":meth:`~curses.window.addstr` 之类的方法接受多种参数形式。通常有四种形式。"
 
 #: ../../howto/curses.rst:281
 msgid "Form"
@@ -419,7 +468,7 @@ msgid ""
 "Attributes allow displaying text in highlighted forms such as boldface, "
 "underline, reverse code, or in color.  They'll be explained in more detail "
 "in the next subsection."
-msgstr ""
+msgstr "属性允许以突出显示形态显示文本，比如加粗、下划线、反相或添加颜色。这些属性将来下一小节细说。"
 
 #: ../../howto/curses.rst:302
 msgid ""
@@ -429,12 +478,16 @@ msgid ""
 "window's :attr:`encoding` attribute; this defaults to the default system "
 "encoding as returned by :func:`locale.getpreferredencoding`."
 msgstr ""
+"方法 :meth:`~curses.window.addstr` 接受一个 Python "
+"字符串或字节串作为用于显示的值。字节串的内容会被原样发送到终端。字符串会使用窗口的 :attr:`encoding` 属性值编码为字节，它默认为 "
+":func:`locale.getpreferredencoding` 返回的系统默认编码。"
 
 #: ../../howto/curses.rst:309
 msgid ""
 "The :meth:`~curses.window.addch` methods take a character, which can be "
 "either a string of length 1, a bytestring of length 1, or an integer."
 msgstr ""
+"方法 :meth:`~curses.window.addch` 接受一个字符，可以是长度为 1 的字符串，长度为 1 的字节串或者一个整数。"
 
 #: ../../howto/curses.rst:312
 msgid ""
@@ -443,6 +496,8 @@ msgid ""
 "symbol, and :const:`ACS_ULCORNER` is the upper left corner of a box (handy "
 "for drawing borders).  You can also use the appropriate Unicode character."
 msgstr ""
+"对于特殊扩展字符有一些常量，这些常量是大于 255 的整数。比如，:const:`ACS_PLMINUS` 是一个 “加减” "
+"符号，:const:`ACS_ULCORNER` 是一个框的左上角（方便绘制边界）。你也可以使用正确的 Unicode 字符。"
 
 #: ../../howto/curses.rst:318
 msgid ""
@@ -454,6 +509,8 @@ msgid ""
 "some location where it won't be distracting; it can be confusing to have the"
 " cursor blinking at some apparently random location."
 msgstr ""
+"窗口会记住上次操作之后光标所在位置，所以如果你忽略 *y,x* 坐标，字符串和字符会出现在上次操作结束的位置。你也可以通过 ``move(y,x)`` "
+"的方法来移动光标。因为一些终端始终会显示一个闪烁的光标，你可能会想要保证光标处于一些不会让人感到分心的位置。在看似随机的位置出现一个闪烁的光标会令人非常迷惑。"
 
 #: ../../howto/curses.rst:326
 msgid ""
@@ -464,6 +521,9 @@ msgid ""
 "attempt to suppress the flashing cursor, and you won't need to worry about "
 "leaving it in odd locations."
 msgstr ""
+"如果你的应用程序完全不需要一个闪烁的光标，你可以调用 ``curs_set(False)`` 来使它隐形。为与旧版本 curses "
+"的兼容性的关系，有函数 ``leaveok(bool)`` 作为 :func:`~curses.curs_set` 的等价替换。如果 *bool* "
+"是真值，curses 库会尝试移除闪烁光标，并且你也不必担心它会留在一些奇怪的位置。"
 
 #: ../../howto/curses.rst:335
 msgid "Attributes and Color"
@@ -476,6 +536,8 @@ msgid ""
 "to highlight certain words.  curses supports this by allowing you to specify"
 " an attribute for each cell on the screen."
 msgstr ""
+"字符可以以不同的方式显示。基于文本的应用程序常常以反相显示状态行，一个文本查看器可能需要突出显示某些单词。为了支持这种用法，curses "
+"允许你为屏幕上的每个单元指定一个属性值。"
 
 #: ../../howto/curses.rst:342
 msgid ""
@@ -486,6 +548,8 @@ msgid ""
 "being used, so it's safest to stick to the most commonly available "
 "attributes, listed here."
 msgstr ""
+"属性值是一个整数，它的每一个二进制位代表一个不同的属性。你可以尝试以多种不属性位组合来显示文本，但 curses "
+"不保证所有的组合都是有效的，或者看上去有明显不同。这一点取决于用户终端的能力，所以最稳妥的方式是只采用最常见的有效属性，见下表。"
 
 #: ../../howto/curses.rst:350
 msgid "Attribute"
@@ -521,7 +585,7 @@ msgstr ":const:`A_REVERSE`"
 
 #: ../../howto/curses.rst:358
 msgid "Reverse-video text"
-msgstr "反向视频文本"
+msgstr "反相显示文本"
 
 #: ../../howto/curses.rst:360
 msgid ":const:`A_STANDOUT`"
@@ -543,14 +607,15 @@ msgstr "带下划线的文字"
 msgid ""
 "So, to display a reverse-video status line on the top line of the screen, "
 "you could code::"
-msgstr ""
+msgstr "所以，为了在屏幕顶部显示一个反相的状态行，你可以这么编写："
 
 #: ../../howto/curses.rst:372
 msgid ""
 "The curses library also supports color on those terminals that provide it. "
 "The most common such terminal is probably the Linux console, followed by "
 "color xterms."
 msgstr ""
+"curses 库还支持在提供了颜色功能的终端上显示颜色的功能。最常见的提供颜色的终端很可能是 Linux 控制台，采用了 xterms 配色方案。"
 
 #: ../../howto/curses.rst:376
 msgid ""
@@ -563,6 +628,10 @@ msgid ""
 " to the British spelling, you'll have to resign yourself to misspelling it "
 "for the sake of these functions.)"
 msgstr ""
+"为了使用颜色，你必须在调用完函数 :func:`~curses.initscr` 后尽快调用函数 "
+":func:`~curses.start_color`，来初始化默认颜色集 (:func:`curses.wrapper` 函数自动完成了这一点)。 "
+"当它完成后，如果使用中的终端支持显示颜色， :func:`~curses.has_colors` 会返回真值。 （注意：curses 使用美式拼写 "
+"“color”，而不是英式／加拿大拼写 “colour”。如果你习惯了英式拼写，你需要避免自己在这些函数上拼写错误。）"
 
 #: ../../howto/curses.rst:386
 msgid ""
@@ -573,10 +642,13 @@ msgid ""
 "attributes such as :const:`A_REVERSE`, but again, such combinations are not "
 "guaranteed to work on all terminals."
 msgstr ""
+"curses 库维护一个有限数量的颜色对，包括一个前景（文本）色和一个背景色。你可以使用函数  :func:`~curses.color_pair` "
+"获得一个颜色对对应的属性值。它可以通过按位或运算与其他属性，比如 :const:`A_REVERSE` "
+"组合。但再说明一遍，这种组合并不保证在所有终端上都有效。"
 
 #: ../../howto/curses.rst:393
 msgid "An example, which displays a line of text using color pair 1::"
-msgstr ""
+msgstr "一个样例，用 1 号颜色对显示一行文本："
 
 #: ../../howto/curses.rst:398
 msgid ""
