Merge remote-tracking branch 'origin/master' into ja

yusukew62 · yusukew62 · commit b43e218907a5 · 2017-01-08T11:02:08.000+09:00
diff --git a/docs/index.rst b/docs/index.rst
@@ -16,7 +16,7 @@ Python ヒッチハイク・ガイド へようこそ。
 .. **This is a living, breathing guide.**  If you'd like to contribute,
 .. `fork us on GitHub <https://github.com/kennethreitz/python-guide>`_!
 
-**このガイドは生きています。** 貢献したい場合は `GitHub で fork <https://github.com/kennethreitz/python-guide>`_ してください！
+**これは生きて呼吸をしているガイドです。** 貢献したい場合は `GitHub で fork <https://github.com/kennethreitz/python-guide>`_ してください！
 
 .. This handcrafted guide exists to provide both novice and expert Python
 .. developers a best practice handbook to the installation, configuration, and
diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
@@ -31,8 +31,8 @@ OS X に同梱されている Python のバージョンは学習には最適で
 .. Doing it Right
 .. --------------
 
-正しく行う
-----------
+正しい方法でやりましょう
+-------------------
 
 .. Let's install a real version of Python.
 
@@ -73,7 +73,7 @@ OS X には多数の UNIX ユーティリティが付属していますが、Lin
 .. To `install Homebrew <http://brew.sh/#install>`_, open :file:`Terminal` or
 .. your favorite OSX terminal emulator and run
 
-`Homebrew をインストールする <http://brew.sh/#install>`_ には :file:`Terminal` かお気に入りのOSX端末エミュレータを起動して実行してください
+`Homebrew をインストールする <http://brew.sh/#install>`_ には :file:`Terminal` かお気に入りのOSX端末エミュレータを起動して実行してください。
 
 .. code-block:: console
 
@@ -85,23 +85,23 @@ OS X には多数の UNIX ユーティリティが付属していますが、Lin
 .. of your :envvar:`PATH` environment variable. You can do this by adding the following
 .. line at the bottom of your :file:`~/.profile` file
 
-スクリプトは、インストールの開始前にどのような変更が行われ、プロンプトを表示するかを説明します。 Homebrew をインストールした後、:envvar:`PATH` 環境変数の先頭に Homebrew ディレクトリを挿入します。これを行うには、:file:`~/.profile` ファイルの一番下に次の行を追加します
+スクリプトは、インストールの開始前にどのような変更が行われ、プロンプトを表示するかを説明します。 Homebrew をインストールした後、:envvar:`PATH` 環境変数の先頭に Homebrew ディレクトリを挿入します。これを行うには、:file:`~/.profile` ファイルの一番下に次の行を追加します。
 
 .. code-block:: console
 
     export PATH=/usr/local/bin:/usr/local/sbin:$PATH
 
 .. Now, we can install Python 2.7:
 
-今、Python 2.7 をインストールできます:
+Python 2.7:
 
 .. code-block:: console
 
     $ brew install python
 
 .. or Python 3:
 
-または Python 3:
+または Python 3 をインストールできます:
 
 .. code-block:: console
 
@@ -145,7 +145,7 @@ Setuptools を使うと、単一のコマンド(``easy_install``)を使って、
 .. "Project X depends on version 1.x but, Project Y needs 4.x" dilemma, and keeps
 .. your global site-packages directory clean and manageable.
 
-仮想環境（一般に 'virtualenv' と呼ばれる）は、異なるプロジェクトが必要とする依存関係を別々の場所に保存するためのツールです。 「Project Xはバージョン1.xに依存しますが、Project Yは4.xが必要です」というジレンマを解決し、グローバルなサイトパッケージディレクトリをきれいに管理します。
+仮想環境（一般に 'virtualenv' と呼ばれます）は、異なるプロジェクトが必要とする依存関係を別々の場所に保存するためのツールです。 「Project Xはバージョン1.xに依存しますが、Project Yは4.xが必要です」というジレンマを解決し、グローバルなサイトパッケージディレクトリをきれいに管理します。
 
 .. For example, you can work on a project which requires Django 1.10 while also
 .. maintaining a project which requires Django 1.8.
@@ -154,7 +154,7 @@ Setuptools を使うと、単一のコマンド(``easy_install``)を使って、
 
 .. To start using this and see more information: :ref:`Virtual Environments <virtualenvironments-ref>` docs.
 
-これを使い始め、さらに詳しい情報を参照する :ref:`Virtual Environments <virtualenvironments-ref>` docs。
+これを使い始め、さらに詳しい情報はこちらを参照: :ref:`Virtual Environments <virtualenvironments-ref>` docs。
 
 --------------------------------
 
diff --git a/docs/starting/install/win.rst b/docs/starting/install/win.rst
@@ -11,7 +11,7 @@ WindowsでのPythonのインストール
 .. up-to-date version, click the Downloads > Windows link from the home page of the
 .. `Python.org web site <http://python.org>`_ .
 
-まず、`Python 2.7の最新バージョン <https://www.python.org/ftp/python/2.7.12/python-2.7.12.msi>`_ を公式サイトからダウンロードしてください。完全に最新のバージョンをインストールしたい場合は、`Python.orgのWebサイト <http://python.org>`_ のホームページからDownloads> Windowsのリンクをクリックしてください。
+まず、`Python 2.7の最新バージョン <https://www.python.org/ftp/python/2.7.12/python-2.7.12.msi>`_ を公式サイトからダウンロードしてください。完全に最新のバージョンをインストールしたい場合は、`Python.orgのWebサイト <http://python.org>`_ のホームページからDownloads > Windowsのリンクをクリックしてください。
 
 .. The Windows version is provided as an MSI package. To install it manually, just
 .. double-click the file. The MSI package format allows Windows administrators to
@@ -73,7 +73,7 @@ Setuptools + Pip
 .. To obtain the latest version of Setuptools for Windows, run the Python script
 .. available here: `ez_setup.py <https://bootstrap.pypa.io/ez_setup.py>`_
 
-Windows用のSetuptoolsの最新版を入手するには、Pythonスクリプトを実行してください: `ez_setup.py <https://bootstrap.pypa.io/ez_setup.py>`_
+Windows用のSetuptoolsの最新版を入手するには、ここの利用できるPythonスクリプトを実行してください: `ez_setup.py <https://bootstrap.pypa.io/ez_setup.py>`_
 
 
 .. You'll now have a new command available to you: **easy_install**. It is
@@ -86,7 +86,7 @@ Windows用のSetuptoolsの最新版を入手するには、Pythonスクリプト
 .. To install pip, run the Python script available here:
 .. `get-pip.py <https://raw.github.com/pypa/pip/master/contrib/get-pip.py>`_
 
-pipをインストールするには、Pythonスクリプトを実行してください: `get-pip.py <https://raw.github.com/pypa/pip/master/contrib/get-pip.py>`_
+pipをインストールするには、ここの利用できるPythonスクリプトを実行してください: `get-pip.py <https://raw.github.com/pypa/pip/master/contrib/get-pip.py>`_
 
 
 .. Virtual Environments
diff --git a/docs/starting/install3/osx.rst b/docs/starting/install3/osx.rst
@@ -25,8 +25,8 @@ OS Xに同梱されているPythonのバージョンは学習には最適です
 .. Doing it Right
 .. --------------
 
-そうすること
-------------
+正しい方法でやりましょう
+-------------------
 
 .. Let's install a real version of Python.
 
@@ -64,7 +64,7 @@ OS Xには多数のUNIXユーティリティが付属していますが、Linux
 .. To `install Homebrew <http://brew.sh/#install>`_, open :file:`Terminal` or
 .. your favorite OSX terminal emulator and run
 
-`Homebrew <http://brew.sh/#install>`_ をインストールするには :file:`Terminal` かお気に入りのOSX端末エミュレータを起動して実行してください
+`Homebrew <http://brew.sh/#install>`_ をインストールするには :file:`Terminal` かお気に入りのOSX端末エミュレータを起動して実行してください。
 
 .. code-block:: console
 
@@ -76,15 +76,15 @@ OS Xには多数のUNIXユーティリティが付属していますが、Linux
 .. of your :envvar:`PATH` environment variable. You can do this by adding the following
 .. line at the bottom of your :file:`~/.profile` file
 
-スクリプトは、インストールの開始前にどのような変更が行われ、プロンプトを表示するかを説明します。 Homebrewをインストールした後、:envvar:`PATH` 環境変数の先頭にHomebrewディレクトリを挿入します。 これを行うには、:file:`~/.profile` ファイルの一番下に次の行を追加します
+スクリプトは、インストールの開始前にどのような変更が行われ、プロンプトを表示するかを説明します。 Homebrewをインストールした後、:envvar:`PATH` 環境変数の先頭にHomebrewディレクトリを挿入します。 これを行うには、:file:`~/.profile` ファイルの一番下に次の行を追加します。
 
 .. code-block:: console
 
     export PATH=/usr/local/bin:/usr/local/sbin:$PATH
 
 .. Now, we can install Python 3:
 
-今、Python 3をインストールすることができます:
+Python 3をインストールすることができます:
 
 .. code-block:: console
 
@@ -125,15 +125,15 @@ Python 3を使って作業する
 
 .. will launch the Python 2 interpreter.
 
-Python 2インタプリタを起動します。
+で、Python 2インタプリタを起動します。
 
 .. code-block:: console
 
     $ python3
 
 .. will launch the Python 3 interpreter
 
-Python 3インタプリタを起動する
+で、Python 3インタプリタを起動します。
 
 .. ``pip3`` and ``pip`` will both be available.  If the Homebrew version of Python
 .. 2 is not installed, they will be the same.  If the Homebrew version of Python 2
@@ -155,7 +155,7 @@ Python 3インタプリタを起動する
 .. version 1.x but, Project Y needs 4.x" dilemma, and keeps your global
 .. site-packages directory clean and manageable.
 
-仮想環境（一般に 'virtualenv'と呼ばれる）は、異なるプロジェクトが必要とする依存関係を別々の場所に保存するためのツールです。 「Project Xはバージョン1.xに依存しますが、Project Yは4.xが必要です」というジレンマを解決し、グローバルなサイトパッケージディレクトリをきれいに管理します。
+仮想環境（一般に 'virtualenv'と呼ばれます）は、異なるプロジェクトが必要とする依存関係を別々の場所に保存するためのツールです。 「Project Xはバージョン1.xに依存しますが、Project Yは4.xが必要です」というジレンマを解決し、グローバルなサイトパッケージディレクトリをきれいに管理します。
 
 .. For example, you can work on a project which requires Django 1.10 while also
 .. maintaining a project which requires Django 1.8.
@@ -164,7 +164,7 @@ Python 3インタプリタを起動する
 
 .. To start using this and see more information: :ref:`Virtual Environments <virtualenvironments-ref>` docs.
 
-これを使い始め、さらに詳しい情報を参照する :ref:`Virtual Environments <virtualenvironments-ref>` docs。
+これを使い始め、さらに詳しい情報はこちらを参照: :ref:`Virtual Environments <virtualenvironments-ref>` docs。
 
 --------------------------------
 
diff --git a/docs/starting/which-python.rst b/docs/starting/which-python.rst
@@ -54,7 +54,7 @@ Pythonインタプリタを選択するときには、"Python 2 または Python
 
 - 新しい Python アプリケーションは Python 3 を使用します。
 - Python を初めて学ぶなら、Python 2.7 を身近に感じることは非常に大切ですが、Python 3 を学ぶことよりも有用ではありません。
-- 両方を学びます。 どちらも "Python" です。
+- 両方を学ぶ。 どちらも "Python" です。
 - 既に構築されているソフトウェアは Python 2.7 に依存していることが多いです。
 - 新しいオープンソースの Python ライブラリを作成している場合は、Python 2 と Python 3 の両方を同時に作成することをお勧めします。 新しいライブラリのために Python 3 を広くサポートしたいのは政治的なものであり、多くのユーザを疎外させます。 これは問題ではありません。ゆっくりと、今後3年間で、このケースは少なくなります。
 
@@ -144,7 +144,7 @@ PyPyは、パフォーマンスを向上させながら、リファレンス CPy
 .. worth giving PyPy a try. On a suite of benchmarks, it's currently `over 5 times
 .. faster than CPython <http://speed.pypy.org/>`_.
 
-Python コードのパフォーマンスを向上させたい場合は、PyPy を試してみる価値があります。 一連のベンチマークでは、現在、`CPythonより5倍以上高速 <http://speed.pypy.org/>`_ です。
+Python コードのパフォーマンスを向上させたい場合は、PyPy を試してみる価値があります。 一連のベンチマークでは、現在、`CPythonより 5倍以上高速 <http://speed.pypy.org/>`_ です。
 
 .. PyPy supports Python 2.7. PyPy3 [#pypy_ver]_, released in beta, targets Python 3.
 
@@ -197,7 +197,7 @@ PythonNet
 .. inverse approach to that taken by IronPython (see above), to which it
 .. is more complementary than competing with.
 
-`Python for .NET <http://pythonnet.github.io/>`_ は、ネイティブにインストールされた Python インストールを .NET Common Language Runtime（CLR）にシームレスに統合するパッケージです。 これは IronPython（上記を参照）とは逆のアプローチであり、これは競合するよりも補完的です。
+`Python for .NET <http://pythonnet.github.io/>`_ は、ネイティブにインストールされた Python インストールを .NET Common Language Runtime（CLR）にシームレスに統合するパッケージです。 これは IronPython（上記を参照）とは逆のアプローチであり、これは競合するというよりも補完的です。
 
 .. In conjunction with Mono, pythonnet enables native Python
 .. installations on non-Windows operating systems, such as OS X and
diff --git a/docs/writing/structure.rst b/docs/writing/structure.rst
diff --git a/docs/writing/style.rst b/docs/writing/style.rst
