index.po

# 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:
# Tetsuo Koyama <tkoyama010@gmail.com>, 2021
# mollinaca, 2021
# tomo, 2021
# Shin Saito, 2021
# Takeshi Nakazato, 2021
# 菊池 健志, 2023
# Arihiro TAKASE, 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: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\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 --- 日本語訳: Python ドキュメント翻訳プロジェクト"

#: ../../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`` パッケージ全体の使用は非推奨 (deprecated) であり、Python 3.12 "
"で削除されます。この文書は参照のために維持されており、パッケージとともに削除"
"されます。詳しくは :ref:`What's New <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 モジュールのインストールに関するドキュメントの最新版です。通常の "
"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 のバージョンの一部として提供される拡張のビルドと配布につ"
"いての基礎的なツールについてのみをカバーします。サードパーティによるツール"
"が、容易に使えてもっと安全な代替として使えるでしょう。もっと詳しい情報は "
"`quick recommendations section <https://packaging.python.org/guides/tool-"
"recommendations/>`__ にある Python パッケージングユーザガイドから得られます。"

#: ../../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 プロジェクトを 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 がリリースされてから何年もたち、ビルドシステムとパッケージのインス"
"トーラーを Python ランタイムのリリースサイクルと強く結合させることには問題が"
"あることがわかってきました。そして現在、プロジェクトは ``distutils`` を直接使"
"うよりも ``pip`` パッケージインストーラーと ``setuptools`` ビルドシステムを使"
"うことが推奨されています。"

#: ../../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 ""
"モジュールのソースコード配布物をダウンロードしたら、配布物が標準のやり方、す"
"なわち Distutils のやり方に従ってパッケージされて 配布されているかどうかすぐ"
"に分かります。Distutils の場合、まず配布物の名前とバージョン番号が、例えば :"
"file:`foo-1.0.tar.gz` や :file:`widget-0.9.7.zip` のように、ダウンロードされ"
"たアーカイブファイルの 名前にはっきりと反映されます。次に、アーカイブは同様の"
"名前のディレクトリ、例えば :file:`foo-1.0` や :file:`widget-0.9.7` に展開され"
"ます。さらに、配布物には setup スクリプト :file:`setup.py` が入っています。ま"
"た、 :file:`README.txt` 場合によっては :file:`README` という名前のファイルも"
"入っていて、そこには、モジュール配布物の構築とインストールは簡単で、このよう"
"にするだけだ、とするだけだ、という説明が書かれているはずです ::"

#: ../../install/index.rst:81
msgid ""
"For Windows, this command should be run from a command prompt window (:"
"menuselection:`Start --> Accessories`)::"
msgstr ""
"Windows ではこのコマンドは、コマンドプロンプトのウィンドウを開いて (:"
"menuselection:`スタート --> アクセサリ`)、このように実行するのに違いありませ"
"ん ::"

#: ../../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 ""
"setup コマンドは常に配布物ルートディレクトリ、すなわちモジュールのソース配布"
"物を展開した際のトップレベルのサブディレクトリ内で実行しなければなりません。"
"例えば、あるモジュールのソース配布物 :file:`foo-1.0.tar.gz` を 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 ""
"Windows では、おそらく :file:`foo-1.0.zip` をダウンロードしているでしょう。"
"アーカイブファイルを :file:`C:\\\\Temp` にダウンロードしたのなら、(WinZip の"
"ような) グラフィカルユーザインターフェースつきのアーカイブ操作ソフトや、 (:"
"program:`unzip` や :program:`pkunzip` のような) コマンドラインツールを使って"
"アーカイブを :file:`C:\\\\Temp\\\\foo-1.0` に展開します。次に、コマンドプロン"
"プトウィンドウを開いて、以下を実行します:"

#: ../../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 ""
"``setup.py install`` を実行すると、一度の実行で全てのモジュールをビルドしてイ"
"ンストールします。段階的に作業をしたい場合 --- ビルドプロセスをカスタマイズし"
"たり、作業がうまくいかない場合に特に便利です --- には、setup スクリプトに一度"
"に一つづつ作業を行わせるようにできます。この機能は、ビルドとインストールを異"
"なるユーザで行う場合にも便利です --- 例えば、モジュール配布物をビルドしておい"
"てシステム管理者に渡して (または、自分でスーパユーザになって)、インストールし"
"たくなるかもしれません."

#: ../../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 ""
"最初のステップでは全てをビルドしておき、次のステップで全てをインストールする"
"には、setup スクリプトを二度起動します::"

#: ../../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 ""
"この作業を行ってみれば、 :command:`install` コマンドを実行するとまず :"
"command:`build` コマンドを実行し、さらに --- この場合には --- :file:`build` "
"ディレクトリの中が全て最新の状態になっているので、 :command:`build` は何も行"
"わなくてよいと判断していることがわかるでしょう。"

#: ../../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 ""
"インターネットからダウンロードしたモジュールをインストールしたいだけなら、上"
"のように作業を分割する機能は必要ないかもしれませんが、この機能はより進んだ使"
"い方をする際にはとても便利です。自作の Python モジュールや拡張モジュールを配"
"布することになれば、個々の Distutils コマンドを自分で何度も実行することになる"
"でしょう。"

#: ../../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 ""
"上で示唆したように、 :command:`build` コマンドは、インストールすべきファイル"
"を *ビルドディレクトリ* に置く働きがあります。デフォルトでは、ビルドディレク"
"トリは配布物ルート下の  :file:`build` になります; システムの処理速度に強いこ"
"だわりがあったり、ソースツリーに指一本触れたくないのなら、 :option:`!--build-"
"base` オプションを使ってビルドディレクトリを変更できます。例えば::"

#: ../../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 ""
"(あるいは、システム全体向け、あるいは個人用の Distutils 設定ファイルにディレ"
"クティブを書いて、永続的に設定を変えられます; :ref:`inst-config-files` 節を参"
"照してください。)  通常は必要ない作業です。"

#: ../../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 ""
"``<plat>`` は、現在の OS/ハードウェアプラットフォームと Python のバージョンを"
"記述する短い文字列に展開されます。第一の :file:`lib` ディレクトリだけの形式"
"は、 \"pure モジュール配布物\" --- すなわち、pure Python モジュールだけの入っ"
"たモジュール配布物 --- の場合に使われます。モジュール配布物に何らかの拡張モ"
"ジュール (C/C++ で書かれたモジュール) が入っている場合、第二の ``<plat>`` 付"
"きディレクトリが二つある形式が使われます。この場合、  :file:`temp.{plat}` "
"ディレクトリには、コンパイル/リンク過程で生成され、実際にはインストールされな"
"い一時ファイルが収められます。どちらの場合にも、 :file:`lib` (または :file:"
"`lib.{plat}`)  ディレクトリには、最終的にインストールされることになる全ての "
"Python  モジュール (pure Python モジュールおよび拡張モジュール) が入ります。"

#: ../../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 ""
"今後、Python スクリプト、ドキュメント、バイナリ実行可能形式、その他 Python モ"
"ジュールやアプリケーションのインストール作業に必要なディレクトリが追加される"
"かもしれません。"

#: ../../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 ""
":command:`build` コマンドを実行した後 (明示的に実行した場合も、 :command:"
"`install` コマンドが代わりに実行してくれた場合も) は、 :command:`install` コ"
"マンドの仕事は比較的単純なもの: :file:`build/lib` (または :file:`build/lib."
"{plat}`) の下にあるもの全ての指定したインストールディレクトリへのコピー、にな"
"ります。"

#: ../../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 ""
"インストールディレクトリを選ばなかった場合 --- すなわち、 ``setup.py "
"install`` を実行しただけの場合 --- には、 :command:`install` コマンドはサード"
"パーティ製 Python モジュールを置くための標準の場所にインストールを行います。"
"この場所は、プラットフォームや、Python 自体をどのようにビルド/インストールし"
"たかで変わります。 Unix (と、Unix をベースとしたmacOS) では、インストールしよ"
"うとするモジュール配布物が pure Python なのか、拡張モジュールを含む (\"非 "
"pure\") のかによっても異なります:"

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

#: ../../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 (非 pure)"

#: ../../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 ""
"ほとんどの Linux ディストリビューションには、システムの標準インストール物とし"
"て Python が入っているので、 Linux では普通、 :file:`{prefix}` や :file:"
"`{exec-prefix}` はどちらも :file:`/usr`  になります。 Linux (または Unixライ"
"クなシステム) 上で自分で Python  をビルドした場合、デフォルトの :file:"
"`{prefix}` および :file:`{exec-prefix}` は :file:`/usr/local` になります。"

#: ../../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 ""
"Windows での Python のデフォルトインストールディレクトリは、 Python 1.6a1、 "
"1.5.2、およびそれ以前のバージョンでは :file:`C:\\\\Program Files\\\\Python` "
"です。"

#: ../../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 ""
":file:`{prefix}` および :file:`{exec-prefix}` は、 Python がインストールされ"
"ているディレクトリと、実行時にライブラリを探しにいく場所を表します。これらの"
"ディレクトリは、Windows では常に同じで、 Unixと macOS でもほぼ常に同じです。"
"自分の Python がどんな :file:`{prefix}` や :file:`{exec-prefix}` を使っている"
"かは、Python を対話モードで起動して、単純なコマンドをいくつか入力すればわかり"
"ます。 Windows では、 :menuselection:`スタート --> (すべての) プログラム --"
">  Python X.Y --> Python (command line)` を選びます。Unix では、シェルプロン"
"プトで単に ``python`` と入力します。インタプリタを起動すると、プロンプトに "
"Python コードを入力できます。例えば、著者の使っている Linux システムで、三つ"
"の Python 文を以下のように入力すると、出力から著者のシステムの :file:"
"`{prefix}` と :file:`{exec-prefix}` を得られます:"

#: ../../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 ""
"このドキュメントではほかにちょっとだけプレースホルダを使います:  :file:`{X.Y}"
"` は Python のバージョンを表し、例えば ``3.2`` です; :file:`{abiflags}` は :"
"data:`sys.abiflags` の値に置き換えられるか、プラットフォームが ABI フラグを定"
"義しない場合、空文字列に置き換えられます; :file:`{distname}` はインストールし"
"ようとしているモジュール配布物の名前に置き換えられます。ドットとキャピタライ"
"ズはパス内で重要です; 例えば UNIX では ``python3.2`` が使われる値が、Windows "
"では普通 ``Python32`` を使います。"

#: ../../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 ""
"モジュールを標準の場所にインストールしたくない場合や、標準の場所にインストー"
"ルするためのファイル権限を持っていない場合、 :ref:`inst-alt-install` 節にあ"
"る、別の場所へのインストール方法の説明を読んでください。インストール先のディ"
"レクトリを大幅にカスタマイズしければ、 :ref:`inst-custom-install` 節のカスタ"
"ムインストールに関する説明を読んでください。"

#: ../../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 ""
"しばしば、サードパーティ製 Python モジュールをインストールするための標準の場"
"所以外にモジュールをインストールしなければならなかったり、単にそうしたくなる"
"ときがあります。例えばUnix システムでは、標準のサードパーティ製モジュールディ"
"レクトリに対する書き込み権限を持っていないかもしれません。または、あるモ"
"ジュールを、ローカルで使っている Python に標準のモジュールの一部として組み込"
"む前にテストしてみたいと思うかもしれません。既存の配布物をアップグレードする"
"際には特にそうでしょう: 実際にアップグレードする前に、既存のスクリプトの基本"
"となる部分が新たなバージョンでも動作するか確認したいはずです。"

#: ../../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 ""
"Distutils の :command:`install` コマンドは、別の場所へ配布物をインストールす"
"る作業を単純で苦労のない作業にするように設計されています。基本的なアイデア"
"は、インストール先のベースディレクトリを指定しておき、 :command:`install` コ"
"マンドがそのベースディレクトリ下にファイル群をインストールするための一連の"
"ディレクトリ (*インストールスキーム : installation scheme*) を作成するという"
"ものです。詳細はプラットフォームによって異なるので、以下の節から自分のプラッ"
"トフォームに当てはまるものを読んでください。"

#: ../../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 ""
"色々な代替インストールスキームは相互に排他的であることに注意してください: "
"``--user``, または ``--home``, または ``--prefix`` と ``--exec-prefix``, また"
"は ``--install-base`` と ``--install-platbase`` を指定できますが、それらグ"
"ループを混ぜこぜには使えません。"

#: ../../install/index.rst:308
msgid "Alternate installation: the user scheme"
msgstr "別の場所へのインストール: user スキーム"

#: ../../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 ""
"このスキームが前述してきたほかのものと比較して有利なのは、ユーザの site-"
"packages ディレクトリが常に :data:`sys.path` に含まれる普通の状態にある(詳細"
"は :mod:`site` 参照)ということで、つまり :file:`setup.py` スクリプト後にイン"
"ストールを完成させるための特別なステップが不要ということです。"

#: ../../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 ""
"さらに、コンパイラがヘッダファイルを検索するための :file:`{userbase}/"
"include` 、ライブラリを検索するための :file:`{userbase}/lib` 、ランタイムの共"
"有ライブラリを探すためのパス(rpath)を追加するために、 :command:`build_ext` コ"
"マンドには ``--user`` オプションがあります。"

#: ../../install/index.rst:356
msgid "Alternate installation: the home scheme"
msgstr "別の場所へのインストール: home スキーム"

#: ../../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 ""
"\"home スキーム\" の背後にある考え方は、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 ""
"のようにします。このとき、 :option:`!--home` オプションを使ってディレクトリを"
"指定します。\n"
"Unix では、面倒臭がりの人は単にチルダ (``~``) をタイプするだけでかまいませ"
"ん;  :command:`install` コマンドがチルダをホームディレクトリに展開してくれま"
"す::"

#: ../../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 ""
":option:`!--home` オプションは、インストールのベースディレクトリを指定しま"
"す。\n"
"ファイルはインストールベース下の以下のディレクトリに保存されます:"

#: ../../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 (prefix スキーム)"

#: ../../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 のサードパーティ製モジュール置き場 (あるいは、そう見えるようなディレク"
"トリ構造) に、ビルドされた モジュールをインストールしたい場合には、\"prefix "
"スキーム\" が便利です。そんな作業はまったくありえそうにない、と思うなら、確か"
"にその通りです --- \"home スキーム\" を先に説明したのもそのためです。とはい"
"え、prefix スキームが有用なケースは少なくとも二つあります。"

#: ../../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 ""
"まず、多くの Linux ディストリビューションは、 Python を :file:`/usr/local` で"
"はなく :file:`/usr` に置いていることを考えてください。この場合は、 Python は"
"ローカルの計算機ごとのアドオン (add-on) ではなく、\"システム\" の一部となって"
"いるので、 :file:`/usr` に置くのは全く正当なことです。しかしながら、 Python "
"モジュールをソースコードからインストールしていると、モジュールを :file:`/usr/"
"lib/python2.{X}` ではなく :file:`/usr/local/lib/python2.{X}` に置きたいと思う"
"かもしれません。これを行うには、以下のように指定します ::"

#: ../../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 ""
"もう一つありえるのは、ネットワークファイルシステムにおいて、遠隔のディレクト"
"リに対する読み出しと書き込みの際に違う名前を使う場合です。例えば、 :file:`/"
"usr/local/bin/python` でアクセスするような Python  インタプリタは、 :file:`/"
"usr/local/lib/python2.{X}` からモジュールを探すでしょうが、モジュールは別の場"
"所、例えば :file:`/mnt/{@server}/export/lib/python2.{X}` にインストールしなけ"
"ればならないかもしれません。この場合には、以下のようにします ::"

#: ../../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 ""
"どちらの場合も、 :option:`!--prefix` オプションでインストール先のベースディレ"
"クトリが決まり、 :option:`!--exec-prefix` でプラットフォーム固有のファイルの"
"ための、プラットフォーム固有となるインストール先のベースディレクトリが決まり"
"ます。\n"
"(プラットフォーム固有のファイルとは、現状では単に非 pure モジュール配布物のこ"
"とを意味しますが、 C ライブラリやバイナリ実行可能形式などに拡張されるかもしれ"
"ません。)\n"
":option:`!--exec-prefix`  が指定されていなければ、デフォルトの :option:`!--"
"prefix` になります。\n"
"ファイルは以下のようにインストールされます:"

#: ../../install/index.rst:435 ../../install/index.rst:512
msgid "Python modules"
msgstr "pure 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 ""
":option:`!--prefix` や :option:`!--exec-prefix` が実際に他のインストール済み "
"Python の場所を指している必要はありません; 上に挙げたディレクトリがまだ存在し"
"なければ、インストール時に作成されます。"

#: ../../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 ""
"ちなみに、prefix スキームが重要な本当の理由は、単に標準の Unix  インストール"
"が prefix スキームを使っているからです。\n"
"ただし、そのときには、 :option:`!--prefix` や :option:`!--exec-prefix`  は "
"Python 自体が ``sys.prefix`` や ``sys.exec_prefix`` を使って決めます。\n"
"というわけで、読者は prefix スキームを決して使うことはあるまいと思っているか"
"もしれませんが、 ``python setup.py install``  をオプションを何もつけずに実行"
"していれば、常に prefix スキームを使っていることになるのです。"

#: ../../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 ""
"拡張モジュールを別のインストール済み Python にインストールしても、拡張モ"
"ジュールのビルド方法による影響を受けることはありません: 特に、拡張モジュール"
"をコンパイルする際には、 setup スクリプトを実行する際に使う Python インタプリ"
"タと一緒にインストールされている Python ヘッダファイル (:file:`Python.h`  と"
"その仲間たち) を使います。上で述べてきたやり方でインストールされた拡張モ"
"ジュールを実行するインタプリタと、インタプリタをビルドする際に用いた別のイン"
"タプリタとの互換性を保証するのはユーザの責任です。これを行うには、二つのイン"
"タプリタが同じバージョンの Python  (ビルドが違っていたり、同じビルドのコピー"
"ということもあり得ます) であるかどうかを確かめます。(もちろん、 :option:`!--"
"prefix` や  :option:`!--exec-prefix` が別のインストール済み Python の場所すら"
"指していなければどうにもなりません。)"

#: ../../install/index.rst:468
msgid "Alternate installation: Windows (the prefix scheme)"
msgstr "別の場所へのインストール (prefix を使う方法): Windows"

#: ../../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 ""
"Windows はユーザのホームディレクトリという概念がなく、 Windows 環境下で標準的"
"にインストールされた Python は Unixよりも単純な構成をしているので、 Windows "
"で追加のパッケージを別の場所に入れる場合には、伝統的に :option:`!--prefix` が"
"使われてきました。 ::"

#: ../../install/index.rst:477
msgid ""
"to install modules to the :file:`\\\\Temp\\\\Python` directory on the "
"current drive."
msgstr ""
"とすると、モジュールを現在のドライブの :file:`\\\\Temp\\\\Python` ディレクト"
"リにインストールします。"

#: ../../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 ""
"インストールベースディレクトリは、 :option:`!--prefix` オプションだけで決まり"
"ます; :option:`!--exec-prefix` オプションは、Windows ではサポートされていませ"
"ん。pure モジュールと拡張モジュールは同じ場所にインストールされます。ファイル"
"は以下のような構成でインストールされます:"

#: ../../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 ""
"たまに、 :ref:`inst-alt-install` 節で述べたような別の場所へのインストールス"
"キームが、自分のやりたいインストール方法と違うことがあります。もしかすると、"
"同じベースディレクトリ下にあるディレクトリのうち、一つか二つだけをいじりた"
"かったり、インストールスキームを完全に再定義したいと思うかもしれません。どち"
"らの場合にせよ、こうした操作では *カスタムのインストールスキーム* を作成する"
"ことになります。"

#: ../../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 ""
"これらの上書きオプションには相対パス、絶対パス、あるいはベースディレクトリの"
"ひとつとして明確に定義されたものを指定することができます（2つのベースディレク"
"トリがあり、通常それらは同一です。これらは Unix の prefix スキームを選択し、 "
"``--prefix`` と ``--exec-prefix`` オプションに異なるパスを指定した場合にだけ"
"同一でなくなります。  ``--install-lib`` を指定すると内部で設定された、あるい"
"は指定された ``--install-purelib`` と ``--install-platlib`` を上書きしますの"
"で、この方法が pure モジュールと拡張モジュールのインストール先を同一とするよ"
"うなスキームでは推奨されます）。"

#: ../../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 ""
"例えば、 Unix環境でモジュール配布物をホームディレクトリにインストールしたい "
"--- とはいえ、スクリプトは :file:`~/bin` ではなく :file:`~/scripts` に置きた"
"い --- とします。ご想像の通り、スクリプトを置くディレクトリは、 :option:`!--"
"install-scripts` オプションで上書きできます; この場合は相対パスで指定もでき、"
"インストールベースディレクトリ (この場合にはホームディレクトリ) からの相対パ"
"スとして解釈されます::"

#: ../../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 ""
"Unix 環境での例をもう一つ紹介します: インストール済みの Python が、 :file:`/"
"usr/local/python` を prefix にしてビルドされ、インストールされていて、標準の"
"インストールスクリプトは :file:`/usr/local/python/bin` に入るようになっている"
"とします。 :file:`/usr/local/bin` に入るようにしたければ、絶対パスを :option:"
"`!--install-scripts` オプションに与えて上書きすることになるでしょう::"

#: ../../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 ""
"(この例は prefix スキームによるインストールを実行します。ここで prefix は "
"Python インタープリタがインストールされている場所 --- この例では  :file:`/"
"usr/local/python` --- になります。)"

#: ../../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 ""
"Windows 上の Python を管理している場合、サードパーティ製のモジュールは :file:"
"`{prefix}` 直下ではなく、 :file:`{prefix}` 配下のサブディレクトリにインストー"
"ルしたいと考えるかもしれません。これはスクリプトのインストール先ディレクトリ"
"をカスタマイズするのとほとんど同じくらいに簡単です。 --- 覚えておかなければな"
"らないのは、Python には pure モジュールと拡張モジュールの2種類があり、これら"
"のインストール先はただひとつのオプションで簡単にコントロールできる、というこ"
"とだけです。"

#: ../../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 ""
"指定したインストール先ディレクトリは、 :file:`{prefix}` からの相対です。もち"
"ろん、 このディレクトリを :file:`.pth` ファイルに入れるなどして(:mod:`site` "
"参照)、Python のモジュール検索パス内に入るようにしなければなりません。Python "
"のモジュール検索パスを修正する方法は、  :ref:`inst-search-path` 節を参照して"
"ください。"

#: ../../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 ""
"インストールスキーム全体を定義したいのなら、全てのインストールディレクトリオ"
"プションを指定しなければなりません。この作業には、相対パスを使った指定を勧め"
"ます; 例えば、全ての Python モジュール関連ファイルをホームディレクトリ下の :"
"file:`python` ディレクトリの下に置き、そのホームディレクトリをマウントしてい"
"る各プラットフォームごとに別のディレクトリを置きたければ、以下のようにインス"
"トールスキームを定義します::"

#: ../../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 ""
"``$PLAT`` は、(必ずしも) 環境変数ではありません --- この表記は、Distutils が"
"コマンドラインオプションの解釈と同じやり方で展開します。設定ファイルを解釈す"
"る際と同じです。"

#: ../../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 ""
"言うまでもないことですが、毎回新たなモジュールディストリビューションをインス"
"トールする度にインストールスキーム全体の指定を行っていては面倒です。そこで、"
"オプションは Distutils 設定ファイル (:ref:`inst-config-files` 参照) にも指定"
"できます:"

#: ../../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 ""
"これら二つは、setup スクリプトを異なるインストールベースディレクトリから実行"
"した場合には同じには *ならない* ので注意してください。例えば、 ::"

#: ../../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 ""
"とすると、最初の書き方では pure モジュールが :file:`/tmp/python/lib`  に入"
"り、二番目の書き方では :file:`/tmp/lib` に入ります。(二番目のケースでは、イン"
"ストールベースを :file:`/tmp/python` に指定しようと考えるでしょう。)"

#: ../../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 ""
"読者は、設定ファイル例で、入力値に ``$HOME`` や ``$PLAT`` を使っていることに"
"気づいているかもしれませんね。これらは Distutils の設定変数で、環境変数を彷彿"
"とさせます。実際、この表記が使えるプラットフォーム上では、設定ファイル中に環"
"境変数を入れられますが、 Distutils は他にも、例えば ``$PLAT`` のようにおそら"
"くユーザの環境中にないような変数をいくつか持っています。(そしてもちろん、 "
"Mac OS 9 のような環境変数のないシステムでは、設定ファイル中で使える変数は "
"Distutils が提供しているものだけです。) 詳細は :ref:`inst-config-files` を参"
"照してください。"

#: ../../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 ""
":ref:`virtual environment <venv-def>` 下にいる場合、仮想環境の外に不注意でプ"
"ロジェクトをインストールしてしまうことを避けるために、インストールパスを変更"
"するあらゆるオプションは distutils の全ての設定ファイルによって無視されます。"

#: ../../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 ""
"Python インタプリタが :keyword:`import` 文を実行するとき、インタプリタは "
"Python コードや拡張モジュールをモジュール検索パス中から探します。検索パスのデ"
"フォルト値は、インタプリタをビルドする際に Python のバイナリ内に設定されま"
"す。検索パスは、 :mod:`sys` を import して、 ``sys.path`` を出力すればわかり"
"ます。 ::"

#: ../../install/index.rst:666
msgid ""
"The null string in ``sys.path`` represents the current working directory."
msgstr "``sys.path`` 内の空文字列は、現在の作業ディレクトリを表します。"

#: ../../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 ""
"ローカルでインストールされるパッケージは、 :file:`{...}/site-packages/` ディ"
"レクトリに入るのが決まりですが、ユーザはどこか任意のディレクトリに Python モ"
"ジュールをインストールしたいと思うかもしれません。例えば、自分のサイトでは、 "
"web サーバに関連する全てのソフトウェアを :file:`/www` に置くという決まりがあ"
"るかもしれません。そこで、アドオンの Python モジュールが :file:`/www/python` "
"置かれることになると、モジュールを import するためにはディレクトリを ``sys."
"path`` に追加せねばなりません。ディレクトリを検索パスに追加するには、いくつか"
"の異なる方法が存在します。"

#: ../../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 ""
"最も手軽な方法は、パス設定ファイルをすでに Python の検索パスに含まれるディレ"
"クトリ、通常は :file:`.../site-packages/` ディレクトリに置くというものです。"
"パス設定ファイルは拡張子が :file:`.pth` で、ファイルには ``sys.path`` に追加"
"するパスを一行に一つづつ記述しなければなりません。 (新たなパスは今の ``sys."
"path`` の後ろに追加されるので、追加されたディレクトリ内にあるモジュールが標準"
"のモジュールセットを上書きすることはありません。つまり、このメカニズムを使っ"
"て、標準モジュールに対する修正版のインストールはできないということです。)"

#: ../../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 ""
"パスは絶対パスでも相対パスでもよく、相対パスの場合には :file:`.pth` ファイル"
"のあるパスからの相対になります。詳しくは :mod:`site` モジュールを参照してくだ"
"さい。"

#: ../../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 ""
"やや便利さには欠けますが、Python の標準ライブラリ中にある  :file:`site.py` "
"ファイルを編集することでも、 ``sys.path`` を変更できます。 :file:`site.py` "
"は、 :option:`-S` スイッチを与えて抑制しないかぎり、Python インタープリタが実"
"行される際に自動的に import  されます。ただし、設定するには、単に :file:"
"`site.py` を編集して、例えば以下のような二行を加えます:"

#: ../../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 ""
"また、 ``sys.path`` を修正できる二つの環境変数があります。 :envvar:"
"`PYTHONHOME` を使うと、インストールされている Python のプレフィクスを別の値に"
"設定できます。例えば、 :envvar:`PYTHONHOME` を ``/www/python`` に設定すると、"
"検索パスは ``['', '/www/python/lib/pythonX.Y/', '/www/python/lib/pythonX.Y/"
"plat-linux2', ...]`` といった具合になります。"

#: ../../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 ""
":envvar:`PYTHONPATH` を使うと、 ``sys.path`` の先頭に一連のパスを追加できま"
"す。例えば、 :envvar:`PYTHONPATH` を ``/www/python:/opt/py`` に設定すると、検"
"索パスは ``['/www/python', '/opt/py']`` から始まります。  (``sys.path`` に"
"ディレクトリを追加するには、そのディレクトリが実在しなければなりません; :mod:"
"`site` は実在しないディレクトリを除去します。)"

#: ../../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 ""
"最後に、``sys.path`` はただの普通の Python のリストなので、どんな Python アプ"
"リケーションもエントリを追加したり除去したりといった修正を行えます。"

#: ../../install/index.rst:724
msgid "Distutils Configuration Files"
msgstr "Distutils 設定ファイル"

#: ../../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 ""
"上で述べたように、Distutils 設定ファイルを使えば、任意の  Distutils オプショ"
"ンに対して個人的な設定やサイト全体の設定を記録できます。すなわち、任意のコマ"
"ンドの任意のオプションを二つか三つ (プラットフォームによって異なります) の設"
"定ファイルに保存でき、コマンドラインを解釈する前にオプションを問い合わせさせ"
"るようにできます。つまり、設定ファイルはデフォルトの値を上書きし、さらにコマ"
"ンドライン上で与えた値が設定ファイルの内容を上書きするわけです。さらに、複数"
"の設定ファイルが適用されると、\"先に\" 適用されたファイルに指定されていた値"
"は \"後に\" 適用されたファイル内の値で上書きされます。"

#: ../../install/index.rst:739
msgid "Location and names of config files"
msgstr "設定ファイルの場所と名前"

#: ../../install/index.rst:741
msgid ""
"The names and locations of the configuration files vary slightly across "
"platforms.  On Unix and macOS, the three configuration files (in the order "
"they are processed) are:"
msgstr ""
"設定ファイルの名前と場所は、非常にわずかですがプラットフォーム間で異なりま"
"す。Unix と macOS では、三種類の設定ファイルは以下のようになります (処理され"
"る順に並んでいます):"

#: ../../install/index.rst:746 ../../install/index.rst:758
msgid "Location and filename"
msgstr "場所とファイル名"

#: ../../install/index.rst:748 ../../install/index.rst:760
msgid "system"
msgstr "system"

#: ../../install/index.rst:748
msgid ":file:`{prefix}/lib/python{ver}/distutils/distutils.cfg`"
msgstr ":file:`{prefix}/lib/python{ver}/distutils/distutils.cfg`"

#: ../../install/index.rst:750 ../../install/index.rst:762
msgid "personal"
msgstr "personal"

#: ../../install/index.rst:750
msgid ":file:`$HOME/.pydistutils.cfg`"
msgstr ":file:`$HOME/.pydistutils.cfg`"

#: ../../install/index.rst:752 ../../install/index.rst:764
msgid "local"
msgstr "local"

#: ../../install/index.rst:752 ../../install/index.rst:764
msgid ":file:`setup.cfg`"
msgstr ":file:`setup.cfg`"

#: ../../install/index.rst:752 ../../install/index.rst:764
msgid "\\(3)"
msgstr "\\(3)"

#: ../../install/index.rst:755
msgid "And on Windows, the configuration files are:"
msgstr "Windows では設定ファイルは以下のようになります:"

#: ../../install/index.rst:760
msgid ":file:`{prefix}\\\\Lib\\\\distutils\\\\distutils.cfg`"
msgstr ":file:`{prefix}\\\\Lib\\\\distutils\\\\distutils.cfg`"

#: ../../install/index.rst:760
msgid "\\(4)"
msgstr "\\(4)"

#: ../../install/index.rst:762
msgid ":file:`%HOME%\\\\pydistutils.cfg`"
msgstr ":file:`%HOME%\\\\pydistutils.cfg`"

#: ../../install/index.rst:762
msgid "\\(5)"
msgstr "\\(5)"

#: ../../install/index.rst:767
msgid ""
"On all platforms, the \"personal\" file can be temporarily disabled by "
"passing the ``--no-user-cfg`` option."
msgstr ""
"全てのプラットフォームにおいて、\"個人の\" ファイルは ``--no-user-cfg`` オプ"
"ションを使って一時的に無効にすることができます。"

#: ../../install/index.rst:773
msgid ""
"Strictly speaking, the system-wide configuration file lives in the directory "
"where the Distutils are installed; under Python 1.6 and later on Unix, this "
"is as shown. For Python 1.5.2, the Distutils will normally be installed to :"
"file:`{prefix}/lib/python1.5/site-packages/distutils`, so the system "
"configuration file should be put there under Python 1.5.2."
msgstr ""
"厳密に言えば、システム全体向けの設定ファイルは、 Distutils がインストールされ"
"ているディレクトリになります; Unixの Python 1.6 以降では、表の通りの場所にな"
"ります。 Python 1.5.2 では、 Distutils は通常 :file:`{prefix}/lib/python1.5/"
"site-packages/distutils` にインストールされるため、 Python 1.5.2 では設定ファ"
"イルをそこに置かなければなりません。"

#: ../../install/index.rst:780
msgid ""
"On Unix, if the :envvar:`HOME` environment variable is not defined, the "
"user's home directory will be determined with the :func:`~pwd.getpwuid` "
"function from the standard :mod:`pwd` module. This is done by the :func:`os."
"path.expanduser` function used by Distutils."
msgstr ""

#: ../../install/index.rst:786
msgid ""
"I.e., in the current directory (usually the location of the setup script)."
msgstr "現在のディレクトリ (通常は setup スクリプトがある場所) です。"

#: ../../install/index.rst:789
msgid ""
"(See also note (1).)  Under Python 1.6 and later, Python's default "
"\"installation prefix\" is :file:`C:\\\\Python`, so the system configuration "
"file is normally :file:`C:\\\\Python\\\\Lib\\\\distutils\\\\distutils.cfg`. "
"Under Python 1.5.2, the default prefix was :file:`C:\\\\Program Files\\"
"\\Python`, and the Distutils were not part of the standard library---so the "
"system configuration file would be :file:`C:\\\\Program Files\\\\Python\\"
"\\distutils\\\\distutils.cfg` in a standard Python 1.5.2 installation under "
"Windows."
msgstr ""
"(注記 (1) も参照してください)  Python 1.6 およびそれ以降のバージョンでは、 "
"Python のデフォルトの \"インストールプレフィクス\" は :file:`C:\\\\Python` な"
"ので、システム設定ファイルは通常 :file:`C:\\\\Python\\\\Lib\\\\distutils\\"
"\\distutils.cfg` になります。Python 1.5.2 ではデフォルトのプレフィクスは :"
"file:`C:\\\\Program Files\\\\Python` であり、Distutils は標準ライブラリの一部"
"ではありません --- 従って、システム設定ファイルは、 Windows 用の標準の "
"Python 1.5.2 では :file:`C:\\\\Program Files\\\\Python\\\\distutils\\"
"\\distutils.cfg` になります。"

#: ../../install/index.rst:798
msgid ""
"On Windows, if the :envvar:`HOME` environment variable is not defined, :"
"envvar:`USERPROFILE` then :envvar:`HOMEDRIVE` and :envvar:`HOMEPATH` will be "
"tried. This is done by the :func:`os.path.expanduser` function used by "
"Distutils."
msgstr ""
"Windows では、環境変数 :envvar:`HOME` が設定されていない場合、 :envvar:"
"`USERPROFILE` 、 :envvar:`HOMEDRIVE` 、 :envvar:`HOMEPATH` を順々に試します。"
"このとき同時に Distutils によって :func:`os.path.expanduser` が実行されます。"

#: ../../install/index.rst:807
msgid "Syntax of config files"
msgstr "設定ファイルの構文"

#: ../../install/index.rst:809
msgid ""
"The Distutils configuration files all have the same syntax.  The config "
"files are grouped into sections.  There is one section for each Distutils "
"command, plus a ``global`` section for global options that affect every "
"command.  Each section consists of one option per line, specified as "
"``option=value``."
msgstr ""
"Distutils 設定ファイルは、全て同じ構文をしています。設定ファイルはセクション"
"でグループ分けされています。各 Distutils コマンドごとにセクションがあり、それ"
"に加えて全てのコマンドに影響するグローバルオプションを設定するための "
"``global`` セクションがあります。各セクションには ``option=value`` の形で、一"
"行あたり一つのオプションを指定します。"

#: ../../install/index.rst:814
msgid ""
"For example, the following is a complete config file that just forces all "
"commands to run quietly by default:"
msgstr ""
"例えば、以下は全てのコマンドに対してデフォルトでメッセージを出さないよう強制"
"するための完全な設定ファイルです:"

#: ../../install/index.rst:822
msgid ""
"If this is installed as the system config file, it will affect all "
"processing of any Python module distribution by any user on the current "
"system.  If it is installed as your personal config file (on systems that "
"support them), it will affect only module distributions processed by you.  "
"And if it is used as the :file:`setup.cfg` for a particular module "
"distribution, it affects only that distribution."
msgstr ""
"この内容のファイルがシステム全体用の設定ファイルとしてインストールされていれ"
"ば、そのシステムの全てのユーザによる全ての Python モジュール配布物に対する処"
"理に影響します。ファイルが (個人用の設定をサポートしているシステムで) 個人用"
"の設定ファイルとしてインストールされていれば、そのユーザが処理するモジュール"
"配布物にのみ影響します。この内容を特定のモジュール配布物の :file:`setup.cfg` "
"として使えば、その配布物だけに影響します。"

#: ../../install/index.rst:829
msgid ""
"You could override the default \"build base\" directory and make the :"
"command:`build\\*` commands always forcibly rebuild all files with the "
"following:"
msgstr ""
"以下のようにして、デフォルトの \"ビルドベース\" ディレクトリをオーバーライド"
"したり、 :command:`build\\*` コマンドが常に強制的にリビルドを行うようにもでき"
"ます:"

#: ../../install/index.rst:839
msgid "which corresponds to the command-line arguments ::"
msgstr "この設定は、コマンドライン引数の ::"

#: ../../install/index.rst:843
msgid ""
"except that including the :command:`build` command on the command-line means "
"that command will be run.  Including a particular command in config files "
"has no such implication; it only means that if the command is run, the "
"options in the config file will apply.  (Or if other commands that derive "
"values from it are run, they will use the values in the config file.)"
msgstr ""
"に対応します。ただし、後者ではコマンドライン上で :command:`build`  コマンドを"
"含めて、そのコマンドを実行するよう意味しているところが違います。特定のコマン"
"ドに対するオプションを設定ファイルに含めると、このような関連付けの必要はなく"
"なります; あるコマンドが実行されると、そのコマンドに対するオプションが適用さ"
"れます。 (また、設定ファイル内からオプションを取得するような他のコマンドを実"
"行した場合、それらのコマンドもまた設定ファイル内の対応するオプションの値を使"
"います。)"

#: ../../install/index.rst:849
msgid ""
"You can find out the complete list of options for any command using the :"
"option:`!--help` option, e.g.::"
msgstr ""
"あるコマンドに対するオプションの完全なリストは、例えば以下のように、 :option:"
"`!--help` を使って調べます::"

#: ../../install/index.rst:854
msgid ""
"and you can find out the complete list of global options by using :option:"
"`!--help` without a command::"
msgstr ""
"グローバルオプションの完全なリストを得るには、コマンドを指定せずに :option:"
"`!--help` オプションを使います::"

#: ../../install/index.rst:859
msgid ""
"See also the \"Reference\" section of the \"Distributing Python Modules\" "
"manual."
msgstr ""
"\"Python モジュールの配布\" マニュアルの、\"リファレンスマニュアル\" の節も参"
"照してください。"

#: ../../install/index.rst:865
msgid "Building Extensions: Tips and Tricks"
msgstr "拡張モジュールのビルド: 小技と豆知識"

#: ../../install/index.rst:867
msgid ""
"Whenever possible, the Distutils try to use the configuration information "
"made available by the Python interpreter used to run the :file:`setup.py` "
"script. For example, the same compiler and linker flags used to compile "
"Python will also be used for compiling extensions.  Usually this will work "
"well, but in complicated situations this might be inappropriate.  This "
"section discusses how to override the usual Distutils behaviour."
msgstr ""
"Distutils は、可能なときにはいつでも、 :file:`setup.py` スクリプトを実行する "
"Python インタプリタが提供する設定情報を使おうとします。例えば、拡張モジュール"
"をコンパイルする際には、コンパイラやリンカのフラグには Python をコンパイルし"
"た際と同じものが使われます。通常、この設定はうまくいきますが、状況が複雑にな"
"ると不適切な設定になることもあります。この節では、通常の Distutils の動作を"
"オーバライドする方法について議論します。"

#: ../../install/index.rst:878
msgid "Tweaking compiler/linker flags"
msgstr "コンパイラ/リンカのフラグをいじるには"

#: ../../install/index.rst:880
msgid ""
"Compiling a Python extension written in C or C++ will sometimes require "
"specifying custom flags for the compiler and linker in order to use a "
"particular library or produce a special kind of object code. This is "
"especially true if the extension hasn't been tested on your platform, or if "
"you're trying to cross-compile Python."
msgstr ""
"C や C++ で書かれた Python 拡張をコンパイルする際、しばしば特定のライブラリを"
"使ったり、特定の種類のオブジェクトコードを生成したりする上で、コンパイラやリ"
"ンカに与えるフラグをカスタマイズする必要があります。ある拡張モジュールが自分"
"のプラットフォームではテストされていなかったり、クロスコンパイルを行わねばな"
"らない場合にはこれが当てはまります。"

#: ../../install/index.rst:886
msgid ""
"In the most general case, the extension author might have foreseen that "
"compiling the extensions would be complicated, and provided a :file:`Setup` "
"file for you to edit.  This will likely only be done if the module "
"distribution contains many separate extension modules, or if they often "
"require elaborate sets of compiler flags in order to work."
msgstr ""
"最も一般的なケースでは、拡張モジュールの作者はすでに拡張モジュールのコンパイ"
"ルが複雑になることを見越していて、 :file:`Setup` ファイルを提供して編集できる"
"ようにしています。 :file:`Setup` ファイルの編集は、モジュール配布物に多くの個"
"別の拡張モジュールがあったり、コンパイラに拡張モジュールをコンパイルさせるた"
"めに細かくフラグをセットする必要があるような場合にのみ行うことになるでしょ"
"う。"

#: ../../install/index.rst:892
msgid ""
"A :file:`Setup` file, if present, is parsed in order to get a list of "
"extensions to build.  Each line in a :file:`Setup` describes a single "
"module.  Lines have the following structure::"
msgstr ""
":file:`Setup` ファイルが存在する場合、ビルドするべき拡張モジュールのリストを"
"得るために解釈されます。 :file:`Setup` ファイルの各行には単一のモジュールを書"
"きます。各行は以下のような構造をとります::"

#: ../../install/index.rst:899
msgid "Let's examine each of the fields in turn."
msgstr "次に、各フィールドについて見てみましょう。"

#: ../../install/index.rst:901
msgid ""
"*module* is the name of the extension module to be built, and should be a "
"valid Python identifier.  You can't just change this in order to rename a "
"module (edits to the source code would also be needed), so this should be "
"left alone."
msgstr ""
"*module* はビルドする拡張モジュールの名前で、Python の識別子名として有効でな"
"ければなりません。モジュールの名前変更は、このフィールドを変えるだけではでき"
"ない (ソースコードの編集も必要です)  ので、このフィールドに手を加えるべきでは"
"ありません。"

#: ../../install/index.rst:905
msgid ""
"*sourcefile* is anything that's likely to be a source code file, at least "
"judging by the filename.  Filenames ending in :file:`.c` are assumed to be "
"written in C, filenames ending in :file:`.C`, :file:`.cc`, and :file:`.c++` "
"are assumed to be C++, and filenames ending in :file:`.m` or :file:`.mm` are "
"assumed to be in Objective C."
msgstr ""
"*sourcefile* は、少なくともファイル名から何の言語で書かれているかがわかるよう"
"になっているソースコードファイル名です。 :file:`.c` で終わるファイルは C で書"
"かれているとみなされ、 :file:`.C` 、 :file:`.cc` 、および :file:`.c++` で終わ"
"るファイルは C++ で書かれているとみなされます。 :file:`.m` や :file:`.mm` で"
"終わるファイルは Objective C で書かれているとみなされます。"

#: ../../install/index.rst:911
msgid ""
"*cpparg* is an argument for the C preprocessor,  and is anything starting "
"with :option:`!-I`, :option:`!-D`, :option:`!-U` or :option:`!-C`."
msgstr ""
"*cpparg* は C プリプロセッサへの引数で、 :option:`!-I` 、 :option:`!-D` 、 :"
"option:`!-U` または :option:`!-C` のいずれかから始まる文字列です。"

#: ../../install/index.rst:914
msgid ""
"*library* is anything ending in :file:`.a` or beginning with :option:`!-l` "
"or :option:`!-L`."
msgstr ""
"*library* は :file:`.a` で終わるか、 :option:`!-l` または :option:`!-L` のい"
"ずれかから始まる文字列です。"

#: ../../install/index.rst:917
msgid ""
"If a particular platform requires a special library on your platform, you "
"can add it by editing the :file:`Setup` file and running ``python setup.py "
"build``. For example, if the module defined by the line ::"
msgstr ""
"特定のプラットフォームにおいて、プラットフォーム上の特殊なライブラリが必要な"
"場合、 :file:`Setup` ファイルを編集して ``python setup.py build`` を実行すれ"
"ばライブラリを追加できます。例えば、以下の行 ::"

#: ../../install/index.rst:923
msgid ""
"must be linked with the math library :file:`libm.a` on your platform, simply "
"add :option:`!-lm` to the line::"
msgstr ""
"で定義されたモジュールを、自分のプラットフォーム上の数学ライブラリ :file:"
"`libm.a` とリンクしなければならない場合、 :file:`Setup` 内の行に :option:`!-"
"lm` を追加するだけです::"

#: ../../install/index.rst:928
msgid ""
"Arbitrary switches intended for the compiler or the linker can be supplied "
"with the :option:`!-Xcompiler` *arg* and :option:`!-Xlinker` *arg* options::"
msgstr ""
"コンパイラやリンカ向けの任意のスイッチオプションは、 :option:`!-Xcompiler` "
"*arg* や :option:`!-Xlinker` *arg* オプションで与えます::"

#: ../../install/index.rst:933
msgid ""
"The next option after :option:`!-Xcompiler` and :option:`!-Xlinker` will be "
"appended to the proper command line, so in the above example the compiler "
"will be passed the :option:`!-o32` option, and the linker will be passed :"
"option:`!-shared`.  If a compiler option requires an argument, you'll have "
"to supply multiple :option:`!-Xcompiler` options; for example, to pass ``-x "
"c++`` the :file:`Setup` file would have to contain ``-Xcompiler -x -"
"Xcompiler c++``."
msgstr ""
":option:`!-Xcompiler` および :option:`!-Xlinker` の後にくるオプションは、それ"
"ぞれ適切なコマンドラインに追加されます。従って、上の例では、コンパイラには :"
"option:`!-o32` オプションが渡され、リンカには :option:`!-shared` が渡されま"
"す。コンパイラオプションに引数が必要な場合、複数の :option:`!-Xcompiler`  オ"
"プションを与えます; 例えば、 ``-x c++`` を渡すには、 :file:`Setup` ファイルに"
"は ``-Xcompiler -x -Xcompiler c++`` を渡さねばなりません。"

#: ../../install/index.rst:940
msgid ""
"Compiler flags can also be supplied through setting the :envvar:`CFLAGS` "
"environment variable.  If set, the contents of :envvar:`CFLAGS` will be "
"added to the compiler flags specified in the  :file:`Setup` file."
msgstr ""
"コンパイラフラグは、環境変数 :envvar:`CFLAGS` の設定でも与えられます。 :"
"envvar:`CFLAGS` が設定されていれば、 :file:`Setup` ファイル内で指定されている"
"コンパイラフラグに :envvar:`CFLAGS` の内容が追加されます。"

#: ../../install/index.rst:948
msgid "Using non-Microsoft compilers on Windows"
msgstr "Windows で非 Microsoft コンパイラを使ってビルドするには"

#: ../../install/index.rst:955
msgid "Borland/CodeGear C++"
msgstr "Borland/CodeGear C++"

#: ../../install/index.rst:957
msgid ""
"This subsection describes the necessary steps to use Distutils with the "
"Borland C++ compiler version 5.5.  First you have to know that Borland's "
"object file format (OMF) is different from the format used by the Python "
"version you can download from the Python or ActiveState web site.  (Python "
"is built with Microsoft Visual C++, which uses COFF as the object file "
"format.) For this reason you have to convert Python's library :file:"
"`python25.lib` into the Borland format.  You can do this as follows:"
msgstr ""
"この小節では、 Borland C++ コンパイラのバージョン 5.5 で Distutils を使うため"
"に必要な手順について述べています。  まず、 Borland のオブジェクトファイル形"
"式 (OMF) は、Python 公式サイトや ActiveState の Web サイトからダウンロードで"
"きるバージョンの Python が使っている形式とは違うことを知っておかねばなりませ"
"ん (Python は通常、 Microsoft Visual C++ でビルドされています。Microsoft "
"Visual C++ は COFF をオブジェクトファイル形式に使います。) このため、以下のよ"
"うにして、 Python のライブラリ :file:`python25.lib`  を Borland の形式に変換"
"する必要があります:"

#: ../../install/index.rst:972
msgid ""
"The :file:`coff2omf` program comes with the Borland compiler.  The file :"
"file:`python25.lib` is in the :file:`Libs` directory of your Python "
"installation.  If your extension uses other libraries (zlib, ...) you have "
"to convert them too."
msgstr ""
":file:`coff2omf` プログラムは、 Borland コンパイラに付属しています。 :file:"
"`python25.lib` は Python インストールディレクトリの :file:`Libs`  ディレクト"
"リ内にあります。拡張モジュールで他のライブラリ (zlib, ...) を使っている場合、"
"それらのライブラリも変換しなければなりません。"

#: ../../install/index.rst:977
msgid ""
"The converted files have to reside in the same directories as the normal "
"libraries."
msgstr ""
"変換されたファイルは、通常のライブラリと同じディレクトリに置かねばなりませ"
"ん。"

#: ../../install/index.rst:980
msgid ""
"How does Distutils manage to use these libraries with their changed names?  "
"If the extension needs a library (eg. :file:`foo`) Distutils checks first if "
"it finds a library with suffix :file:`_bcpp` (eg. :file:`foo_bcpp.lib`) and "
"then uses this library.  In the case it doesn't find such a special library "
"it uses the default name (:file:`foo.lib`.) [#]_"
msgstr ""
"さて、 Distutils は異なる名前を持つこれらのライブラリをどのように扱うのでしょ"
"うか? 拡張モジュールで (例えば :file:`foo` という名の) ライブラリが必要な場"
"合、 Distutils はまず :file:`_bcpp` が後ろに付いたライブラリ (例えば :file:"
"`foo_bcpp.lib`) が見つかるかどうか調べ、あればそのライブラリを使います。該当"
"するライブラリがなければ、デフォルトの名前 (:file:`foo.lib`) を使います。 "
"[#]_"

#: ../../install/index.rst:986
msgid ""
"To let Distutils compile your extension with Borland C++ you now have to "
"type::"
msgstr ""
"Borland C++ を使って Distutils に拡張モジュールをコンパイルさせるには、以下の"
"ように入力します::"

#: ../../install/index.rst:990
msgid ""
"If you want to use the Borland C++ compiler as the default, you could "
"specify this in your personal or system-wide configuration file for "
"Distutils (see section :ref:`inst-config-files`.)"
msgstr ""
"Borland C++ コンパイラをデフォルトにしたいなら、自分用、またはシステム全体向"
"けに、 Distutils の設定ファイルを書くことを検討した方がよいでしょう (:ref:"
"`inst-config-files` 節を参照してください)。"

#: ../../install/index.rst:999
msgid "`C++Builder Compiler <https://www.embarcadero.com/products>`_"
msgstr "`C++Builder Compiler <https://www.embarcadero.com/products>`_"

#: ../../install/index.rst:998
msgid ""
"Information about the free C++ compiler from Borland, including links to the "
"download pages."
msgstr ""
"Borland によるフリーの C++ コンパイラに関する情報で、コンパイラのダウンロード"
"ページへのリンクもあります。"

#: ../../install/index.rst:1002
msgid ""
"`Creating Python Extensions Using Borland's Free Compiler <http://www."
"cyberus.ca/~g_will/pyExtenDL.shtml>`_"
msgstr ""
"`Creating Python Extensions Using Borland's Free Compiler <http://www."
"cyberus.ca/~g_will/pyExtenDL.shtml>`_"

#: ../../install/index.rst:1002
msgid ""
"Document describing how to use Borland's free command-line C++ compiler to "
"build Python."
msgstr ""
"Borland 製のフリーのコマンドライン C++ を使って Python をビルドする方法につい"
"て述べたドキュメントです。"

#: ../../install/index.rst:1007
msgid "GNU C / Cygwin / MinGW"
msgstr "GNU C / Cygwin / MinGW"

#: ../../install/index.rst:1009
msgid ""
"This section describes the necessary steps to use Distutils with the GNU C/C+"
"+ compilers in their Cygwin and MinGW distributions. [#]_ For a Python "
"interpreter that was built with Cygwin, everything should work without any "
"of these following steps."
msgstr ""
"この節では、Cygwin や MinGW [#]_ 配布物中の GNU C/C++ コンパイラで Distutils "
"を使うために必要な手順について述べます。Cygwin 向けにビルドされている Python "
"インタプリタを使っているなら、以下の手順をとらなくても Distutils はまったく問"
"題なく動作します。"

#: ../../install/index.rst:1014
msgid ""
"Not all extensions can be built with MinGW or Cygwin, but many can.  "
"Extensions most likely to not work are those that use C++ or depend on "
"Microsoft Visual C extensions."
msgstr ""
"全ての拡張ライブラリが MinGW や Cygwin でビルドできるわけではありませんが、多"
"くの場合はビルドできます。ビルドできない拡張ライブラリは、大抵C++を利用してい"
"たり Microsoft Visual Cの拡張に依存していたりします。"

#: ../../install/index.rst:1018
msgid "To let Distutils compile your extension with Cygwin you have to type::"
msgstr ""
"distutils に Cygwin を使って拡張をコンパイルさせるには次のようにタイプしま"
"す::"

#: ../../install/index.rst:1022
msgid "and for Cygwin in no-cygwin mode [#]_ or for MinGW type::"
msgstr ""
"Cygwin を no-cygwin モード [#]_ で使うときや MinGW を使うときは次のようにしま"
"す::"

#: ../../install/index.rst:1026
msgid ""
"If you want to use any of these options/compilers as default, you should "
"consider writing it in your personal or system-wide configuration file for "
"Distutils (see section :ref:`inst-config-files`.)"
msgstr ""
"これらのオプションやコンパイラをデフォルトにしたい場合、 Distutils の個人用あ"
"るいはシステム全体用の設定ファイルを書くことを検討するべきです。 (:ref:`inst-"
"config-files` を参照してください)"

#: ../../install/index.rst:1031
msgid "Older Versions of Python and MinGW"
msgstr "古いバージョンの Python と MinGW"

#: ../../install/index.rst:1032
msgid ""
"The following instructions only apply if you're using a version of Python "
"inferior to 2.4.1 with a MinGW inferior to 3.0.0 (with "
"binutils-2.13.90-20030111-1)."
msgstr ""
"以下の手順は Python 2.4.1 以前と MinGW 3.0.0 (binutils-2.13.90-20030111-1) 以"
"前を利用しているときのものです。"

#: ../../install/index.rst:1036
msgid ""
"These compilers require some special libraries.  This task is more complex "
"than for Borland's C++, because there is no program to convert the library.  "
"First you have to create a list of symbols which the Python DLL exports. "
"(You can find a good program for this task at https://sourceforge.net/"
"projects/mingw/files/MinGW/Extension/pexports/)."
msgstr ""
"上記のコンパイラは、いくつかの特殊なライブラリを必要とします。この作業は "
"Borland の C++ よりもやや複雑です。というのは、ライブラリを変換するためのプロ"
"グラムが存在しないからです。  まず、 Python DLL が公開している全てのシンボル"
"からなるリストを作成しなければなりません。 (この作業むけの良いプログラムは、 "
"https://sourceforge.net/projects/mingw/files/MinGW/Extension/pexports/ から入"
"手できます。)"

#: ../../install/index.rst:1049
msgid ""
"The location of an installed :file:`python25.dll` will depend on the "
"installation options and the version and language of Windows.  In a \"just "
"for me\" installation, it will appear in the root of the installation "
"directory.  In a shared installation, it will be located in the system "
"directory."
msgstr ""
"インストールされた :file:`python25.dll` の位置はインストールオプションと、 "
"Windowsのバージョンと言語に依存します。\"自分だけのため\"のインストールの場合"
"には、インストールディレクトリのルートに配置されます。共有インストールの場合"
"にはシステムディレクトリに配置されます。"

#: ../../install/index.rst:1054
msgid ""
"Then you can create from these information an import library for gcc. ::"
msgstr ""
"これで、上で得られた情報をもとに、gcc 用の import ライブラリを作成できま"
"す。 ::"

#: ../../install/index.rst:1058
msgid ""
"The resulting library has to be placed in the same directory as :file:"
"`python25.lib`. (Should be the :file:`libs` directory under your Python "
"installation directory.)"
msgstr ""
"出来上がったライブラリは、 :file:`python25.lib` と同じディレクトリに置かなけ"
"ればなりません。 (Python インストールディレクトリの :file:`libs` ディレクトリ"
"になるはずです。)"

#: ../../install/index.rst:1062
msgid ""
"If your extension uses other libraries (zlib,...) you might  have to convert "
"them too. The converted files have to reside in the same directories as the "
"normal libraries do."
msgstr ""
"拡張モジュールが他のライブラリ (zlib, ...) を必要とする場合、それらのライブラ"
"リも変換しなければなりません。変換されたファイルは、それぞれ通常のライブラリ"
"が置かれているのと同じディレクトリに置かねばなりません。"

#: ../../install/index.rst:1069
msgid ""
"`Building Python modules on MS Windows platform with MinGW <https://old.zope."
"dev/Members/als/tips/win32_mingw_modules>`_"
msgstr ""
"`Building Python modules on MS Windows platform with MinGW <https://old.zope."
"dev/Members/als/tips/win32_mingw_modules>`_"

#: ../../install/index.rst:1070
msgid ""
"Information about building the required libraries for the MinGW environment."
msgstr "MinGW 環境で必要なライブラリのビルドに関する情報があります。"

#: ../../install/index.rst:1074
msgid "Footnotes"
msgstr "脚注"

#: ../../install/index.rst:1075
msgid ""
"This also means you could replace all existing COFF-libraries with OMF-"
"libraries of the same name."
msgstr ""
"つまり、全ての既存の COFF ライブラリを同名の OMF ライブラリに置き換えてもかま"
"わないということです。"

#: ../../install/index.rst:1078
msgid "Check https://www.sourceware.org/cygwin/ for more information"
msgstr ""
"より詳細な情報については https://www.sourceware.org/cygwin/ を参照して下さ"
"い。"

#: ../../install/index.rst:1080
msgid ""
"Then you have no POSIX emulation available, but you also don't need :file:"
"`cygwin1.dll`."
msgstr ""
"このモードでは POSIX エミュレーションを利用できませんが、 :file:`cygwin1."
"dll` も必要なくなります。"