GitBook: [#1] No subject

Author: LenKiMo

05.installation.md

@@ -1,11 +1,10 @@
-# 安装 {#installation}
+# 安装
 
-我们在本书中提及“Python 3”时，我们指的是任何大于等于 [ {{ book.pythonVersion }}](https://www.python.org/downloads/) 的 Python 发行版。[^1]
+我们在本书中提及“Python 3”时，我们指的是任何大于等于 3.5.1 的 Python 发行版。
 
 ## 在 Windows 中安装
 
-访问 https://www.python.org/downloads/ 并下载最新版本的 Python。在本书撰写的时点，最新版本为 Python 3.5.1。
-其安装过程与其它 Windows 平台的软件的安装过程无异。
+访问 https://www.python.org/downloads/ 并下载最新版本的 Python。在本书撰写的时点，最新版本为 Python 3.5.1。 其安装过程与其它 Windows 平台的软件的安装过程无异。
 
 注意：请务必确认你勾选了 `Add Python 3.5 to PATH` 选项。
 
@@ -17,37 +16,36 @@
 
 如果你的环境变量（Path）未正确设置，可以遵循上述步骤予以修正。否则，请参阅 `在 Windows 中运行 Python 提示符` 。
 
-注意：对于那些对编程有所了解的人，如果你熟悉 Docker，可以参阅 [Python in Docker](https://hub.docker.com/_/python/) 和 [Docker on Windows](https://docs.docker.com/windows/)。
+注意：对于那些对编程有所了解的人，如果你熟悉 Docker，可以参阅 [Python in Docker](https://hub.docker.com/\_/python/) 和 [Docker on Windows](https://docs.docker.com/windows/)。
 
-### DOS 提示符 {#dos-prompt}
+### DOS 提示符 <a href="#dos-prompt" id="dos-prompt"></a>
 
 如果你希望在 Windows 命令行使用 Python，比如 DOS 提示符，你需要设置相应的PATH 环境变量。
 
 对于 Windows 2000，XP，2003，点击 `控制面板` → `系统` → `高级` → `环境变量` 。点击 _系统变量_ 选项卡下名为 `PATH` 的变量，选择 `编辑` 并在已存在的字符串末尾添加 `;C:\Python35` （请确保该文件夹确实存在，对于更新版本的 Python 文件夹的名字可能有所不同）。当然，你应该使用恰当的目录名称。
 
-<!-- 该目录应与 book.json 中的 pythonVersion 变量相匹配-->
 对于更古老的 Windows 系统版本，打开文件 `C:\AUTOEXEC.BAT` 并在其中添加一行 `PATH=%PATH%;C:\Python35` ，完成编辑并保存后，你需要重启系统。对于 Windows NT 系统，则对应 `AUTOEXEC.NT` 文件。
 
 对于 Windows Vista：
 
-- 点击开始并选择 `控制面板`  。
-- 点击系统，在右侧你将会看见“浏览你的计算机的基本信息”
-- 左侧将由一个任务列表，最后一个即为“高级系统设置”，点击它。
-- `高级` 标签栏下可以看见 `系统属性` 对话框。
-- 在较低位置的名为 `系统变量` 的对话框，向下滚动至变量部分并点击 `编辑` 按钮。
-- 修改你需要改动的变量。
-- 重启系统。Vista 直至重启前都不会应用系统变量环境的改动。
+* 点击开始并选择 `控制面板` 。
+* 点击系统，在右侧你将会看见“浏览你的计算机的基本信息”
+* 左侧将由一个任务列表，最后一个即为“高级系统设置”，点击它。
+* `高级` 标签栏下可以看见 `系统属性` 对话框。
+* 在较低位置的名为 `系统变量` 的对话框，向下滚动至变量部分并点击 `编辑` 按钮。
+* 修改你需要改动的变量。
+* 重启系统。Vista 直至重启前都不会应用系统变量环境的改动。
 
 对于 Windos 7 与 8：
 
-- 在桌面右击计算机并选择 `属性` 或点击 `开始` 并选择 `控制面板` → `系统与安全` → `系统` 。点击左侧的 `高级系统设置` 并选择 `高级` 标签。点击底部 `系统变量` 下的 `环境变量` ，找到 `PATH` 属性，将其选中并点击 `编辑` 。
-- 前往变量值的最后一行并添加 `;C:\Python35` （请确保该文件夹确实存在，对于更新版本的 Python 文件夹的名字可能有所不同）至业已存在的部分的后方。当然，你应该使用恰当的目录名称。
-- 如果该变量值为 `%SystemRoot%\system32;` 则在修改后其应变为 `%SystemRoot%\system32;C:\Python35` 。<!-- 该目录应与 book.json 中的 pythonVersion 变量相匹配-->
-- 点击 `确定` 以完成操作。你不需要进行重启，不过你可能需要关闭并重启命令提示符。
+* 在桌面右击计算机并选择 `属性` 或点击 `开始` 并选择 `控制面板` → `系统与安全` → `系统` 。点击左侧的 `高级系统设置` 并选择 `高级` 标签。点击底部 `系统变量` 下的 `环境变量` ，找到 `PATH` 属性，将其选中并点击 `编辑` 。
+* 前往变量值的最后一行并添加 `;C:\Python35` （请确保该文件夹确实存在，对于更新版本的 Python 文件夹的名字可能有所不同）至业已存在的部分的后方。当然，你应该使用恰当的目录名称。
+* 如果该变量值为 `%SystemRoot%\system32;` 则在修改后其应变为 `%SystemRoot%\system32;C:\Python35` 。
+* 点击 `确定` 以完成操作。你不需要进行重启，不过你可能需要关闭并重启命令提示符。
 
 ### 在 Windows 下运行 Python 命令提示符
 
-对于 Windows 用户来说，如果你已经正确并恰当地[设置了 `PATH ` 变量](#dos-prompt)，你可以在命令行中运行解释程序。
+对于 Windows 用户来说，如果你已经正确并恰当地[设置了 `PATH` 变量](05.installation.md#dos-prompt)，你可以在命令行中运行解释程序。
 
 要想在 Windows 中运行终端，点击开始并点击 `运行` 。在对话中输入 `cmd` 并按下回车键。
 
@@ -67,7 +65,6 @@
 
 你会看到在运行命令后 Python 的版本信息显示在屏幕上：
 
-<!-- 输出内容应与 book.json 中的 pythonVersion 变量相匹配-->
 ```
 $ python3 -V
 Python 3.5.1
@@ -83,6 +80,4 @@ Python 3.5.1
 
 接下来，我们将要撰写我们的第一个 Python 程序。
 
----
-
-[^1]: 本书采用 Python 3.5.1 用来讲授，但最新版本 Python 已非此版本。在翻译时遵从原书内容继续沿用 Python 3.5.1 版本，请读者自行代换为最新版本。
+***

06.first_steps.md

@@ -6,7 +6,7 @@
 
 ## 使用解释器提示符
 
-在你的操作系统中打开终端（Terminal）程序（正如我们先前在 [安装](./installation.md#installation) 章节所讨论过的那样）然后通过输入 `python3` 并按下 `[enter]` 键来打开 Python 提示符（Python Prompt）。
+在你的操作系统中打开终端（Terminal）程序（正如我们先前在 [安装](05.installation.md) 章节所讨论过的那样）然后通过输入 `python3` 并按下 `[enter]` 键来打开 Python 提示符（Python Prompt）。
 
 当你启动 Python 后，你会看见在你能开始输入内容的地方出现了 `>>>` 。这个被称作 _Python 解释器提示符（Python Interpreter Prompt）_ 。
 
@@ -20,7 +20,6 @@ print("Hello World")
 
 下面是一个在 Mac OS X 电脑上你能够看见的结果的示例。有关 Python 软件的细节将会因为你使用的电脑而有所不同，但是从提示符（如 `>>>` ）开始部分应该是相同的，而不会受到操作系统的影响。
 
-<!-- 输出结果应与 book.json 中的 pythonVersion 变量相同 -->
 ```python
 > python3
 Python 3.5.1 (default, Jan 14 2016, 06:54:11)
@@ -50,56 +49,55 @@ Hello World
 
 如果你正在使用 Windows 系统，**不要用记事本**——这是一个很糟糕的选择，因为它没有语法加亮功能，同样重要的另一个原因是，它不支持文本缩进功能，这一功能我们之后将会了解它究竟有多重要。而一款好的编辑器能够自动帮你完成这一工作。
 
-如果你已是一名经验丰富的程序员，那你一定在用 [Vim](http://www.vim.org) 或 [Emacs](http://www.gnu.org/software/emacs/) 了。无需多言，它们都是最强大的编辑器之一，用它们来编写你的 Python 程序自是受益颇多。我个人用它们来编写了我大部分程序，同时也因此写了一本书《[Entire Book on Vim]({{ book.vimBookUrl }})》。
+如果你已是一名经验丰富的程序员，那你一定在用 [Vim](http://www.vim.org) 或 [Emacs](http://www.gnu.org/software/emacs/) 了。无需多言，它们都是最强大的编辑器之一，用它们来编写你的 Python 程序自是受益颇多。我个人用它们来编写了我大部分程序，同时也因此写了一本书《\[Entire Book on Vim]\(\{{ book.vimBookUrl \}})》。
 
 或许你有意去花费时间来学习 Vim 或 Emacs，那么我自是强烈推荐你学习它们二者中的一款，它们将在长远意义上对你裨益颇深。当然，正如我先前所推荐的，初学者可以以 PyCharm 开始，从而在此刻专注于学习 Python 而不是编辑器。
 
 再此重申，请选择一款合适的编辑器——它能够让编写 Python 程序变得更加有趣且容易。
 
-## PyCharm {#pycharm}
+## PyCharm <a href="#pycharm" id="pycharm"></a>
 
 [PyCharm 教育版](https://www.jetbrains.com/pycharm-edu/)是一款能够对你编写 Python 程序的工作有所帮助的免费编辑器。
 
 当你打开 PyCharm 时，你会看见如下界面，点击 `Create New Project` ：
 
-![当你打开 PyCharm 时](./img/pycharm_open.png)
+![当你打开 PyCharm 时](img/pycharm\_open.png)
 
 选择 `Pure Python` ：
 
-![PyCharm 新项目](./img/pycharm_create_new_project.png)
+![PyCharm 新项目](img/pycharm\_create\_new\_project.png)
 
 将你的项目路径位置中的 `untitled` 更改为 `helloworld` ，你所看到的界面细节应该类似于下方这番：
 
-![PyCharm 项目细节](./img/pycharm_create_new_project_pure_python.png)
+![PyCharm 项目细节](img/pycharm\_create\_new\_project\_pure\_python.png)
 
 点击 `Create` 按钮。
 
 对侧边栏中的 `helloworld` 右击选中，并选择 `New` -> `Python File` ：
 
-![PyCharm -> New -> Python File](./img/pycharm_new_python_file.png)
+![PyCharm -> New -> Python File](img/pycharm\_new\_python\_file.png)
 
 你会被要求输入名字，现在输入 `hello` ：
 
-![PyCharm 新文件对话框](./img/pycharm_new_file_input.png)
+![PyCharm 新文件对话框](img/pycharm\_new\_file\_input.png)
 
 现在你便可以看见一个新的文件已为你开启：
 
-![PyCharm hello.py 文件](./img/pycharm_hello_open.png)
+![PyCharm hello.py 文件](img/pycharm\_hello\_open.png)
 
 删除那些已存在的内容，现在由你自己输入以下代码：
 
-<!-- TODO: Update screenshots for Python 3 -->
-
 ```python
 print("hello world")
 ```
+
 现在右击你所输入的内容（无需选中文本），然后点击 `Run 'hello'` 。
 
-![PyCharm Run 'hello'](./img/pycharm_run.png)
+![PyCharm Run 'hello'](img/pycharm\_run.png)
 
 此刻你将会看到你的程序所输出的内容（它所打印出来的内容）：
 
-![PyCharm 输出内容](./img/pycharm_output.png)
+![PyCharm 输出内容](img/pycharm\_output.png)
 
 嚯！虽然只是刚开始的几个步骤，但从今以后，每当我们要求你创建一个新的文件时，记住只需在 `helloworld` 上右击并选择 -> `New` -> `Python File` 并继续如上所述步骤一般输入内容并运行即可。
 
@@ -108,27 +106,27 @@ print("hello world")
 ## Vim
 
 1. 安装 [Vim](http://www.vim.org)。
-    * Mac OS X 应该通过 [HomeBrew](http://brew.sh/) 来安装 `macvim` 包。
-    * Windows 用户应该通过 [Vim 官方网站](http://www.vim.org/download.php) 下载“自安装可执行文件”。
-    * GNU/Linux  用户应该通过他们使用的发行版的软件仓库获取 Vim。例如 Debian 与 Ubuntu 用户可以安装 `vim` 包。
+   * Mac OS X 应该通过 [HomeBrew](http://brew.sh/) 来安装 `macvim` 包。
+   * Windows 用户应该通过 [Vim 官方网站](http://www.vim.org/download.php) 下载“自安装可执行文件”。
+   * GNU/Linux 用户应该通过他们使用的发行版的软件仓库获取 Vim。例如 Debian 与 Ubuntu 用户可以安装 `vim` 包。
 2. 安装 [jedi-vim](https://github.com/davidhalter/jedi-vim) 插件为 Vim 增添自动完成功能。
 3. 安装与之相应的 `jedi` Python 包：`pip install -U jedi`
 
 ## Emacs
 
 1. 安装 [Emacs 24+](http://www.gnu.org/software/emacs/)。
-    * Mac OS X 用户应该从 http://emacsformacosx.com 获取 Emacs。
-    * Windows 用户应该从 http://ftp.gnu.org/gnu/emacs/windows/ 获取 Emacs。
-    * GNU/Linux 用户应该从他们使用的发行版的软件仓库获取 Emacs。如 Debian 和 Ubuntu 用户可以安装 `emacs24` 包。
+   * Mac OS X 用户应该从 http://emacsformacosx.com 获取 Emacs。
+   * Windows 用户应该从 http://ftp.gnu.org/gnu/emacs/windows/ 获取 Emacs。
+   * GNU/Linux 用户应该从他们使用的发行版的软件仓库获取 Emacs。如 Debian 和 Ubuntu 用户可以安装 `emacs24` 包。
 2. 安装 [ELPY](https://github.com/jorgenschaefer/elpy/wiki)。
 
 ## 使用一份源代码文件
 
-现在让我们回到编程中来。在你学习一门新的编程语言时有一项传统，你所编写并运行的第一个程序应该是 “Hello World” 程序——它所做的全部工作便是宣言你所运行的“Hello World”这句话。正如西蒙·科泽斯（Simon Cozens，一译西蒙·寇森斯） [^1] 所说，这是“向编程之神所称颂的传统咒语，愿他帮助并保佑你更好的学习这门语言”。
+现在让我们回到编程中来。在你学习一门新的编程语言时有一项传统，你所编写并运行的第一个程序应该是 “Hello World” 程序——它所做的全部工作便是宣言你所运行的“Hello World”这句话。正如西蒙·科泽斯（Simon Cozens，一译西蒙·寇森斯） 所说，这是“向编程之神所称颂的传统咒语，愿他帮助并保佑你更好的学习这门语言”。
 
 启动你所选择的编辑器，输入如下程序并将它保存为 `hello.py` 。
 
-如果你正在使用 PyCharm，我们已经讨论过[如何从源文件中运行它了](#pycharm)。
+如果你正在使用 PyCharm，我们已经讨论过[如何从源文件中运行它了](06.first\_steps.md#pycharm)。
 
 对于其它编辑器，打开一个新文件名将其命名为 `hello.py` ，然后输入如下内容：
 
@@ -138,17 +136,17 @@ print("hello world")
 
 你应当将文件保存到哪里？保存到任何你知道其位置与路径的文件夹。如果你不了解这句话是什么意思，那就创建一个新文件夹并用这一路径来保存并运行你所有的 Python 程序：
 
-- Mac OS X 上的 `/tmp/py` 。
-- GNU/Linux 上的 `/tmp/py` 。
-- Windows 上的 `C:\\py` 。
+* Mac OS X 上的 `/tmp/py` 。
+* GNU/Linux 上的 `/tmp/py` 。
+* Windows 上的 `C:\\py` 。
 
 要想创建上述文件夹（在你正在使用的操作系统上），你可以在终端上使用 `mkdir` 命令，如 `mkdir /tmp/py` 。
 
 重要提示：你需要经常确认并确保你为文件赋予了 `.py` 扩展名，例如 `foo.py` 。
 
 要想运行你的 Python 程序：
 
-1. 打开终端窗口（你可查阅先前的 [安装](./installation.md#installation)章节来了解应该怎么做）。
+1. 打开终端窗口（你可查阅先前的 [安装](05.installation.md)章节来了解应该怎么做）。
 2. 使用 `cd` 命令来**改**变**目**录到你保存文件的地方，例如 `cd /tmp/py` 。
 3. 通过输入命令 `python hello.py` 来运行程序。程序的输出结果应如下方所示：
 
@@ -157,11 +155,11 @@ $ python hello.py
 hello world
 ```
 
-![在终端中运行程序的截图](./img/terminal_screenshot.png)
+![在终端中运行程序的截图](img/terminal\_screenshot.png)
 
 如果你得到了与上图类似的输出结果，那么恭喜你！——你已经成功运行了你的第一个 Python 程序。你亦已经成功穿过了学习编程的最困难的部分，也就是，开始编写你的第一个程序！
 
-如果你遭遇了什么错误，请确认是否已经_正确地_输入了上面所列出的内容，并尝试重新运行程序。要注意 Python 是区分大小写的，如 `print` 和 `Print` 是不同的——注意前者的 p 是小写的，而后者的 P 是大写的。此外，你需要确保每一行的第一个字符前面都没有任何空格或制表格——我们会在后面了解 [为什么这件事如此重要](./07.basics.md#indentation)。
+如果你遭遇了什么错误，请确认是否已经\_正确地\_输入了上面所列出的内容，并尝试重新运行程序。要注意 Python 是区分大小写的，如 `print` 和 `Print` 是不同的——注意前者的 p 是小写的，而后者的 P 是大写的。此外，你需要确保每一行的第一个字符前面都没有任何空格或制表格——我们会在后面了解 [为什么这件事如此重要](07.basics.md#indentation)。
 
 **它是如何工作的**
 
@@ -183,6 +181,4 @@ hello world
 
 从此你便成为一名 Python 用户了，现在让我们来学习更多有关 Python 的概念。
 
----
-
-[^1]: 令人印象深刻的《Beginning Perl》一书的作者。——原书注。在本书中，除特别说明的注释外，其余注释均为译者所加。
+***