# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2023, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# cdarlint <[email protected]>, 2021

# ww song <[email protected]>, 2021

# eric R <[email protected]>, 2021

# jaystone776 <[email protected]>, 2021

# Edward Ji <[email protected]>, 2021

# Vincent <[email protected]>, 2021

# Alpha Du <[email protected]>, 2021

# 叶浚安 <[email protected]>, 2021

# ppcfish <[email protected]>, 2021

# Trim21 <[email protected]>, 2021

# Yifan Sun, 2022

# Freesand Leo <[email protected]>, 2023

# Transifex Bot <>, 2023

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2023-08-04 14:13+0000\n"

"PO-Revision-Date: 2021-06-28 00:53+0000\n"

"Last-Translator: Transifex Bot <>, 2023\n"

"Language-Team: Chinese (China) (https://app.transifex.com/python-doc/teams/5390/zh_CN/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: zh_CN\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../install/index.rst:7

msgid "Installing Python Modules (Legacy version)"

msgstr "安装Python模块（旧版）"

#: ../../install/index.rst:0

msgid "Author"

msgstr "作者"

#: ../../install/index.rst:9

msgid "Greg Ward"

msgstr "Greg Ward"

#: ../../install/index.rst:15

msgid ""

"The entire ``distutils`` package has been deprecated and will be removed in "

"Python 3.12. This documentation is retained as a reference only, and will be"

" removed with the package. See the :ref:`What's New <distutils-deprecated>` "

"entry for more information."

msgstr ""

"整个 ``distutils`` 包已被弃用并将在 Python 3.12 中被移除。 此文档仅保留作参考，并将随包一起被移除。 更多信息请参阅 "

":ref:`有什么新变化 <distutils-deprecated>` 条目。"

#: ../../install/index.rst:23

msgid ":ref:`installing-index`"

msgstr ":ref:`installing-index`"

#: ../../install/index.rst:23

msgid ""

"The up to date module installation documentation. For regular Python usage, "

"you almost certainly want that document rather than this one."

msgstr "最新的模块安装文档。对于常规Python使用，你几乎肯定像使用该文档而非这个。"

#: ../../install/index.rst:28

msgid ""

"This document is being retained solely until the ``setuptools`` "

"documentation at https://setuptools.readthedocs.io/en/latest/setuptools.html"

" independently covers all of the relevant information currently included "

"here."

msgstr ""

"这篇文档是历史遗留文档，在 https://setuptools.readthedocs.io/en/latest/setuptools.html 上的"

" ``setuptools`` 文档独立涵盖此处包含的所有相关信息之后，将不再单独作为正式文档保留。"

#: ../../install/index.rst:34

msgid ""

"This guide only covers the basic tools for building and distributing "

"extensions that are provided as part of this version of Python. Third party "

"tools offer easier to use and more secure alternatives. Refer to the `quick "

"recommendations section <https://packaging.python.org/guides/tool-"

"recommendations/>`__ in the Python Packaging User Guide for more "

"information."

msgstr ""

"本指南仅介绍构建和分发扩展的基本工具，这些扩展是作为此Python版本的一部分提供的。 第三方工具提供更易于使用和更安全的替代方案。有关详细信息，请参阅"

" Python 打包用户指南中的 `快速推荐部分 <https://packaging.python.org/guides/tool-"

"recommendations/>`__ 。"

#: ../../install/index.rst:45

msgid "Introduction"

msgstr "概述"

#: ../../install/index.rst:47

msgid ""

"In Python 2.0, the ``distutils`` API was first added to the standard "

"library. This provided Linux distro maintainers with a standard way of "

"converting Python projects into Linux distro packages, and system "

"administrators with a standard way of installing them directly onto target "

"systems."

msgstr ""

"在Python 2.0中，``distutils`` API "

"首次被添加到标准库中。这向Linux发行版维护者提供了一个将Python项目转换为发行版软件包的标准方法，以及向系统管理员们提供了直接将这些软件包安装到目标系统的标准方法。"

#: ../../install/index.rst:52

msgid ""

"In the many years since Python 2.0 was released, tightly coupling the build "

"system and package installer to the language runtime release cycle has "

"turned out to be problematic, and it is now recommended that projects use "

"the ``pip`` package installer and the ``setuptools`` build system, rather "

"than using ``distutils`` directly."

msgstr ""

"自从很多年前 Python 2.0 发布，将构建系统和包安装器与语言运行时的释放循环紧密连接在一起产生了很多问题。现在推荐做法是在项目中使用 "

"``pip`` 包安装器和 ``setuptools`` 构建系统，而不是直接使用 ``distutils``。"

#: ../../install/index.rst:58

msgid ""

"See :ref:`installing-index` and :ref:`distributing-index` for more details."

msgstr "请参阅 :ref:`installing-index` 和 :ref:`distributing-index` 了解更多细节。"

#: ../../install/index.rst:60

msgid ""

"This legacy documentation is being retained only until we're confident that "

"the ``setuptools`` documentation covers everything needed."

msgstr "这个旧文档将被保留，至到我们相信 ``setuptools`` 覆盖了所有内容。"

#: ../../install/index.rst:66

msgid "Distutils based source distributions"

msgstr "基于 ``distutils`` 的源代码分发"

#: ../../install/index.rst:68

msgid ""

"If you download a module source distribution, you can tell pretty quickly if"

" it was packaged and distributed in the standard way, i.e. using the "

"Distutils. First, the distribution's name and version number will be "

"featured prominently in the name of the downloaded archive, e.g. "

":file:`foo-1.0.tar.gz` or :file:`widget-0.9.7.zip`. Next, the archive will "

"unpack into a similarly named directory: :file:`foo-1.0` or "

":file:`widget-0.9.7`. Additionally, the distribution will contain a setup "

"script :file:`setup.py`, and a file named :file:`README.txt` or possibly "

"just :file:`README`, which should explain that building and installing the "

"module distribution is a simple matter of running one command from a "

"terminal::"

msgstr ""

#: ../../install/index.rst:81

msgid ""

"For Windows, this command should be run from a command prompt window "

"(:menuselection:`Start --> Accessories`)::"

msgstr "Windows 用户应该使用命令提示符来运行命令(:menuselection:`Start --> Accessories`)::"

#: ../../install/index.rst:86

msgid ""

"If all these things are true, then you already know how to build and install"

" the modules you've just downloaded: Run the command above. Unless you need"

" to install things in a non-standard way or customize the build process, you"

" don't really need this manual. Or rather, the above command is everything "

"you need to get out of this manual."

msgstr ""

"如果这些事情都属实，那么您已经了解了如何构建和安装您已经下载的模块：只需运行如上的命令。除非您需要以非常规方式安装或者定制构建过程，您其实不需要本文档。更进一步说，以上命令就是您可以从文档中获得的全部。"

#: ../../install/index.rst:96

msgid "Standard Build and Install"

msgstr "标准构建及安装"

#: ../../install/index.rst:98

msgid ""

"As described in section :ref:`inst-new-standard`, building and installing a "

"module distribution using the Distutils is usually one simple command to run"

" from a terminal::"

msgstr ""

"正如 :ref:`inst-new-standard` 中所描述的那样，通过 Distutils "

"构建和安装发行的模块常常只需要在终端执行一个简单的命令。"

#: ../../install/index.rst:108

msgid "Platform variations"

msgstr "平台差异"

#: ../../install/index.rst:110

msgid ""

"You should always run the setup command from the distribution root "

"directory, i.e. the top-level subdirectory that the module source "

"distribution unpacks into. For example, if you've just downloaded a module "

"source distribution :file:`foo-1.0.tar.gz` onto a Unix system, the normal "

"thing to do is::"

msgstr ""

"您应当总是在分发文件的根目录处运行设置的命令，比如，模块分发的源代码最高的子目录。例如，如果您刚刚在 Unix "

"操作系统上下载了一个模块分发的源代码，您需要做的事："

#: ../../install/index.rst:119

msgid ""

"On Windows, you'd probably download :file:`foo-1.0.zip`. If you downloaded "

"the archive file to :file:`C:\\\\Temp`, then it would unpack into "

":file:`C:\\\\Temp\\\\foo-1.0`; you can use either an archive manipulator "

"with a graphical user interface (such as WinZip) or a command-line tool "

"(such as :program:`unzip` or :program:`pkunzip`) to unpack the archive. "

"Then, open a command prompt window and run::"

msgstr ""

#: ../../install/index.rst:133

msgid "Splitting the job up"

msgstr "拆分任务"

#: ../../install/index.rst:135

msgid ""

"Running ``setup.py install`` builds and installs all modules in one run. If"

" you prefer to work incrementally---especially useful if you want to "

"customize the build process, or if things are going wrong---you can use the "

"setup script to do one thing at a time. This is particularly helpful when "

"the build and install will be done by different users---for example, you "

"might want to build a module distribution and hand it off to a system "

"administrator for installation (or do it yourself, with super-user "

"privileges)."

msgstr ""

#: ../../install/index.rst:143

msgid ""

"For example, you can build everything in one step, and then install "

"everything in a second step, by invoking the setup script twice::"

msgstr ""

#: ../../install/index.rst:149

msgid ""

"If you do this, you will notice that running the :command:`install` command "

"first runs the :command:`build` command, which---in this case---quickly "

"notices that it has nothing to do, since everything in the :file:`build` "

"directory is up-to-date."

msgstr ""

#: ../../install/index.rst:154

msgid ""

"You may not need this ability to break things down often if all you do is "

"install modules downloaded off the 'net, but it's very handy for more "

"advanced tasks. If you get into distributing your own Python modules and "

"extensions, you'll run lots of individual Distutils commands on their own."

msgstr ""

#: ../../install/index.rst:163

msgid "How building works"

msgstr ""

#: ../../install/index.rst:165

msgid ""

"As implied above, the :command:`build` command is responsible for putting "

"the files to install into a *build directory*. By default, this is "

":file:`build` under the distribution root; if you're excessively concerned "

"with speed, or want to keep the source tree pristine, you can change the "

"build directory with the :option:`!--build-base` option. For example::"

msgstr ""

#: ../../install/index.rst:173

msgid ""

"(Or you could do this permanently with a directive in your system or "

"personal Distutils configuration file; see section :ref:`inst-config-"

"files`.) Normally, this isn't necessary."

msgstr ""

#: ../../install/index.rst:177

msgid "The default layout for the build tree is as follows::"

msgstr ""

#: ../../install/index.rst:184

msgid ""

"where ``<plat>`` expands to a brief description of the current OS/hardware "

"platform and Python version. The first form, with just a :file:`lib` "

"directory, is used for \"pure module distributions\"---that is, module "

"distributions that include only pure Python modules. If a module "

"distribution contains any extensions (modules written in C/C++), then the "

"second form, with two ``<plat>`` directories, is used. In that case, the "

":file:`temp.{plat}` directory holds temporary files generated by the "

"compile/link process that don't actually get installed. In either case, the"

" :file:`lib` (or :file:`lib.{plat}`) directory contains all Python modules "

"(pure Python and extensions) that will be installed."

msgstr ""

#: ../../install/index.rst:194

msgid ""

"In the future, more directories will be added to handle Python scripts, "

"documentation, binary executables, and whatever else is needed to handle the"

" job of installing Python modules and applications."

msgstr ""

#: ../../install/index.rst:202

msgid "How installation works"

msgstr ""

#: ../../install/index.rst:204

msgid ""

"After the :command:`build` command runs (whether you run it explicitly, or "

"the :command:`install` command does it for you), the work of the "

":command:`install` command is relatively simple: all it has to do is copy "

"everything under :file:`build/lib` (or :file:`build/lib.{plat}`) to your "

"chosen installation directory."

msgstr ""

#: ../../install/index.rst:210

msgid ""

"If you don't choose an installation directory---i.e., if you just run "

"``setup.py install``\\ ---then the :command:`install` command installs to "

"the standard location for third-party Python modules. This location varies "

"by platform and by how you built/installed Python itself. On Unix (and "

"macOS, which is also Unix-based), it also depends on whether the module "

"distribution being installed is pure Python or contains extensions (\"non-"

"pure\"):"

msgstr ""

#: ../../install/index.rst:220

msgid "Platform"

msgstr "平台"

#: ../../install/index.rst:220

msgid "Standard installation location"

msgstr "标准安装位置"

#: ../../install/index.rst:220

msgid "Default value"

msgstr "默认值"

#: ../../install/index.rst:220 ../../install/index.rst:746

#: ../../install/index.rst:758

msgid "Notes"

msgstr "备注"

#: ../../install/index.rst:222

msgid "Unix (pure)"

msgstr "（单一）Unix"

#: ../../install/index.rst:222 ../../install/index.rst:435

msgid ":file:`{prefix}/lib/python{X.Y}/site-packages`"

msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`"

#: ../../install/index.rst:222 ../../install/index.rst:224

msgid ":file:`/usr/local/lib/python{X.Y}/site-packages`"

msgstr ":file:`/usr/local/lib/python{X.Y}/site-packages`"

#: ../../install/index.rst:222 ../../install/index.rst:224

#: ../../install/index.rst:748

msgid "\\(1)"

msgstr "\\(1)"

#: ../../install/index.rst:224

msgid "Unix (non-pure)"

msgstr "（类）Unix"

#: ../../install/index.rst:224 ../../install/index.rst:436

msgid ":file:`{exec-prefix}/lib/python{X.Y}/site-packages`"

msgstr ":file:`{exec-prefix}/lib/python{X.Y}/site-packages`"

#: ../../install/index.rst:226

msgid "Windows"

msgstr "Windows"

#: ../../install/index.rst:226 ../../install/index.rst:487

msgid ":file:`{prefix}\\\\Lib\\\\site-packages`"

msgstr ":file:`{prefix}\\\\Lib\\\\site-packages`"

#: ../../install/index.rst:226

msgid ":file:`C:\\\\Python{XY}\\\\Lib\\\\site-packages`"

msgstr ":file:`C:\\\\Python{XY}\\\\Lib\\\\site-packages`"

#: ../../install/index.rst:226 ../../install/index.rst:750

msgid "\\(2)"

msgstr "\\(2)"

#: ../../install/index.rst:229 ../../install/index.rst:770

msgid "Notes:"

msgstr "注释："

#: ../../install/index.rst:232

msgid ""

"Most Linux distributions include Python as a standard part of the system, so"

" :file:`{prefix}` and :file:`{exec-prefix}` are usually both :file:`/usr` on"

" Linux. If you build Python yourself on Linux (or any Unix-like system), "

"the default :file:`{prefix}` and :file:`{exec-prefix}` are "

":file:`/usr/local`."

msgstr ""

#: ../../install/index.rst:238

msgid ""

"The default installation directory on Windows was :file:`C:\\\\Program "

"Files\\\\Python` under Python 1.6a1, 1.5.2, and earlier."

msgstr ""

#: ../../install/index.rst:241

msgid ""

":file:`{prefix}` and :file:`{exec-prefix}` stand for the directories that "

"Python is installed to, and where it finds its libraries at run-time. They "

"are always the same under Windows, and very often the same under Unix and "

"macOS. You can find out what your Python installation uses for "

":file:`{prefix}` and :file:`{exec-prefix}` by running Python in interactive "

"mode and typing a few simple commands. Under Unix, just type ``python`` at "

"the shell prompt. Under Windows, choose :menuselection:`Start --> Programs "

"--> Python X.Y --> Python (command line)`. Once the interpreter is "

"started, you type Python code at the prompt. For example, on my Linux "

"system, I type the three Python statements shown below, and get the output "

"as shown, to find out my :file:`{prefix}` and :file:`{exec-prefix}`:"

msgstr ""

#: ../../install/index.rst:263

msgid ""

"A few other placeholders are used in this document: :file:`{X.Y}` stands for"

" the version of Python, for example ``3.2``; :file:`{abiflags}` will be "

"replaced by the value of :data:`sys.abiflags` or the empty string for "

"platforms which don't define ABI flags; :file:`{distname}` will be replaced "

"by the name of the module distribution being installed. Dots and "

"capitalization are important in the paths; for example, a value that uses "

"``python3.2`` on UNIX will typically use ``Python32`` on Windows."

msgstr ""

#: ../../install/index.rst:271

msgid ""

"If you don't want to install modules to the standard location, or if you "

"don't have permission to write there, then you need to read about alternate "

"installations in section :ref:`inst-alt-install`. If you want to customize "

"your installation directories more heavily, see section :ref:`inst-custom-"

"install` on custom installations."

msgstr ""

#: ../../install/index.rst:281

msgid "Alternate Installation"

msgstr "可选安装形式"

#: ../../install/index.rst:283

msgid ""

"Often, it is necessary or desirable to install modules to a location other "

"than the standard location for third-party Python modules. For example, on "

"a Unix system you might not have permission to write to the standard third-"

"party module directory. Or you might wish to try out a module before making"

" it a standard part of your local Python installation. This is especially "

"true when upgrading a distribution already present: you want to make sure "

"your existing base of scripts still works with the new version before "

"actually upgrading."

msgstr ""

#: ../../install/index.rst:291

msgid ""

"The Distutils :command:`install` command is designed to make installing "

"module distributions to an alternate location simple and painless. The "

"basic idea is that you supply a base directory for the installation, and the"

" :command:`install` command picks a set of directories (called an "

"*installation scheme*) under this base directory in which to install files."

" The details differ across platforms, so read whichever of the following "

"sections applies to you."

msgstr ""

#: ../../install/index.rst:299

msgid ""

"Note that the various alternate installation schemes are mutually exclusive:"

" you can pass ``--user``, or ``--home``, or ``--prefix`` and ``--exec-"

"prefix``, or ``--install-base`` and ``--install-platbase``, but you can't "

"mix from these groups."

msgstr ""

#: ../../install/index.rst:308

msgid "Alternate installation: the user scheme"

msgstr "可选安装形式：用户方案"

#: ../../install/index.rst:310

msgid ""

"This scheme is designed to be the most convenient solution for users that "

"don't have write permission to the global site-packages directory or don't "

"want to install into it. It is enabled with a simple option::"

msgstr ""

"此方案被设计为针对没有全局 site-packages 目录写入权限或不想安装到该目录的用户的最便捷解决方案。 它可以通过一个简单的选项来启用::"

#: ../../install/index.rst:316

msgid ""

"Files will be installed into subdirectories of :const:`site.USER_BASE` "

"(written as :file:`{userbase}` hereafter). This scheme installs pure Python"

" modules and extension modules in the same location (also known as "

":const:`site.USER_SITE`). Here are the values for UNIX, including macOS:"

msgstr ""

#: ../../install/index.rst:322 ../../install/index.rst:333

#: ../../install/index.rst:384 ../../install/index.rst:433

#: ../../install/index.rst:485 ../../install/index.rst:510

#: ../../install/index.rst:746 ../../install/index.rst:758

msgid "Type of file"

msgstr "文件类型"

#: ../../install/index.rst:322 ../../install/index.rst:333

#: ../../install/index.rst:384 ../../install/index.rst:433

#: ../../install/index.rst:485

msgid "Installation directory"

msgstr "安装目录"

#: ../../install/index.rst:324 ../../install/index.rst:335

#: ../../install/index.rst:386 ../../install/index.rst:487

msgid "modules"

msgstr "模块"

#: ../../install/index.rst:324

msgid ":file:`{userbase}/lib/python{X.Y}/site-packages`"

msgstr ":file:`{userbase}/lib/python{X.Y}/site-packages`"

#: ../../install/index.rst:325 ../../install/index.rst:336

#: ../../install/index.rst:387 ../../install/index.rst:437

#: ../../install/index.rst:488 ../../install/index.rst:515

msgid "scripts"

msgstr "脚本"

#: ../../install/index.rst:325

msgid ":file:`{userbase}/bin`"

msgstr ":file:`{userbase}/bin`"

#: ../../install/index.rst:326 ../../install/index.rst:337

#: ../../install/index.rst:388 ../../install/index.rst:438

#: ../../install/index.rst:489 ../../install/index.rst:516

msgid "data"

msgstr "数据"

#: ../../install/index.rst:326 ../../install/index.rst:337

msgid ":file:`{userbase}`"

msgstr ":file:`{userbase}`"

#: ../../install/index.rst:327 ../../install/index.rst:338

#: ../../install/index.rst:389 ../../install/index.rst:439

#: ../../install/index.rst:490 ../../install/index.rst:517

msgid "C headers"

msgstr "C 头文件"

#: ../../install/index.rst:327

msgid ":file:`{userbase}/include/python{X.Y}{abiflags}/{distname}`"

msgstr ":file:`{userbase}/include/python{X.Y}{abiflags}/{distname}`"

#: ../../install/index.rst:330

msgid "And here are the values used on Windows:"

msgstr "以下是Windows上使用的值："

#: ../../install/index.rst:335

msgid ":file:`{userbase}\\\\Python{XY}\\\\site-packages`"

msgstr ":file:`{userbase}\\\\Python{XY}\\\\site-packages`"

#: ../../install/index.rst:336

msgid ":file:`{userbase}\\\\Python{XY}\\\\Scripts`"

msgstr ":file:`{userbase}\\\\Python{XY}\\\\Scripts`"

#: ../../install/index.rst:338

msgid ":file:`{userbase}\\\\Python{XY}\\\\Include\\\\{distname}`"

msgstr ":file:`{userbase}\\\\Python{XY}\\\\Include\\\\{distname}`"

#: ../../install/index.rst:341

msgid ""

"The advantage of using this scheme compared to the other ones described "

"below is that the user site-packages directory is under normal conditions "

"always included in :data:`sys.path` (see :mod:`site` for more information), "

"which means that there is no additional step to perform after running the "

":file:`setup.py` script to finalize the installation."

msgstr ""

#: ../../install/index.rst:347

msgid ""

"The :command:`build_ext` command also has a ``--user`` option to add "

":file:`{userbase}/include` to the compiler search path for header files and "

":file:`{userbase}/lib` to the compiler search path for libraries as well as "

"to the runtime search path for shared C libraries (rpath)."

msgstr ""

#: ../../install/index.rst:356

msgid "Alternate installation: the home scheme"

msgstr "可选安装形式：家目录方案"

#: ../../install/index.rst:358

msgid ""

"The idea behind the \"home scheme\" is that you build and maintain a "

"personal stash of Python modules. This scheme's name is derived from the "

"idea of a \"home\" directory on Unix, since it's not unusual for a Unix user"

" to make their home directory have a layout similar to :file:`/usr/` or "

":file:`/usr/local/`. This scheme can be used by anyone, regardless of the "

"operating system they are installing for."

msgstr ""

"“主方案”背后的理念是你可以构建并维护个人的 Python 模块集。 该方案的名称源自 Unix 上“主目录”的概念，因为通常 Unix "

"用户会将其主目录的布局设置为与 :file:`/usr/` 或 :file:`/usr/local/` 相似。 "

"任何人都可以使用该方案，无论其安装的操作系统是什么。"

#: ../../install/index.rst:365

msgid "Installing a new module distribution is as simple as ::"

msgstr ""

#: ../../install/index.rst:369

msgid ""

"where you can supply any directory you like for the :option:`!--home` "

"option. On Unix, lazy typists can just type a tilde (``~``); the "

":command:`install` command will expand this to your home directory::"

msgstr ""

#: ../../install/index.rst:375

msgid ""

"To make Python find the distributions installed with this scheme, you may "

"have to :ref:`modify Python's search path <inst-search-path>` or edit "

":mod:`!sitecustomize` (see :mod:`site`) to call :func:`site.addsitedir` or "

"edit :data:`sys.path`."

msgstr ""

#: ../../install/index.rst:380

msgid ""

"The :option:`!--home` option defines the installation base directory. Files"

" are installed to the following directories under the installation base as "

"follows:"

msgstr ""

#: ../../install/index.rst:386

msgid ":file:`{home}/lib/python`"

msgstr ":file:`{home}/lib/python`"

#: ../../install/index.rst:387

msgid ":file:`{home}/bin`"

msgstr ":file:`{home}/bin`"

#: ../../install/index.rst:388

msgid ":file:`{home}`"

msgstr ":file:`{home}`"

#: ../../install/index.rst:389

msgid ":file:`{home}/include/python/{distname}`"

msgstr ":file:`{home}/include/python/{distname}`"

#: ../../install/index.rst:392

msgid "(Mentally replace slashes with backslashes if you're on Windows.)"

msgstr "（如果你是使用 Windows 请将斜杠替换为反斜杠。）"

#: ../../install/index.rst:398

msgid "Alternate installation: Unix (the prefix scheme)"

msgstr "可选安装形式：Unix（前缀方案）"

#: ../../install/index.rst:400

msgid ""

"The \"prefix scheme\" is useful when you wish to use one Python installation"

" to perform the build/install (i.e., to run the setup script), but install "

"modules into the third-party module directory of a different Python "

"installation (or something that looks like a different Python installation)."

" If this sounds a trifle unusual, it is---that's why the user and home "

"schemes come before. However, there are at least two known cases where the "

"prefix scheme will be useful."

msgstr ""

"“前缀方案”适用于当你希望使用一个 Python 安装程序来执行构建/安装（即运行 setup 脚本），但需要将模块安装到另一个 Python "

"安装版（或看起来类似于另一个 Python 安装版）的第三方模块目录中的情况。 如果这听起来有点不寻常，确实如此 --- "

"这就是为什么要先介绍用户和主目录方案的原因。 然而，至少有两种已知的情况会用到前缀方案。"

#: ../../install/index.rst:407

msgid ""

"First, consider that many Linux distributions put Python in :file:`/usr`, "

"rather than the more traditional :file:`/usr/local`. This is entirely "

"appropriate, since in those cases Python is part of \"the system\" rather "

"than a local add-on. However, if you are installing Python modules from "

"source, you probably want them to go in :file:`/usr/local/lib/python2.{X}` "

"rather than :file:`/usr/lib/python2.{X}`. This can be done with ::"

msgstr ""

#: ../../install/index.rst:416

msgid ""

"Another possibility is a network filesystem where the name used to write to "

"a remote directory is different from the name used to read it: for example, "

"the Python interpreter accessed as :file:`/usr/local/bin/python` might "

"search for modules in :file:`/usr/local/lib/python2.{X}`, but those modules "

"would have to be installed to, say, "

":file:`/mnt/{@server}/export/lib/python2.{X}`. This could be done with ::"

msgstr ""

#: ../../install/index.rst:425

msgid ""

"In either case, the :option:`!--prefix` option defines the installation "

"base, and the :option:`!--exec-prefix` option defines the platform-specific "

"installation base, which is used for platform-specific files. (Currently, "

"this just means non-pure module distributions, but could be expanded to C "

"libraries, binary executables, etc.) If :option:`!--exec-prefix` is not "

"supplied, it defaults to :option:`!--prefix`. Files are installed as "

"follows:"

msgstr ""

#: ../../install/index.rst:435 ../../install/index.rst:512

msgid "Python modules"

msgstr "Python 模块"

#: ../../install/index.rst:436 ../../install/index.rst:513

msgid "extension modules"

msgstr "扩展模块"

#: ../../install/index.rst:437

msgid ":file:`{prefix}/bin`"

msgstr ":file:`{prefix}/bin`"

#: ../../install/index.rst:438 ../../install/index.rst:489

msgid ":file:`{prefix}`"

msgstr ":file:`{prefix}`"

#: ../../install/index.rst:439

msgid ":file:`{prefix}/include/python{X.Y}{abiflags}/{distname}`"

msgstr ":file:`{prefix}/include/python{X.Y}{abiflags}/{distname}`"

#: ../../install/index.rst:442

msgid ""

"There is no requirement that :option:`!--prefix` or :option:`!--exec-prefix`"

" actually point to an alternate Python installation; if the directories "

"listed above do not already exist, they are created at installation time."

msgstr ""

#: ../../install/index.rst:446

msgid ""

"Incidentally, the real reason the prefix scheme is important is simply that "

"a standard Unix installation uses the prefix scheme, but with :option:`!--"

"prefix` and :option:`!--exec-prefix` supplied by Python itself as "

"``sys.prefix`` and ``sys.exec_prefix``. Thus, you might think you'll never "

"use the prefix scheme, but every time you run ``python setup.py install`` "

"without any other options, you're using it."

msgstr ""

#: ../../install/index.rst:453

msgid ""

"Note that installing extensions to an alternate Python installation has no "

"effect on how those extensions are built: in particular, the Python header "

"files (:file:`Python.h` and friends) installed with the Python interpreter "

"used to run the setup script will be used in compiling extensions. It is "

"your responsibility to ensure that the interpreter used to run extensions "

"installed in this way is compatible with the interpreter used to build them."

" The best way to do this is to ensure that the two interpreters are the "

"same version of Python (possibly different builds, or possibly copies of the"

" same build). (Of course, if your :option:`!--prefix` and :option:`!--exec-"

"prefix` don't even point to an alternate Python installation, this is "

"immaterial.)"

msgstr ""

#: ../../install/index.rst:468

msgid "Alternate installation: Windows (the prefix scheme)"

msgstr ""

#: ../../install/index.rst:470

msgid ""

"Windows has no concept of a user's home directory, and since the standard "

"Python installation under Windows is simpler than under Unix, the :option:`!"

"--prefix` option has traditionally been used to install additional packages "

"in separate locations on Windows. ::"

msgstr ""

#: ../../install/index.rst:477

msgid ""

"to install modules to the :file:`\\\\Temp\\\\Python` directory on the "

"current drive."

msgstr ""

#: ../../install/index.rst:479

msgid ""

"The installation base is defined by the :option:`!--prefix` option; the "

":option:`!--exec-prefix` option is not supported under Windows, which means "

"that pure Python modules and extension modules are installed into the same "

"location. Files are installed as follows:"

msgstr ""

#: ../../install/index.rst:488

msgid ":file:`{prefix}\\\\Scripts`"

msgstr ":file:`{prefix}\\\\Scripts`"

#: ../../install/index.rst:490

msgid ":file:`{prefix}\\\\Include\\\\{distname}`"

msgstr ":file:`{prefix}\\\\Include\\\\{distname}`"

#: ../../install/index.rst:497

msgid "Custom Installation"

msgstr "自定义安装"

#: ../../install/index.rst:499

msgid ""

"Sometimes, the alternate installation schemes described in section "

":ref:`inst-alt-install` just don't do what you want. You might want to "

"tweak just one or two directories while keeping everything under the same "

"base directory, or you might want to completely redefine the installation "

"scheme. In either case, you're creating a *custom installation scheme*."

msgstr ""

#: ../../install/index.rst:505

msgid ""

"To create a custom installation scheme, you start with one of the alternate "

"schemes and override some of the installation directories used for the "

"various types of files, using these options:"

msgstr ""

#: ../../install/index.rst:510

msgid "Override option"

msgstr "覆盖选项"

#: ../../install/index.rst:512

msgid "``--install-purelib``"

msgstr "``--install-purelib``"

#: ../../install/index.rst:513

msgid "``--install-platlib``"

msgstr "``--install-platlib``"

#: ../../install/index.rst:514

msgid "all modules"

msgstr "所有模块"

#: ../../install/index.rst:514

msgid "``--install-lib``"

msgstr "``--install-lib``"

#: ../../install/index.rst:515

msgid "``--install-scripts``"

msgstr "``--install-scripts``"

#: ../../install/index.rst:516

msgid "``--install-data``"

msgstr "``--install-data``"

#: ../../install/index.rst:517

msgid "``--install-headers``"

msgstr "``--install-headers``"

#: ../../install/index.rst:520

msgid ""

"These override options can be relative, absolute, or explicitly defined in "

"terms of one of the installation base directories. (There are two "

"installation base directories, and they are normally the same---they only "

"differ when you use the Unix \"prefix scheme\" and supply different "

"``--prefix`` and ``--exec-prefix`` options; using ``--install-lib`` will "

"override values computed or given for ``--install-purelib`` and ``--install-"

"platlib``, and is recommended for schemes that don't make a difference "

"between Python and extension modules.)"

msgstr ""

#: ../../install/index.rst:529

msgid ""

"For example, say you're installing a module distribution to your home "

"directory under Unix---but you want scripts to go in :file:`~/scripts` "

"rather than :file:`~/bin`. As you might expect, you can override this "

"directory with the :option:`!--install-scripts` option; in this case, it "

"makes most sense to supply a relative path, which will be interpreted "

"relative to the installation base directory (your home directory, in this "

"case)::"

msgstr ""

#: ../../install/index.rst:538

msgid ""

"Another Unix example: suppose your Python installation was built and "

"installed with a prefix of :file:`/usr/local/python`, so under a standard "

"installation scripts will wind up in :file:`/usr/local/python/bin`. If you "

"want them in :file:`/usr/local/bin` instead, you would supply this absolute "

"directory for the :option:`!--install-scripts` option::"

msgstr ""

#: ../../install/index.rst:546

msgid ""

"(This performs an installation using the \"prefix scheme\", where the prefix"

" is whatever your Python interpreter was installed with--- "

":file:`/usr/local/python` in this case.)"

msgstr ""

#: ../../install/index.rst:550

msgid ""

"If you maintain Python on Windows, you might want third-party modules to "

"live in a subdirectory of :file:`{prefix}`, rather than right in "

":file:`{prefix}` itself. This is almost as easy as customizing the script "

"installation directory---you just have to remember that there are two types "

"of modules to worry about, Python and extension modules, which can "

"conveniently be both controlled by one option::"

msgstr ""

#: ../../install/index.rst:559

msgid ""

"The specified installation directory is relative to :file:`{prefix}`. Of "

"course, you also have to ensure that this directory is in Python's module "

"search path, such as by putting a :file:`.pth` file in a site directory (see"

" :mod:`site`). See section :ref:`inst-search-path` to find out how to "

"modify Python's search path."

msgstr ""

#: ../../install/index.rst:565

msgid ""

"If you want to define an entire installation scheme, you just have to supply"

" all of the installation directory options. The recommended way to do this "

"is to supply relative paths; for example, if you want to maintain all Python"

" module-related files under :file:`python` in your home directory, and you "

"want a separate directory for each platform that you use your home directory"

" from, you might define the following installation scheme::"

msgstr ""

#: ../../install/index.rst:578

msgid "or, equivalently, ::"

msgstr "或者，等价于 ::"

#: ../../install/index.rst:586

msgid ""

"``$PLAT`` is not (necessarily) an environment variable---it will be expanded"

" by the Distutils as it parses your command line options, just as it does "

"when parsing your configuration file(s)."

msgstr ""

#: ../../install/index.rst:590

msgid ""

"Obviously, specifying the entire installation scheme every time you install "

"a new module distribution would be very tedious. Thus, you can put these "

"options into your Distutils config file (see section :ref:`inst-config-"

"files`):"

msgstr ""

#: ../../install/index.rst:603

msgid "or, equivalently,"

msgstr "或者，等价于，"

#: ../../install/index.rst:614

msgid ""

"Note that these two are *not* equivalent if you supply a different "

"installation base directory when you run the setup script. For example, ::"

msgstr ""

#: ../../install/index.rst:619

msgid ""

"would install pure modules to :file:`/tmp/python/lib` in the first case, and"

" to :file:`/tmp/lib` in the second case. (For the second case, you probably"

" want to supply an installation base of :file:`/tmp/python`.)"

msgstr ""

#: ../../install/index.rst:623

msgid ""

"You probably noticed the use of ``$HOME`` and ``$PLAT`` in the sample "

"configuration file input. These are Distutils configuration variables, "

"which bear a strong resemblance to environment variables. In fact, you can "

"use environment variables in config files on platforms that have such a "

"notion but the Distutils additionally define a few extra variables that may "

"not be in your environment, such as ``$PLAT``. (And of course, on systems "

"that don't have environment variables, such as Mac OS 9, the configuration "

"variables supplied by the Distutils are the only ones you can use.) See "

"section :ref:`inst-config-files` for details."

msgstr ""

#: ../../install/index.rst:633

msgid ""

"When a :ref:`virtual environment <venv-def>` is activated, any options that "

"change the installation path will be ignored from all distutils "

"configuration files to prevent inadvertently installing projects outside of "

"the virtual environment."

msgstr ""

#: ../../install/index.rst:647

msgid "Modifying Python's Search Path"

msgstr "修改 Python 的搜索路径"

#: ../../install/index.rst:649

msgid ""

"When the Python interpreter executes an :keyword:`import` statement, it "

"searches for both Python code and extension modules along a search path. A "

"default value for the path is configured into the Python binary when the "

"interpreter is built. You can determine the path by importing the :mod:`sys`"

" module and printing the value of ``sys.path``. ::"

msgstr ""

#: ../../install/index.rst:666

msgid ""

"The null string in ``sys.path`` represents the current working directory."

msgstr ""

#: ../../install/index.rst:668

msgid ""

"The expected convention for locally installed packages is to put them in the"

" :file:`{...}/site-packages/` directory, but you may want to install Python "

"modules into some arbitrary directory. For example, your site may have a "

"convention of keeping all software related to the web server under "

":file:`/www`. Add-on Python modules might then belong in "

":file:`/www/python`, and in order to import them, this directory must be "

"added to ``sys.path``. There are several different ways to add the "

"directory."

msgstr ""

#: ../../install/index.rst:676

msgid ""

"The most convenient way is to add a path configuration file to a directory "

"that's already on Python's path, usually to the :file:`.../site-packages/` "

"directory. Path configuration files have an extension of :file:`.pth`, and "

"each line must contain a single path that will be appended to ``sys.path``."

" (Because the new paths are appended to ``sys.path``, modules in the added "

"directories will not override standard modules. This means you can't use "

"this mechanism for installing fixed versions of standard modules.)"

msgstr ""

#: ../../install/index.rst:684

msgid ""

"Paths can be absolute or relative, in which case they're relative to the "

"directory containing the :file:`.pth` file. See the documentation of the "

":mod:`site` module for more information."

msgstr ""

#: ../../install/index.rst:688

msgid ""

"A slightly less convenient way is to edit the :file:`site.py` file in "

"Python's standard library, and modify ``sys.path``. :file:`site.py` is "

"automatically imported when the Python interpreter is executed, unless the "

":option:`-S` switch is supplied to suppress this behaviour. So you could "

"simply edit :file:`site.py` and add two lines to it:"

msgstr ""

#: ../../install/index.rst:699

msgid ""

"However, if you reinstall the same minor version of Python (perhaps when "

"upgrading from 2.2 to 2.2.2, for example) :file:`site.py` will be "

"overwritten by the stock version. You'd have to remember that it was "

"modified and save a copy before doing the installation."

msgstr ""

#: ../../install/index.rst:704