# SOME DESCRIPTIVE TITLE.

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

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

#

# Translators:

# Leon H., 2017

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2023-07-29 10:36+0000\n"

"PO-Revision-Date: 2018-05-23 14:37+0000\n"

"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"

"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

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

"Content-Transfer-Encoding: 8bit\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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

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

msgid ""

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

msgstr ""

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

msgid ""

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

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

msgstr ""

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

msgid "Distutils based source distributions"

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

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

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

msgstr ""

#: ../../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 ""

#: ../../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 ""

#: ../../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 ""

#: ../../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

msgid ""

"There are two environment variables that can modify ``sys.path``. :envvar:"

"`PYTHONHOME` sets an alternate value for the prefix of the Python "

"installation. For example, if :envvar:`PYTHONHOME` is set to ``/www/"

"python``, the search path will be set to ``['', '/www/python/lib/pythonX."

"Y/', '/www/python/lib/pythonX.Y/plat-linux2', ...]``."

msgstr ""

#: ../../install/index.rst:710

msgid ""

"The :envvar:`PYTHONPATH` variable can be set to a list of paths that will be "

"added to the beginning of ``sys.path``. For example, if :envvar:"

"`PYTHONPATH` is set to ``/www/python:/opt/py``, the search path will begin "

"with ``['/www/python', '/opt/py']``. (Note that directories must exist in "

"order to be added to ``sys.path``; the :mod:`site` module removes paths that "

"don't exist.)"

msgstr ""

#: ../../install/index.rst:717

msgid ""

"Finally, ``sys.path`` is just a regular Python list, so any Python "

"application can modify it by adding or removing entries."

msgstr ""

#: ../../install/index.rst:724

msgid "Distutils Configuration Files"

msgstr ""

#: ../../install/index.rst:726

msgid ""

"As mentioned above, you can use Distutils configuration files to record "

"personal or site preferences for any Distutils options. That is, any option "

"to any command can be stored in one of two or three (depending on your "

"platform) configuration files, which will be consulted before the command-"

"line is parsed. This means that configuration files will override default "

"values, and the command-line will in turn override configuration files. "

"Furthermore, if multiple configuration files apply, values from \"earlier\" "

"files are overridden by \"later\" files."

msgstr ""

#: ../../install/index.rst:739