diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
new file mode 100644
index 0000000..1b907d3
--- /dev/null
+++ b/.github/FUNDING.yml
@@ -0,0 +1 @@
+github: kennethreitz
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
new file mode 100644
index 0000000..8bc4dc8
--- /dev/null
+++ b/.github/workflows/pages.yml
@@ -0,0 +1,58 @@
+name: Deploy documentation
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Install dependencies
+        run: uv sync --python 3.12 --frozen --no-install-project
+
+      - name: Build documentation
+        run: make html
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
index abe9e6c..a0afb4c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,3 +10,13 @@ docs/_build
 
 # 忽略build产生的文件
 build/
+
+# mac
+.DS_Store
+
+# editor
+.vscode
+
+# virutal env
+venv/
+.venv/
diff --git a/.travis.yml b/.travis.yml
index b107f12..77a0fdd 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,7 @@
 sudo: false
 language: python
+python:
+  - "3.6"
 install: pip install sphinx
 script: 
 - make doctest
diff --git a/Contributing.md b/Contributing.md
index edb9ae5..30ae478 100644
--- a/Contributing.md
+++ b/Contributing.md
@@ -3,7 +3,7 @@
 
 此份指南处于大量的发展阶段，如果您愿意贡献一份力量，请见此：
 
-http://docs.python-guide.org/en/latest/notes/contribute/
+https://docs.python-guide.org/en/latest/notes/contribute/
 
 如何测试您的修改
 ------------------------
@@ -16,15 +16,15 @@ pip install --user sphinx
 ```
 
 然后导航到makefile的目录，并执行 ```make build``` 或 ```make html``` 。然后，
-Sphinx将在名为_build/html的文件夹中生成html。
+Sphinx将在名为 `_build/html` 的文件夹中生成html。
 
-导航到此文件夹后，您可以使用python的内置Web服务器在本地查看更改：
+导航到此文件夹后，您可以使用Python的内置Web服务器在本地查看更改：
 
 ``` bash
 python3 -m http.server
 ```
 
-默认情况下，http.server监听每个绑定在您的主机IP地址的8000端口。要绑定到特定IP和端口，例如，localhost的8005端口：
+默认情况下，`http.server` 监听每个绑定在您的主机IP地址的8000端口。要绑定到特定IP和端口，例如，localhost的8005端口：
 
 ``` bash
 python3 -m http.server 8005 --bind 127.0.0.1
@@ -36,4 +36,4 @@ python3 -m http.server 8005 --bind 127.0.0.1
 
 所有的贡献请遵循 `指南风格指引`:
 
-http://docs.python-guide.org/en/latest/notes/styleguide/
+https://docs.python-guide.org/notes/styleguide/
diff --git a/Makefile b/Makefile
index e702e78..bfbcd42 100644
--- a/Makefile
+++ b/Makefile
@@ -1,7 +1,47 @@
-.PHONY: build
+.DEFAULT_GOAL := help
+
+UV ?= uv
+PYTHON_VERSION ?= 3.12
+VENV ?= .venv
+PORT ?= 8005
+
+VENV_BIN := $(VENV)/bin
+VENV_PYTHON := $(CURDIR)/$(VENV_BIN)/python
+SPHINXBUILD := $(CURDIR)/$(VENV_BIN)/sphinx-build
+BUILD_DIR := docs/_build
+INSTALL_STAMP := $(VENV)/.installed
+DOC_TARGETS := dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf latexpdfja text man texinfo info gettext changes linkcheck doctest xml pseudoxml netlify
+
+.PHONY: help install build html serve clean $(DOC_TARGETS)
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  install   create $(VENV) with uv and install dependencies"
+	@echo "  html      build standalone HTML files"
+	@echo "  serve     build and serve docs at http://localhost:$(PORT)/"
+	@echo "  clean     remove generated documentation files"
+	@echo
+	@echo "Other Sphinx targets are forwarded to docs/Makefile."
+
+install: $(INSTALL_STAMP)
+
+$(INSTALL_STAMP): pyproject.toml uv.lock Makefile
+	@command -v $(UV) >/dev/null 2>&1 || (echo "uv is required. Install it from https://docs.astral.sh/uv/" && exit 1)
+	$(UV) sync --python $(PYTHON_VERSION) --frozen --no-install-project
+	@touch $(INSTALL_STAMP)
+
 build: html
 
-# this pattern rule lets you run "make build" (or any other target
-# in docs/Makefile) in this directory as though you were in docs/
-%:
-	cd docs && make $@
+html: install
+	$(MAKE) -C docs html SPHINXBUILD=$(SPHINXBUILD)
+	@touch $(BUILD_DIR)/html/.nojekyll
+
+serve: html
+	cd $(BUILD_DIR)/html && $(VENV_PYTHON) -m http.server $(PORT)
+
+clean:
+	rm -rf $(BUILD_DIR)/*
+
+# These targets let you run common docs/Makefile targets from the repository root.
+$(DOC_TARGETS): install
+	$(MAKE) -C docs $@ SPHINXBUILD=$(SPHINXBUILD)
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4534b04
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+# Python最佳实践指南中文版
+
+[![Open Collective 支持者](https://opencollective.com/python-guide-cn/backers/badge.svg)](#支持者)
+[![Open Collective 赞助者](https://opencollective.com/python-guide-cn/sponsors/badge.svg)](#赞助者)
+
+![Python 指南配图](https://farm1.staticflickr.com/628/33173824932_58add34581_k_d.jpg)
+
+项目翻译来自 [Hitchhiker's Guide to Python](https://github.com/kennethreitz/python-guide)。
+
+文档地址：[Python最佳实践指南中文版](https://prodesire.github.io/Python-Guide-CN/)
+
+本指南目前持续不断地更新与完善。这份主要是自我见解的指南旨在为 Python 初学者和专家提供一个关于 Python 安装、配置和日常使用的最佳实践手册。
+
+主题包括：
+
+- 不同平台和系统上的安装
+- Py2app、Py2exe、bbfreeze、pyInstaller
+- Pip
+- NumPy、SciPy、statpy、pyplot、matplotlib
+- Virtualenv
+- Fabric
+- 优秀的模块推荐，按主题/目的分类
+- 在哪些场景下使用哪些模块
+- 服务器配置与不同的 Web 框架和工具
+- 文档：写文档
+- 测试：Jenkins 与 tox 指南
+- 如何更方便地通过 `git` 连接 `hg`
+
+## 使用指南
+
+1. 下载 zip 文件或 clone 到本地，并进入到项目根目录。
+2. 运行 `make help` 查看可用命令。
+3. 运行 `make install` 使用 uv 根据 `pyproject.toml` 创建虚拟环境并安装依赖。
+4. 运行 `make html` 构建文档；或运行 `make serve` 构建并启动本地文档网站。
+5. `make html` 会在 `docs/_build/html` 中生成 HTML 文件，`make serve` 默认会在 `http://localhost:8005/` 运行文档网站。
+
+## 翻译指南
+
+1. 将 [python-guide](https://github.com/kennethreitz/python-guide) 项目和本项目的 `master` 分支更新。
+2. 查看本项目 `diff.txt` 中的当前翻译版本对应的原版提交号，在 `python-guide` 中比对 `master` 分支上最新提交和该提交号的差异，并据此翻译进本项目。
+3. 翻译完毕后将 `python-guide` 中 `master` 分支上的最新提交号更新入 `diff.txt` 的当前翻译版本对应的原版提交号。
+4. 在本项目中提交修改、推送，并发起合并请求。
+
+## 鸣谢
+
+### 贡献者
+
+感谢所有为本项目做出贡献的人。
+
+![贡献者](https://opencollective.com/python-guide-cn/contributors.svg?width=890&button=false)
+
+### 支持者
+
+感谢所有支持者。[成为支持者](https://opencollective.com/python-guide-cn#backer)。
+
+[![支持者](https://opencollective.com/python-guide-cn/backers.svg?width=890)](https://opencollective.com/python-guide-cn#backers)
+
+### 赞助者
+
+欢迎赞助本项目。您的 Logo 将显示在这里，并链接到您的网站。[成为赞助者](https://opencollective.com/python-guide-cn#sponsor)。
+
+[![赞助者](https://opencollective.com/python-guide-cn/sponsor/0/avatar.svg)](https://opencollective.com/python-guide-cn/sponsor/0/website)
diff --git a/Readme.rst b/Readme.rst
deleted file mode 100644
index 501c846..0000000
--- a/Readme.rst
+++ /dev/null
@@ -1,108 +0,0 @@
-Python最佳实践指南中文版
-============================
-
-.. image:: https://farm1.staticflickr.com/628/33173824932_58add34581_k_d.jpg
-
-项目翻译自 `Hitchhiker's Guide to Python <https://github.com/kennethreitz/python-guide>`_。
-
-Readthedocs文档地址 `Python最佳实践指南中文版 <http://pythonguidecn.readthedocs.org/>`_。
-
------------
-
-本指南目前持续不断地更新与完善。这份主要是自我见解的指南旨在为Python初学者和
-专家提供一个关于Python安装、配置、和日常使用的最佳实践手册。
-
-
-主题包括:
-
-- 不同平台和系统上的安装
-- Py2app, Py2exe, bbfreeze, pyInstaller
-- Pip
-- Numpy, scipy, statpy, pyplot, matplotlib
-- Virtualenv
-- Fabric
-- 优秀的模块推荐，按主题/目的分类
-- 在哪些场景下使用哪些模块
-- 服务器配置 & 不同的web框架和工具
-- 文档: 写文档
-- 测试: Jenkins & tox 指南
-- 如何更方便地通过 ``git`` 连接 ``hg``
-
-如果您不习惯阅读reStructuredText形式的文档, 这里有一份同步更新的 `HTML版文档，请戳它 <http://pythonguidecn.readthedocs.org/>`_。
-
-使用指南
-============================
-1. 下载zip文件或clone到本地，并进入到项目根目录
-2. 打开命令行，运行 `pip install -r requirements.txt` 安装依赖
-3. 打开命令行，运行 `make html` ; 或者（针对Windows）运行makehtml.bat
-4. 上述步骤自动在根目录下生成build文件夹，打开./build/html/index.html即可浏览文档
-
-或者
----------------------------
-- 直接访问 `Python最佳实践指南中文版 <http://pythonguidecn.readthedocs.org/>`_。
-
------------
-
-翻译进度（完成）
-============================
-Getting Started（开始吧）（完成）
----------------------------
-- Picking an Interpreter（选择一个解释器）（完成）
-- Properly Install Python（正确地安装Python）（完成）
-
-Writing Great Code（写出优雅的代码）（完成）
----------------------------
-- Structuring Your Project（结构化您的工程）（完成）
-- Code Style（代码风格）（完成）
-- Reading Great Code（阅读好的代码）（完成）
-- Documentation（文档）（完成）
-- Testing Your Code（测试您的代码）（完成）
-- Logging（日志）（完成）
-- Common Gotchas（常见陷阱）（完成）
-- Choosing a License（选择一个许可）（完成）
-
-Scenario Guide（场景/方案指南）（完成）
----------------------------
-- Network Applications（网络应用）（完成）
-- Web Applications（Web 应用）（完成）
-- HTML Scraping（HTML 抓取）（完成）
-- Command-line Applications（命令行应用）（完成）
-- GUI Applications（GUI应用）（完成）
-- Databases（数据库）（完成）
-- Networking（网络）（完成）
-- Systems Administration（系统管理）（完成）
-- Continuous Integration（持续集成）（完成）
-- Speed（速度）（完成）
-- Scientific Applications（科学应用）（完成）
-- Image Manipulation（图像处理）（完成）
-- XML parsing（XML解析）（完成）
-- JSON（JSON）（完成）
-- Cryptography（密码学）（完成）
-- Interfacing with C/C++ Libraries（与C/C++库交互）（完成）
-- Machine Learning（机器学习）（完成）
-- Data Serialization（数据序列化）（完成）
-
-Shipping Great Code（部署优雅的代码）（完成）
----------------------------
-- Packaging Your Code（打包您的代码）（完成）
-- Freezing Your Code（冻结您的代码）（完成）
-
-Development Environment（开发环境）（完成）
----------------------------
-- Your Development Environment（您的开发环境）（完成）
-- Virtual Environments（虚拟环境）（完成）
-- Further Configuration of Pip and Virtualenv（Pip和Virtualenv的更多配置）（完成）
-
-Additional Notes（额外关注）（完成）
----------------------------
-- Introduction（介绍）（完成）
-- The Community（社区）（完成）
-- Learning Python（学习Python）（完成）
-- Documentation（文档）（完成）
-- News（新闻）（完成）
-
-其他（完成）
----------------------------
-- Contribute（贡献）（完成）
-- License（许可证）（完成）
-- The Guide Style Guide（风格指南指引）（完成）
diff --git a/TODO.rst b/TODO.rst
deleted file mode 100644
index af9093b..0000000
--- a/TODO.rst
+++ /dev/null
@@ -1,3 +0,0 @@
-* Establish "use this" vs "alternatives are...." recommendations
-
-.. todolist::
\ No newline at end of file
diff --git a/diff.txt b/diff.txt
index bfa0ef1..dbac9df 100644
--- a/diff.txt
+++ b/diff.txt
@@ -1,2 +1,2 @@
-当前翻译版本对应的原版提交为： 411599c5ad72dcffbe5f4d5160ff5110e1b802a6
-当前要翻译版本对应的原版提交为： 暂无
\ No newline at end of file
+当前翻译版本对应的原版提交为： 9715682d556b13e5a182aaac2a0428da7b31003e
+当前要翻译版本对应的原版提交为： 无
diff --git a/docs/404.rst b/docs/404.rst
new file mode 100644
index 0000000..7252597
--- /dev/null
+++ b/docs/404.rst
@@ -0,0 +1,28 @@
+:orphan:
+
+###############
+404 — Not Found
+###############
+
+**抱歉，我们无法找到您请求的页面.**
+
+看起来有如下原因:
+
+- 使用了错误的地址
+- 使用了过期的链接
+
+`点此返回主页 <https://prodesire.github.io/Python-Guide-CN/>`_
+
+或者尝试 `搜索 <https://prodesire.github.io/Python-Guide-CN/search.html>`_.
+
+.. raw:: html
+
+    <script>
+    ga('send', {
+        hitType: 'event',
+        eventCategory: 'error',
+        eventAction: '404',
+        eventLabel: document.referrer,
+        nonInteraction: true
+      });
+    </script>
diff --git a/docs/Makefile b/docs/Makefile
index 40b479e..963704a 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -19,7 +19,7 @@ ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf latexpdfja text man changes linkcheck doctest gettext
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
@@ -59,6 +59,12 @@ dirhtml:
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
 
+netlify: dirhtml
+	@cp $(BUILDDIR)/dirhtml/404/index.html $(BUILDDIR)/dirhtml/404.html
+	@sed -i -e 's/src="..\//src="\//g' $(BUILDDIR)/dirhtml/404.html
+	@sed -i -e 's/href="..\//href="\//g' $(BUILDDIR)/dirhtml/404.html
+	@cp _extra/* $(BUILDDIR)/dirhtml/
+
 singlehtml:
 	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
 	@echo
@@ -175,3 +181,6 @@ pseudoxml:
 	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
 	@echo
 	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
+
+serve:
+	cd $(BUILDDIR)/dirhtml && python3 -m http.server 8005
diff --git a/docs/_extra/_redirects b/docs/_extra/_redirects
new file mode 100644
index 0000000..2cb9863
--- /dev/null
+++ b/docs/_extra/_redirects
@@ -0,0 +1,18 @@
+# Redirect rules
+# Docs: https://www.netlify.com/docs/redirects/
+
+# Redirect http to https (avoid one extra hop with an explicit rule for /en/latest/)
+http://docs.python-guide.org/en/latest/*        https://docs.python-guide.org/:splat       301!
+http://docs.python-guide.org/*                  https://docs.python-guide.org/:splat       301!
+
+# Redirect RTD prefix to /
+/en/latest/*                                    /:splat                                    301!
+
+# Redirect domain aliases to primary domain
+http://python-guide.org/*                       http://docs.python-guide.org/:splat        301!
+https://python-guide.org/*                      https://docs.python-guide.org/:splat       301!
+
+# Redirect Netlify version to primary domain
+https://python-guide.netlify.com/*              https://docs.python-guide.org/:splat       301!
+
+/guide-book                                     https://www.amazon.com/Hitchhikers-Guide-Python-Practices-Development/dp/1491933178/ref=as_li_ss_il?ie=UTF8&linkCode=li2&tag=bookforkind-20&linkId=804806ebdacaf3b56567347f3afbdbca   302
diff --git a/docs/_extra/ads.txt b/docs/_extra/ads.txt
new file mode 100644
index 0000000..52291a9
--- /dev/null
+++ b/docs/_extra/ads.txt
@@ -0,0 +1,340 @@
+33across.com, 0010b00002Mpn7AAAR, DIRECT, bbea06d9c4d2853c
+33across.com, 0013300001kQj2HAAS, RESELLER, bbea06d9c4d2853c
+33across.com, 0013300001qkdlwAAA, RESELLER
+33across.com, 0013300001r0t9mAAA, RESELLER
+33across.com, 0014000001aXjnGAAS, RESELLER, bbea06d9c4d2853c # 33 Across
+33across.com,0013300001r0t9mAAA,reseller,bbea06d9c4d2853c
+ad-generation.jp,12474,RESELLER,7f4ea9029ac04e53
+adform.com, 183, RESELLER
+adform.com, 2708, DIRECT, 9f5210a2f0999e32
+adtech.com, 10947, DIRECT, e1a5b5b6e3255540
+adtech.com, 11095, RESELLER
+adtech.com, 11119, RESELLER
+adtech.com, 11208, RESELLER
+adtech.com, 11341, DIRECT
+adtech.com, 12094, RESELLER
+adtech.com, 12094, RESELLER # 33 Across
+adtech.com, 9904, RESELLER
+adtech.com,12068,RESELLER,e1a5b5b6e3255540
+advangelists.com, 8d3bba7425e7c98c50f52ca1b52d3735, RESELLER, 60d26397ec060f98
+advangelists.com, 8d3bba7425e7c98c50f52ca1b52d3735, RESELLER, 60d26397ec060f98 # 33 Across
+advertising.com, 11602, RESELLER
+Advertising.com, 16736, RESELLER
+advertising.com, 19623, RESELLER # AOL - One
+advertising.com, 24410, RESELLER
+advertising.com, 28409, DIRECT, e1a5b5b6e3255540
+advertising.com, 28509, DIRECT, e1a5b5b6e3255540
+advertising.com, 28605, RESELLER # RhythmOne
+advertising.com, 7372, RESELLER
+advertising.com, 8603, RESELLER # Taboola
+amxrtb.com, 105199384, DIRECT
+aol.com, 11119, DIRECT
+aol.com, 53392, RESELLER # Taboola
+aolcloud.net, 9904, RESELLER
+appnexus.com, 1001, RESELLER, f5ab79cb980f11d1
+appnexus.com, 10239, RESELLER, f5ab79cb980f11d1
+appnexus.com, 10239, RESELLER, f5ab79cb980f11d1 # 33 Across
+appnexus.com, 11786, RESELLER, f5ab79cb980f11d1
+appnexus.com, 11801, RESELLER
+appnexus.com, 11924, RESELLER, f5ab79cb980f11d1
+appnexus.com, 12061, RESELLER
+appnexus.com, 12263, RESELLER
+appnexus.com, 12290, RESELLER, f5ab79cb980f11d1
+appnexus.com, 12366, RESELLER, f5ab79cb980f11d1
+appnexus.com, 1314, RESELLER
+Appnexus.com, 1356, RESELLER, f5ab79cb980f11d1
+appnexus.com, 1360, RESELLER, f5ab79cb980f11d1
+appnexus.com, 1613, reseller
+appnexus.com, 1908, RESELLER
+appnexus.com, 1908, RESELLER, f5ab79cb980f11d1
+appnexus.com, 1908, RESELLER, f5ab79cb980f11d1 # DistrictM
+appnexus.com, 1942, RESELLER, f5ab79cb980f11d1
+appnexus.com, 2530, RESELLER
+appnexus.com, 2758, RESELLER, f5ab79cb980f11d1
+appnexus.com, 3135, RESELLER, f5ab79cb980f11d1
+appnexus.com, 3153, DIRECT
+appnexus.com, 3153, RESELLER
+appnexus.com, 3153, RESELLER, f5ab79cb980f11d1
+appnexus.com, 3326, reseller
+appnexus.com, 4052, RESELLER
+appnexus.com, 4052, RESELLER, f5ab79cb980f11d1 # Conversant
+appnexus.com, 6849, RESELLER, f5ab79cb980f11d1 # RhythmOne
+appnexus.com, 7118, RESELLER
+appnexus.com, 7556, DIRECT, f5ab79cb980f11d1
+appnexus.com, 7597, RESELLER, f5ab79cb980f11d1
+appnexus.com, 7911, RESELLER #yieldmo
+appnexus.com, 7944, RESELLER
+appnexus.com, 8692, DIRECT, f5ab79cb980f11d1
+appnexus.com, 9316, RESELLER, f5ab79cb980f11d1 # AppNexus
+appnexus.com, 9393, DIRECT
+appnexus.com, 9393, RESELLER #Video #Display, f5ab79cb980f11d1
+appnexus.com,1001,reseller,f5ab79cb980f11d1
+appnexus.com,10239,reseller,f5ab79cb980f11d1
+appnexus.com,1356,reseller,f5ab79cb980f11d1
+appnexus.com,1908,RESELLER,f5ab79cb980f11d1
+appnexus.com,2758,reseller,f5ab79cb980f11d1
+appnexus.com,3663,RESELLER,f5ab79cb980f11d1
+appnexus.com,7597,reseller,f5ab79cb980f11d1
+appnexus.com,9316,reseller,f5ab79cb980f11d1
+aps.amazon.com,094e2c86-72d9-47d6-a647-d95ce39ad4c7,DIRECT
+aps.amazon.com,2840f06c-5d89-4853-a03e-3bfa567dd33c,reseller
+aps.amazon.com,48266a61-b3d9-4cb7-b172-553abc6a42a4,DIRECT
+aralego.com, par-488A3E6BD8D997D0ED8B3BD34D8BA4B, RESELLER # ucFunnel
+audienciad.com, 202922, DIRECT
+bidtellect.com, 1407, RESELLER, 1c34aa2d85d45e93
+bidtellect.com,1407,reseller,1c34aa2d85d45e93
+brightcom.com, 20292, DIRECT
+ccoxmt.com, 2000067997702, RESELLER
+consumable.com, 2000908, DIRECT, aefcd3d2f45b5070
+contextweb.com, 558355, RESELLER
+contextweb.com, 558511, RESELLER
+contextweb.com, 560606, RESELLER
+contextweb.com, 560606, RESELLER, 89ff185a4c4e857
+contextweb.com, 560606, RESELLER, 89ff185a4c4e857c
+contextweb.com, 561118, RESELLER, 89ff185a4c4e857c #yieldmo
+contextweb.com, 561998, RESELLER, 89ff185a4c4e857c
+contextweb.com, 562350, RESELLER, 89ff185a4c4e857c
+contextweb.com,558355,reseller
+conversantmedia.com, 20923, RESELLER # Conversant
+conversantmedia.com, 39882, DIRECT, 03113cd04947736d
+conversantmedia.com, 40790, RESELLER, 03113cd04947736d
+conversantmedia.com, 41812, DIRECT
+coxmt.com, 2000067907202, RESELLER
+criteo.com, 109412, DIRECT, 9fac4a4a87c2a44f
+districtm.io, 100808, DIRECT
+districtm.io, 100835, DIRECT
+districtm.io, 100835, DIRECT, 3fd707be9c4527c3
+districtm.io, 101080, RESELLER
+districtm.io, 101769, RESELLER, 3fd707be9c4527c3 # DistrictM
+districtm.io,100962,RESELLER,3fd707be9c4527c3
+EMXDGT.com, 1133, DIRECT, 1e1d41537f7cad7f
+emxdgt.com, 20, DIRECT, 1e1d41537f7cad7f
+emxdgt.com, 326, RESELLER, 1e1d41537f7cad7f
+emxdgt.com, 326, RESELLER, 1e1d41537f7cad7f # 33 Across
+EMXDGT.com,1284,reseller,1e1d41537f7cad7f
+engagebdr.com, 10417, RESELLER # EngageDBR
+freewheel.tv, 146081, reseller
+freewheel.tv, 19129, RESELLER
+freewheel.tv, 19133, RESELLER
+freewheel.tv, 33081, RESELLER
+freewheel.tv, 33601, RESELLER
+freewheel.tv, 799841, RESELLER # Taboola
+freewheel.tv, 799921, RESELLER # Taboola
+google.com, pub-1320774679920841, RESELLER, f08c47fec0942fa0
+google.com, pub-1409765517756851, reseller
+google.com, pub-2290755540215120, RESELLER, f08c47fec0942fa0
+google.com, pub-2802445174821308, RESELLER, f08c47fec0942fa0
+google.com, pub-3848273848634341, RESELLER, f08c47fec0942fa0
+google.com, pub-4075894099602271, reseller
+google.com, pub-4207323757133151, RESELLER, f08c47fec0942fa0
+google.com, pub-4641608711979091, DIRECT, f08c47fec0942fa0
+google.com, pub-5231479214411897, RESELLER, f08c47fec0942fa0
+Google.com, pub-5995202563537249, RESELLER, f08c47fec0942fa0
+google.com, pub-6314168058065736, RESELLER, f08c47fec0942fa0
+google.com, pub-8172268348509349, RESELLER, f08c47fec0942fa0
+google.com, pub-9557089510405422, RESELLER, f08c47fec0942fa0
+google.com, pub-9557089510405422, RESELLER, f08c47fec0942fa0 # 33 Across
+google.com, pub-9685734445476814, RESELLER, f08c47fec0942fa0
+google.com, pub-9685734445476814, RESELLER, f08c47fec0942fa0 # DistrictM
+google.com,pub-3848273848634341,reseller,f08c47fec0942fa0
+google.com,pub-9557089510405422,reseller,f08c47fec0942fa0
+gumgum.com, 11645, RESELLER, ffdef49475d318a9
+gumgum.com, 13174, DIRECT, ffdef49475d318a9
+gumgum.com, 13318, RESELLER, ffdef49475d318a9
+gumgum.com, 13318, RESELLER, ffdef49475d318a9 # 33 Across
+gumgum.com, 13504, RESELLER, ffdef49475d318a9
+gumgum.com,13174,DIRECT,ffdef49475d318a9
+gumgum.com,14141,RESELLER,ffdef49475d318a9
+improvedigital.com, 1362, RESELLER
+improvedigital.com, 1669, RESELLER # ImproveDigital
+improvedigital.com, 185, RESELLER
+indexexchange.com, 175407, RESELLER
+indexexchange.com, 177754, RESELLER, 50b1c356f2c5c8fc
+indexexchange.com, 182257, RESELLER, 50b1c356f2c5c8fc # RhythmOne
+indexexchange.com, 183965, RESELLER, 50b1c356f2c5c8fc # AOL - One
+indexexchange.com, 184914, DIRECT, 50b1c356f2c5c8fc
+indexexchange.com, 186046, RESELLER
+indexexchange.com, 186248, DIRECT, 50b1c356f2c5c8fc
+indexexchange.com, 187196, DIRECT
+indexexchange.com, 187454, DIRECT, 50b1c356f2c5c8fc
+indexexchange.com, 189744, RESELLER
+indexexchange.com, 189872, RESELLER
+indexexchange.com, 191503, RESELLER, 50b1c356f2c5c8fc
+indexexchange.com, 191740, RESELLER, 50b1c356f2c5c8fc # Index
+indexexchange.com, 191923, RESELLER
+indexexchange.com, 191973, RESELLER, 50b1c356f2c5c8fc
+indexexchange.com, 193351, DIRECT
+lijit.com, 217352, DIRECT, fafdf38b16bf6b2b
+lijit.com, 217352-eb, DIRECT, fafdf38b16bf6b2b
+lijit.com, 248396, DIRECT, fafdf38b16bf6b2b
+lijit.com, 248396-eb, DIRECT, fafdf38b16bf6b2b
+lijit.com, 260380, RESELLER, fafdf38b16bf6b2b
+lijit.com, 270524, RESELLER, fafdf38b16bf6b2b
+lijit.com,217352,DIRECT,fafdf38b16bf6b2b
+lkqd.com, 470, RESELLER, 59c49fa9598a0117
+lkqd.net, 470, RESELLER, 59c49fa9598a0117
+Newormedia.com, 2169, DIRECT
+newormedia.com, 4908, DIRECT
+onetag.com, 572a470226457b8, RESELLER # OneTag
+onetag.com, 664e107d9f2b748, RESELLER #yieldmo
+onomagic.com, 202921, DIRECT
+openx.com,  539824308, RESELLER, 6a698e2ec38604c6
+openx.com, 537120563, RESELLER, 6a698e2ec38604c6
+openx.com, 537120563, RESELLER, 6a698e2ec38604c6 # 33 Across
+openx.com, 537120960, RESELLER
+openx.com, 537127577, RESELLER, 6a698e2ec38604c6
+Openx.com, 537143344, RESELLER
+openx.com, 537149485, RESELLER, 6a698e2ec38604c6
+openx.com, 537150004, DIRECT, 6a698e2ec38604c6
+openx.com, 537153209, RESELLER, 6a698e2ec38604c6
+openx.com, 538959099, RESELLER
+openx.com, 538959099, RESELLER, 6a698e2ec38604c6
+openx.com, 539699341, DIRECT, 6a698e2ec38604c6
+openx.com, 539824308, RESELLER, 6a698e2ec38604c6
+openx.com, 540003333, RESELLER, 6a698e2ec38604c6
+openx.com, 540031703, RESELLER, 6a698e2ec38604c6
+openx.com, 540031703, RESELLER, 6a698e2ec38604c6 # Conversant
+openx.com, 540258065, RESELLER, 6a698e2ec38604c6
+openx.com, 540274407, RESELLER, 6a698e2ec38604c6
+openx.com, 540337213, RESELLER, 6a698e2ec38604c6
+openx.com, 540401713, RESELLER, 6a698e2ec38604c6 # OpenX
+openx.com, 541159484, RESELLER, 6a698e2ec38604c6
+openx.com, 542511596, RESELLER, 6a698e2ec38604c6
+openx.com, 83499, RESELLER
+openx.com,537149485,reseller,6a698e2ec38604c6
+openx.com,540191398,RESELLER,6a698e2ec38604c6
+openx.com,540833447, RESELLER, 6a698e2ec38604c6
+outbrain.com, 01a755b08c8c22b15d46a8b753ab6955d4, DIRECT
+outbrain.com, 01a755b08c8c22b15d46a8b753ab6955d4, RESELLER
+outbrain.com,00254374f0c468f3b2732db17fd42cb6e5,reseller
+pubmatic.com, 137711, RESELLER
+pubmatic.com, 137711, RESELLER, 5d62403b186f2ace
+pubmatic.com, 156084, RESELLER, 5d62403b186f2ace # AOL - One
+pubmatic.com, 156212, RESELLER
+pubmatic.com, 156212, RESELLER, 5d62403b186f2ace
+pubmatic.com, 156307, RESELLER, 5d62403b186f2ace # Taboola
+pubmatic.com, 156319, DIRECT, 5d62403b186f2ace
+pubmatic.com, 156325, RESELLER, 5d62403b186f2ace # AOL - One
+pubmatic.com, 156344, RESELLER, 5d62403b186f2ace # Pubmatic
+pubmatic.com, 156423, RESELLER, 5d62403b186f2ace
+pubmatic.com, 156423, RESELLER, 5d62403b186f2ace # 33 Across
+pubmatic.com, 156458, RESELLER, 5d62403b186f2ace # AOL - One
+pubmatic.com, 156557, RESELLER
+pubmatic.com, 156595, RESELLER, 5d62403b186f2ace
+pubmatic.com, 157367, DIRECT, 5d62403b186f2ace
+pubmatic.com, 158100, RESELLER, 5d62403b186f2ace
+pubmatic.com, 158355 , RESELLER, 5d62403b186f2ace
+pubmatic.com, 158723, RESELLER, 5d62403b186f2ace
+pubmatic.com, 159117, DIRECT, 5d62403b186f2ace
+pubmatic.com, 159277, RESELLER, 5d62403b186f2ace # RhythmOne
+pubmatic.com, 159330, RESELLER, 5d62403b186f2ace
+pubmatic.com, 159477,RESELLER,5d62403b186f2ace
+pubmatic.com, 160082 , RESELLER, 5d62403b186f2ace
+pubmatic.com, 160131, RESELLER, 5d62403b186f2ace
+pubmatic.com, 32987, RESELLER, 5d62403b186f2ace
+pubmatic.com, 50758, RESELLER, 5d62403b186f2ace
+pubmatic.com, 62483, RESELLER
+pubmatic.com, 79136 , RESELLER, 5d62403b186f2ace
+pubmatic.com,157150,RESELLER,5d62403b186f2ace
+pubmatic.com,157897,reseller,5d62403b186f2ace
+pubmatic.com,160006,RESELLER,5d62403b186f2ace
+pubmatic.com,160096,RESELLER,5d62403b186f2ace
+pubnative.net, 1007284, RESELLER, d641df8625486a7b #yieldmodisplay
+pubnative.net, 1007285, RESELLER, d641df8625486a7b #yieldmonative
+pubnative.net, 1007286, RESELLER, d641df8625486a7b #yieldmovideo
+pubnx.com, 337-1, RESELLER, 8728b7e97e589da4 # Vertoz
+revcontent.com, 76611, RESELLER
+rhythmone.com, 1059622079, RESELLER
+rhythmone.com, 1059622079, RESELLER, a670c89d4a324e47
+rhythmone.com, 1114124056, RESELLER, a670c89d4a324e47
+rhythmone.com, 1166984029, RESELLER, a670c89d4a324e47 # Taboola
+rhythmone.com, 2241341073, RESELLER, a670c89d4a324e47
+rhythmone.com, 2310154583, DIRECT, a670c89d4a324e47
+rhythmone.com, 2439829435, RESELLER, a670c89d4a324e47
+rhythmone.com, 2439829435, RESELLER, a670c89d4a324e47 # 33 Across
+rhythmone.com, 78519861, RESELLER
+rhythmone.com, 905992537, RESELLER, a670c89d4a324e47 # RhythmOne
+rhythmone.com,1654642120,RESELLER,a670c89d4a324e47
+rhythmone.com,2310154583,DIRECT,a670c89d4a324e47
+rhythmone.com,78519861,reseller,a670c89d4a324e47
+rtk.io, 819, DIRECT
+rubiconproject.com, 13344, RESELLER, 0bfd66d529a55807 # Rubicon
+rubiconproject.com, 15268, RESELLER, 0bfd66d529a55807 # RhythmOne
+rubiconproject.com, 16414, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 16414, RESELLER, 0bfd66d529a55807 # 33 Across
+rubiconproject.com, 17070, RESELLER, 0bfd66d529a55807 #yieldmo
+rubiconproject.com, 17632, DIRECT, 0bfd66d529a55807
+rubiconproject.com, 17790, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 17792, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 17822, DIRECT, 0bfd66d529a55807
+rubiconproject.com, 17822, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 17960, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 18222, RESELLER, 0bfd66d529a55807 # AOL - One
+rubiconproject.com, 18694, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 18890, DIRECT, 0bfd66d529a55807
+rubiconproject.com, 20130, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 20416, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 21310,  RESELLER , 0bfd66d529a55807
+rubiconproject.com, 21642, RESELLER, 0bfd66d529a55807
+rubiconproject.com, 8861, reseller, 0bfd66d529a55807
+rubiconproject.com,18020,RESELLER,0bfd66d529a55807
+Sekindo.com, 20749, DIRECT, b6b21d256ef43532
+sharethrough.com, 3a0f657b, DIRECT, d53b998a7bd4ecd2
+sharethrough.com, d09156e5, RESELLER, d53b998a7bd4ecd2
+smaato.com, 1100033117, RESELLER
+smaato.com, 1100047713, RESELLER, 07bcf65f187117b4
+smaato.com,1100044650,RESELLER,07bcf65f187117b4
+smartadserver.com, 3436, RESELLER
+sonobi.com, 337f0e70cc, DIRECT
+sonobi.com, 37dd19ad4a, RESELLER, d1a215d9eb5aee9e
+sonobi.com, 6e5cfb5420, DIRECT, d1a215d9eb5aee9e
+sonobi.com, e55fb5d7c2, DIRECT, d1a215d9eb5aee9e
+sovrn.com, 217352, DIRECT, fafdf38b16bf6b2b
+sovrn.com, 248396, DIRECT, fafdf38b16bf6b2b
+sovrn.com, 260380, RESELLER, fafdf38b16bf6b2b
+sovrn.com, 270524, RESELLER, fafdf38b16bf6b2b
+sovrn.com,217352,DIRECT,fafdf38b16bf6b2b
+sparcmedia.com, 310627, Direct
+spotx.tv, 108933, RESELLER, 7842df1d2fe2db34
+spotx.tv, 147949, RESELLER, 7842df1d2fe2db34
+spotx.tv, 212457, RESELLER
+spotx.tv, 228454, RESELLER, 7842df1d2fe2db34
+spotx.tv, 270977, DIRECT, 7842df1d2fe2db34
+spotx.tv, 285547, RESELLER, 7842df1d2fe2db34 # RhythmOne
+spotx.tv, 71451, RESELLER, 7842df1d2fe2db34 # Taboola
+spotx.tv, 84294, RESELLER, 7842df1d2fe2db34
+spotx.tv, 94794, RESELLER, 7842df1d2fe2db34 # SpotX
+spotxchange.com, 108933, RESELLER, 7842df1d2fe2db34
+spotxchange.com, 147949, RESELLER, 7842df1d2fe2db34
+spotxchange.com, 212457, RESELLER
+spotxchange.com, 228454, RESELLER, 7842df1d2fe2db34
+spotxchange.com, 270977, DIRECT, 7842df1d2fe2db34
+spotxchange.com, 285547, RESELLER, 7842df1d2fe2db34 # RhythmOne
+spotxchange.com, 71451, RESELLER, 7842df1d2fe2db34 # Taboola
+spotxchange.com, 84294, RESELLER, 7842df1d2fe2db34
+spotxchange.com, 94794, RESELLER, 7842df1d2fe2db34 # SpotX
+springserve.com, 686, DIRECT, a24eb641fc82e93d
+synacor.com, 82350, RESELLER, e108f11b2cdf7d5b
+synacor.com,82151,reseller,e108f11b2cdf7d5b
+teads.tv, 19014, DIRECT, 15a9c44f6d26cbe1
+telaria.com, mb9eo-oqsbf, RESELLER, 1a4e959a1b50034a
+telaria.com, vtrdn-wjdav, DIRECT, 1a4e959a1b50034a
+telaria.com, vtrdn-ysjam, DIRECT,  1a4e959a1b50034a
+themediagrid.com, P5JONV, RESELLER, 35d5010d7789b49d # Media Grid (IPONWEB)
+tremorhub.com, mb9eo-oqsbf, RESELLER, 1a4e959a1b50034a
+tremorhub.com, vtrdn-wjdav, DIRECT, 1a4e959a1b50034a
+tremorhub.com, vtrdn-ysjam, DIRECT, 1a4e959a1b50034a
+tremorhub.com, z87wm, RESELLER, 1a4e959a1b50034a # Taboola
+triplelift.com, 7205, DIRECT, 6c33edb13117fd86
+ucfunnel.com, par-488A3E6BD8D997D0ED8B3BD34D8BA4B, RESELLER # ucFunnel
+vertamedia.com, 287605, DIRECT, 7de89dc7742b5b11
+vertamedia.com, 287605, RESELLER, 7de89dc7742b5b11
+video.unrulymedia.com, 2310154583, DIRECT
+video.unrulymedia.com, 905992537, RESELLER, a670c89d4a324e47 # RhythmOne
+yahoo.com,  55771, RESELLER, e1a5b5b6e3255540
+yahoo.com, 55104, DIRECT, e1a5b5b6e3255540
+yahoo.com, 55317, RESELLER # Verizon
+yahoo.com, 57289, RESELLER,  e1a5b5b6e3255540
+yahoo.com, 57695, DIRECT, e1a5b5b6e3255540
+yahoo.com,55029,RESELLER,e1a5b5b6e3255540
+yieldmo.com, 2417496099628458357, DIRECT
diff --git a/docs/_extra/robots.txt b/docs/_extra/robots.txt
new file mode 100644
index 0000000..eb05362
--- /dev/null
+++ b/docs/_extra/robots.txt
@@ -0,0 +1,2 @@
+User-agent: *
+Disallow:
diff --git a/docs/_static/ad.png b/docs/_static/ad.png
deleted file mode 100644
index 48a7894..0000000
Binary files a/docs/_static/ad.png and /dev/null differ
diff --git a/docs/_static/github-star.css b/docs/_static/github-star.css
new file mode 100644
index 0000000..2c22f28
--- /dev/null
+++ b/docs/_static/github-star.css
@@ -0,0 +1,91 @@
+.github-star {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+  height: 35px;
+  margin: 0 auto 1em;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 16px;
+  font-weight: 700;
+  line-height: 22px;
+}
+
+.github-star a {
+  border-bottom: 0;
+}
+
+.github-star__button,
+.github-star__count {
+  box-sizing: border-box;
+  color: #333;
+  text-decoration: none;
+  white-space: nowrap;
+  border: 1px solid #d5d5d5;
+  border-radius: 4px;
+}
+
+.github-star__button {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 3px 10px 3px 8px;
+  background-color: #eee;
+  background-image: linear-gradient(to bottom, #fcfcfc 0, #eee 100%);
+}
+
+.github-star__button:hover,
+.github-star__button:focus,
+.github-star__count:hover,
+.github-star__count:focus {
+  color: #0366d6;
+  text-decoration: none;
+}
+
+.github-star__button:hover,
+.github-star__button:focus {
+  background-color: #ddd;
+  background-image: linear-gradient(to bottom, #eee 0, #ddd 100%);
+  border-color: #ccc;
+}
+
+.github-star__icon {
+  flex: 0 0 auto;
+}
+
+.github-star__count {
+  position: relative;
+  display: inline-block;
+  min-width: 56px;
+  margin-left: 6px;
+  padding: 3px 10px;
+  text-align: center;
+  background-color: #fafafa;
+  border-color: #d4d4d4;
+}
+
+.github-star__count::before,
+.github-star__count::after {
+  position: absolute;
+  top: 50%;
+  display: inline-block;
+  width: 0;
+  height: 0;
+  content: "";
+  border-color: transparent;
+  border-style: solid;
+}
+
+.github-star__count::before {
+  left: -5px;
+  margin-top: -6px;
+  border-width: 6px 6px 6px 0;
+  border-right-color: #fafafa;
+}
+
+.github-star__count::after {
+  left: -6px;
+  z-index: -1;
+  margin-top: -7px;
+  border-width: 7px 7px 7px 0;
+  border-right-color: #d4d4d4;
+}
diff --git a/docs/_static/github-star.js b/docs/_static/github-star.js
new file mode 100644
index 0000000..634a74a
--- /dev/null
+++ b/docs/_static/github-star.js
@@ -0,0 +1,44 @@
+(function () {
+  function formatCount(count) {
+    return Number(count).toLocaleString("en-US");
+  }
+
+  function updateStarCount(container, count) {
+    var countLink = container.querySelector("[data-github-star-count]");
+    if (!countLink) {
+      return;
+    }
+
+    var formattedCount = formatCount(count);
+    countLink.textContent = formattedCount;
+    countLink.setAttribute("aria-label", formattedCount + " stargazers on GitHub");
+  }
+
+  Array.prototype.forEach.call(document.querySelectorAll("[data-github-star]"), function (container) {
+    var repo = container.getAttribute("data-github-repo");
+    if (!repo || !window.fetch) {
+      return;
+    }
+
+    window
+      .fetch("https://api.github.com/repos/" + repo, {
+        headers: {
+          Accept: "application/vnd.github+json",
+        },
+      })
+      .then(function (response) {
+        if (!response.ok) {
+          throw new Error("GitHub API request failed");
+        }
+        return response.json();
+      })
+      .then(function (repoData) {
+        if (typeof repoData.stargazers_count === "number") {
+          updateStarCount(container, repoData.stargazers_count);
+        }
+      })
+      .catch(function () {
+        // Keep the server-rendered fallback count visible when the API is unavailable.
+      });
+  });
+})();
diff --git a/docs/_static/guide-book-cover.jpg b/docs/_static/guide-book-cover.jpg
new file mode 100644
index 0000000..abbbc28
Binary files /dev/null and b/docs/_static/guide-book-cover.jpg differ
diff --git a/docs/_static/photos/32800783863_11a00db52c_k_d.jpg b/docs/_static/photos/32800783863_11a00db52c_k_d.jpg
new file mode 100644
index 0000000..649272a
Binary files /dev/null and b/docs/_static/photos/32800783863_11a00db52c_k_d.jpg differ
diff --git a/docs/_static/photos/32800805573_568d6b72fd_k_d.jpg b/docs/_static/photos/32800805573_568d6b72fd_k_d.jpg
new file mode 100644
index 0000000..208bbe8
Binary files /dev/null and b/docs/_static/photos/32800805573_568d6b72fd_k_d.jpg differ
diff --git a/docs/_static/photos/33175624924_7febc46cc4_k_d.jpg b/docs/_static/photos/33175624924_7febc46cc4_k_d.jpg
new file mode 100644
index 0000000..040660b
Binary files /dev/null and b/docs/_static/photos/33175624924_7febc46cc4_k_d.jpg differ
diff --git a/docs/_static/photos/33175625804_e225b90f3e_k_d.jpg b/docs/_static/photos/33175625804_e225b90f3e_k_d.jpg
new file mode 100644
index 0000000..c356d03
Binary files /dev/null and b/docs/_static/photos/33175625804_e225b90f3e_k_d.jpg differ
diff --git a/docs/_static/photos/33467946364_3e59bd376a_k_d.jpg b/docs/_static/photos/33467946364_3e59bd376a_k_d.jpg
new file mode 100644
index 0000000..75a02fd
Binary files /dev/null and b/docs/_static/photos/33467946364_3e59bd376a_k_d.jpg differ
diff --git a/docs/_static/photos/33573755856_7f43d43adf_k_d.jpg b/docs/_static/photos/33573755856_7f43d43adf_k_d.jpg
new file mode 100644
index 0000000..54781c3
Binary files /dev/null and b/docs/_static/photos/33573755856_7f43d43adf_k_d.jpg differ
diff --git a/docs/_static/photos/33573767786_eececc5d27_k_d.jpg b/docs/_static/photos/33573767786_eececc5d27_k_d.jpg
new file mode 100644
index 0000000..1b529fa
Binary files /dev/null and b/docs/_static/photos/33573767786_eececc5d27_k_d.jpg differ
diff --git a/docs/_static/photos/33573769116_49c1ef51e7_k_d.jpg b/docs/_static/photos/33573769116_49c1ef51e7_k_d.jpg
new file mode 100644
index 0000000..a7734c7
Binary files /dev/null and b/docs/_static/photos/33573769116_49c1ef51e7_k_d.jpg differ
diff --git a/docs/_static/photos/33888714601_a1f7d020a2_k_d.jpg b/docs/_static/photos/33888714601_a1f7d020a2_k_d.jpg
new file mode 100644
index 0000000..efdbea5
Binary files /dev/null and b/docs/_static/photos/33888714601_a1f7d020a2_k_d.jpg differ
diff --git a/docs/_static/photos/33907143624_cd621b535c_k_d.jpg b/docs/_static/photos/33907143624_cd621b535c_k_d.jpg
new file mode 100644
index 0000000..d7604c1
Binary files /dev/null and b/docs/_static/photos/33907143624_cd621b535c_k_d.jpg differ
diff --git a/docs/_static/photos/33907149294_82d7535a6c_k_d.jpg b/docs/_static/photos/33907149294_82d7535a6c_k_d.jpg
new file mode 100644
index 0000000..85bb549
Binary files /dev/null and b/docs/_static/photos/33907149294_82d7535a6c_k_d.jpg differ
diff --git a/docs/_static/photos/33907150054_5ee79e8940_k_d.jpg b/docs/_static/photos/33907150054_5ee79e8940_k_d.jpg
new file mode 100644
index 0000000..93e98f4
Binary files /dev/null and b/docs/_static/photos/33907150054_5ee79e8940_k_d.jpg differ
diff --git a/docs/_static/photos/33907150594_9abba7ad0a_k_d.jpg b/docs/_static/photos/33907150594_9abba7ad0a_k_d.jpg
new file mode 100644
index 0000000..480d6e1
Binary files /dev/null and b/docs/_static/photos/33907150594_9abba7ad0a_k_d.jpg differ
diff --git a/docs/_static/photos/33907151034_e0a9e53402_k_d.jpg b/docs/_static/photos/33907151034_e0a9e53402_k_d.jpg
new file mode 100644
index 0000000..ae0136d
Binary files /dev/null and b/docs/_static/photos/33907151034_e0a9e53402_k_d.jpg differ
diff --git a/docs/_static/photos/33907151224_0574e7dfc2_k_d.jpg b/docs/_static/photos/33907151224_0574e7dfc2_k_d.jpg
new file mode 100644
index 0000000..cf218c7
Binary files /dev/null and b/docs/_static/photos/33907151224_0574e7dfc2_k_d.jpg differ
diff --git a/docs/_static/photos/33907152464_a99fdcc8de_k_d.jpg b/docs/_static/photos/33907152464_a99fdcc8de_k_d.jpg
new file mode 100644
index 0000000..91bfebb
Binary files /dev/null and b/docs/_static/photos/33907152464_a99fdcc8de_k_d.jpg differ
diff --git a/docs/_static/photos/33907152824_bf91078cc1_k_d.jpg b/docs/_static/photos/33907152824_bf91078cc1_k_d.jpg
new file mode 100644
index 0000000..7b3151f
Binary files /dev/null and b/docs/_static/photos/33907152824_bf91078cc1_k_d.jpg differ
diff --git a/docs/_static/photos/33925223870_97e44f5629_k_d.jpg b/docs/_static/photos/33925223870_97e44f5629_k_d.jpg
new file mode 100644
index 0000000..b271f26
Binary files /dev/null and b/docs/_static/photos/33925223870_97e44f5629_k_d.jpg differ
diff --git a/docs/_static/photos/33928819683_97b5c6a184_k_d.jpg b/docs/_static/photos/33928819683_97b5c6a184_k_d.jpg
new file mode 100644
index 0000000..8bdd908
Binary files /dev/null and b/docs/_static/photos/33928819683_97b5c6a184_k_d.jpg differ
diff --git a/docs/_static/photos/33928823133_2f3d32cf32_k_d.jpg b/docs/_static/photos/33928823133_2f3d32cf32_k_d.jpg
new file mode 100644
index 0000000..9952120
Binary files /dev/null and b/docs/_static/photos/33928823133_2f3d32cf32_k_d.jpg differ
diff --git a/docs/_static/photos/34018729885_002ced9b54_k_d.jpg b/docs/_static/photos/34018729885_002ced9b54_k_d.jpg
new file mode 100644
index 0000000..5420bb6
Binary files /dev/null and b/docs/_static/photos/34018729885_002ced9b54_k_d.jpg differ
diff --git a/docs/_static/photos/34018732105_f0e6758859_k_d.jpg b/docs/_static/photos/34018732105_f0e6758859_k_d.jpg
new file mode 100644
index 0000000..1a4c3dd
Binary files /dev/null and b/docs/_static/photos/34018732105_f0e6758859_k_d.jpg differ
diff --git a/docs/_static/photos/34151833832_6bdfd930af_k_d.jpg b/docs/_static/photos/34151833832_6bdfd930af_k_d.jpg
new file mode 100644
index 0000000..21fada7
Binary files /dev/null and b/docs/_static/photos/34151833832_6bdfd930af_k_d.jpg differ
diff --git a/docs/_static/photos/34268661876_442428e122_k_d.jpg b/docs/_static/photos/34268661876_442428e122_k_d.jpg
new file mode 100644
index 0000000..f6ce0be
Binary files /dev/null and b/docs/_static/photos/34268661876_442428e122_k_d.jpg differ
diff --git a/docs/_static/photos/34309496175_b82d104282_k_d.jpg b/docs/_static/photos/34309496175_b82d104282_k_d.jpg
new file mode 100644
index 0000000..a09fd0a
Binary files /dev/null and b/docs/_static/photos/34309496175_b82d104282_k_d.jpg differ
diff --git a/docs/_static/photos/34364815780_bea6614025_k_d.jpg b/docs/_static/photos/34364815780_bea6614025_k_d.jpg
new file mode 100644
index 0000000..ab05248
Binary files /dev/null and b/docs/_static/photos/34364815780_bea6614025_k_d.jpg differ
diff --git a/docs/_static/photos/34435687940_8f73fc1fa6_k_d.jpg b/docs/_static/photos/34435687940_8f73fc1fa6_k_d.jpg
new file mode 100644
index 0000000..e765c7c
Binary files /dev/null and b/docs/_static/photos/34435687940_8f73fc1fa6_k_d.jpg differ
diff --git a/docs/_static/photos/34435688380_b5a740762b_k_d.jpg b/docs/_static/photos/34435688380_b5a740762b_k_d.jpg
new file mode 100644
index 0000000..baa1f17
Binary files /dev/null and b/docs/_static/photos/34435688380_b5a740762b_k_d.jpg differ
diff --git a/docs/_static/photos/34435688560_4cc2a7bcbb_k_d.jpg b/docs/_static/photos/34435688560_4cc2a7bcbb_k_d.jpg
new file mode 100644
index 0000000..fe4c1aa
Binary files /dev/null and b/docs/_static/photos/34435688560_4cc2a7bcbb_k_d.jpg differ
diff --git a/docs/_static/photos/34435689480_2e6f358510_k_d.jpg b/docs/_static/photos/34435689480_2e6f358510_k_d.jpg
new file mode 100644
index 0000000..87e2781
Binary files /dev/null and b/docs/_static/photos/34435689480_2e6f358510_k_d.jpg differ
diff --git a/docs/_static/photos/34435690330_11930b5987_k_d.jpg b/docs/_static/photos/34435690330_11930b5987_k_d.jpg
new file mode 100644
index 0000000..74b44e0
Binary files /dev/null and b/docs/_static/photos/34435690330_11930b5987_k_d.jpg differ
diff --git a/docs/_static/photos/34435690580_3afec7d4cd_k_d.jpg b/docs/_static/photos/34435690580_3afec7d4cd_k_d.jpg
new file mode 100644
index 0000000..4a00c54
Binary files /dev/null and b/docs/_static/photos/34435690580_3afec7d4cd_k_d.jpg differ
diff --git a/docs/_static/photos/34484834733_5b80f65ab1_k_d.jpg b/docs/_static/photos/34484834733_5b80f65ab1_k_d.jpg
new file mode 100644
index 0000000..8a667d2
Binary files /dev/null and b/docs/_static/photos/34484834733_5b80f65ab1_k_d.jpg differ
diff --git a/docs/_static/photos/34575689432_3de8e9a348_k_d.jpg b/docs/_static/photos/34575689432_3de8e9a348_k_d.jpg
new file mode 100644
index 0000000..88c760e
Binary files /dev/null and b/docs/_static/photos/34575689432_3de8e9a348_k_d.jpg differ
diff --git a/docs/_static/photos/34689432801_78d97ecec9_k_d.jpg b/docs/_static/photos/34689432801_78d97ecec9_k_d.jpg
new file mode 100644
index 0000000..50554cf
Binary files /dev/null and b/docs/_static/photos/34689432801_78d97ecec9_k_d.jpg differ
diff --git a/docs/_static/photos/34689452831_93d7fd0571_k_d.jpg b/docs/_static/photos/34689452831_93d7fd0571_k_d.jpg
new file mode 100644
index 0000000..ab2ae07
Binary files /dev/null and b/docs/_static/photos/34689452831_93d7fd0571_k_d.jpg differ
diff --git a/docs/_static/photos/34725946825_0f85497e60_k_d.jpg b/docs/_static/photos/34725946825_0f85497e60_k_d.jpg
new file mode 100644
index 0000000..5d58e91
Binary files /dev/null and b/docs/_static/photos/34725946825_0f85497e60_k_d.jpg differ
diff --git a/docs/_static/photos/34725951345_c8f5959a2e_k_d.jpg b/docs/_static/photos/34725951345_c8f5959a2e_k_d.jpg
new file mode 100644
index 0000000..c982f1f
Binary files /dev/null and b/docs/_static/photos/34725951345_c8f5959a2e_k_d.jpg differ
diff --git a/docs/_static/photos/35254379756_c9fe23f843_k_d.jpg b/docs/_static/photos/35254379756_c9fe23f843_k_d.jpg
new file mode 100644
index 0000000..c255607
Binary files /dev/null and b/docs/_static/photos/35254379756_c9fe23f843_k_d.jpg differ
diff --git a/docs/_static/photos/35294660055_42c02b2316_k_d.jpg b/docs/_static/photos/35294660055_42c02b2316_k_d.jpg
new file mode 100644
index 0000000..f7cc6b9
Binary files /dev/null and b/docs/_static/photos/35294660055_42c02b2316_k_d.jpg differ
diff --git a/docs/_static/photos/35620636012_f66aa88f93_k_d.jpg b/docs/_static/photos/35620636012_f66aa88f93_k_d.jpg
new file mode 100644
index 0000000..e3a1b74
Binary files /dev/null and b/docs/_static/photos/35620636012_f66aa88f93_k_d.jpg differ
diff --git a/docs/_static/photos/36137232412_fdcb0f84eb_k_d.jpg b/docs/_static/photos/36137232412_fdcb0f84eb_k_d.jpg
new file mode 100644
index 0000000..ed1364a
Binary files /dev/null and b/docs/_static/photos/36137232412_fdcb0f84eb_k_d.jpg differ
diff --git a/docs/_static/photos/36137234682_be6898bf57_k_d.jpg b/docs/_static/photos/36137234682_be6898bf57_k_d.jpg
new file mode 100644
index 0000000..fed8514
Binary files /dev/null and b/docs/_static/photos/36137234682_be6898bf57_k_d.jpg differ
diff --git a/docs/_static/social-card.jpg b/docs/_static/social-card.jpg
new file mode 100644
index 0000000..9f74ef1
Binary files /dev/null and b/docs/_static/social-card.jpg differ
diff --git a/docs/_templates/github_star.html b/docs/_templates/github_star.html
new file mode 100644
index 0000000..2282927
--- /dev/null
+++ b/docs/_templates/github_star.html
@@ -0,0 +1,33 @@
+<link rel="stylesheet" href="{{ pathto('_static/github-star.css', 1) }}" />
+<div class="github-star" data-github-star data-github-repo="Prodesire/Python-Guide-CN">
+  <a
+    class="github-star__button"
+    href="https://github.com/Prodesire/Python-Guide-CN"
+    rel="noopener noreferrer"
+    target="_blank"
+    aria-label="Star Prodesire/Python-Guide-CN on GitHub"
+  >
+    <svg
+      class="github-star__icon"
+      viewBox="0 0 16 16"
+      width="16"
+      height="16"
+      aria-hidden="true"
+    >
+      <path
+        fill="currentColor"
+        d="M8 .25a8 8 0 0 0-2.53 15.59c.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82a7.65 7.65 0 0 1 4 0c1.53-1.03 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.19 0 .21.15.46.55.38A8 8 0 0 0 8 .25Z"
+      />
+    </svg>
+    <span>Star</span>
+  </a>
+  <a
+    class="github-star__count"
+    href="https://github.com/Prodesire/Python-Guide-CN/stargazers"
+    rel="noopener noreferrer"
+    target="_blank"
+    aria-label="4,420 stargazers on GitHub"
+    data-github-star-count
+  >4,420</a>
+</div>
+<script src="{{ pathto('_static/github-star.js', 1) }}" defer></script>
diff --git a/docs/_templates/hacks.html b/docs/_templates/hacks.html
index 9c925d1..cea323b 100644
--- a/docs/_templates/hacks.html
+++ b/docs/_templates/hacks.html
@@ -1,45 +1 @@
 <!-- Alabaster (krTheme++) Hacks -->
-<aside id="python27">
-  Python 3 —— 新的最佳实践, 会继续存在。
-  Python 2 在仅仅 <time></time> 个月后就会退休！
-</aside>
-
-<!-- Python 2 Death Clock™ -->
-<style type="text/css">
-body { margin-top: 4em; }
-#python27 {
-    position: fixed;
-    top: 0;
-    left: 0; right: 0;
-    height:  auto;
-    text-align: center;
-    color: white;
-    background-color: black;
-    font-size: larger;
-    line-height: 3;
-}
-
-</style>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.18.1/moment.min.js"></script>
-<script>
-var death = new Date('2020-04-12');
-
-var diff = moment.duration(death - moment());
-
-document.querySelector('#python27 time').innerText = (diff.years() * 12) + diff.months();
-</script>
-
-<script type="text/javascript">
-  var _gauges = _gauges || [];
-  (function() {
-    var t   = document.createElement('script');
-    t.type  = 'text/javascript';
-    t.async = true;
-    t.id    = 'gauges-tracker';
-    t.setAttribute('data-site-id', '56ca79a64b2ffa7a470027ea');
-    t.setAttribute('data-track-path', 'https://track.gaug.es/track.gif');
-    t.src = 'https://d36ee2fcip1434.cloudfront.net/track.js';
-    var s = document.getElementsByTagName('script')[0];
-    s.parentNode.insertBefore(t, s);
-  })();
-</script>
diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
new file mode 100644
index 0000000..6a6a22b
--- /dev/null
+++ b/docs/_templates/layout.html
@@ -0,0 +1,113 @@
+{% extends "!layout.html" %}
+
+{%- block extrahead %}
+  {# No super() because we want to avoid loading an empty custom.css file #}
+
+  {# <meta name="viewport" content="width=device-width, initial-scale=0.75, maximum-scale=0.75" /> #}
+
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <style>
+    div.body {
+      min-width: initial;
+      max-width: initial;
+    }
+  </style>
+
+  {% if pagename == 'index' %}
+  <link rel="canonical" href="https://docs.python-guide.org/"/>
+  <meta property="og:url" content="https://docs.python-guide.org/">
+  {% elif pagename == '404' %}
+  {# No canonical on our 404 template. #}
+  {% else %}
+  <link rel="canonical" href="https://docs.python-guide.org/{{ pagename }}/"/>
+  <meta property="og:url" content="https://docs.python-guide.org/{{ pagename }}">
+  {% endif %}
+
+  <link rel="icon" type="image/png" href="https://media.readthedocs.org/images/favicon.png">
+
+  <meta name="google-site-verification" content="013PxE2_8KX9jdUSC5gr8QsfdxTXr1mFgmD9zplp5II" />
+
+  <meta name="twitter:card" content="summary">
+  <meta property="twitter:image" content="https://docs.python-guide.org/_static/social-card.jpg">
+  <meta property="og:image" content="https://docs.python-guide.org/_static/social-card.jpg">
+  <meta property="og:title" content="{{ title }}{{ titlesuffix }}">
+  <meta property="og:type" content="article">
+  {%- if metatags is defined %}
+  {# FIXME: For some reason the `meta` dict is always empty. Extract the desc from the `metatags` text.  #}
+  <meta property="og:description" content="{{ metatags[15:-24] }}">
+  {%- endif %}
+
+  <script>window.rp_prop_id = '29182759436';</script>
+  <script src="https://srv.realpython.net/tag.js" async></script>
+
+  <script src="https://d31vxm9ubutrmw.cloudfront.net/static/js/2169.js"></script>
+
+  {# Alabaster theme native GA integration is outdated (ga.js). #}
+  {# Insert our own GA snippet instead. #}
+  <script>
+    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+
+    ga('create', 'UA-37242602-11', 'auto');
+    ga('send', 'pageview');
+    </script>
+{% endblock %}
+
+{# From: https://github.com/bitprophet/alabaster/blob/5f249677242be96601e034edb3697b7482a6abcf/alabaster/layout.html #}
+{# Nav should appear before content, not after #}
+{%- block content %}
+{%- if theme_fixed_sidebar|lower == 'true' %}
+  <div class="document">
+    {{ sidebar() }}
+    {%- block document %}
+      <div class="documentwrapper">
+      {%- if render_sidebar %}
+        <div class="bodywrapper">
+      {%- endif %}
+
+          {%- block relbar_top %}
+            {%- if theme_show_relbar_top|tobool %}
+              <div class="related top">
+                &nbsp;
+                {{- rellink_markup () }}
+              </div>
+            {%- endif %}
+          {% endblock %}
+
+          <div class="body" role="main">
+            <div style="display:block;position:relative; margin-bottom: 1em;">
+              <div style="display:block;width:100%;padding-top:12.5%;"></div>
+              <div class="rpad" data-unit="8x1" style="position:absolute;left:0;top:0;right:0;bottom:0;overflow:hidden;"></div>
+            </div>
+            {% block body %} {% endblock %}
+          </div>
+
+          {%- block relbar_bottom %}
+            {%- if theme_show_relbar_bottom|tobool %}
+              <div class="related bottom">
+                &nbsp;
+                {{- rellink_markup () }}
+              </div>
+            {%- endif %}
+          {% endblock %}
+
+      {%- if render_sidebar %}
+        </div>
+      {%- endif %}
+      </div>
+    {%- endblock %}
+    <div class="clearer"></div>
+  </div>
+{%- else %}
+{{ super() }}
+{%- endif %}
+{%- endblock %}
+
+{%- block footer %}
+<div class="footer">
+  <div style="text-align: center;" id="waldo-tag-2171"></div>
+  {% if show_copyright %}<p>&copy;{{ copyright }}</p>{% endif %}
+</div>
+{% endblock %}
diff --git a/docs/_templates/sidebarintro.html b/docs/_templates/sidebarintro.html
index edd7b20..80c6443 100644
--- a/docs/_templates/sidebarintro.html
+++ b/docs/_templates/sidebarintro.html
@@ -1,81 +1,125 @@
 <p class="logo">
   <a href="{{ pathto(master_doc) }}">
-    <img class="logo" src="{{ pathto('_static/python-guide-logo.png', 1) }}" title="Python最佳实践指南"/>
+    <img
+      class="logo"
+      src="{{ pathto('_static/python-guide-logo.png', 1) }}"
+      title="Python最佳实践指南"
+    />
   </a>
 </p>
 
+{% include "github_star.html" %}
+
+<link
+  rel="stylesheet"
+  href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css"
+/>
+<style>
+  .algolia-autocomplete {
+    width: 100%;
+    height: 1.5em;
+  }
+  .algolia-autocomplete a {
+    border-bottom: none !important;
+  }
+  #doc_search {
+    width: 100%;
+    height: 100%;
+  }
+</style>
+<input id="doc_search" placeholder="搜索文档" autofocus />
+<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js" onload="docsearch({
+  apiKey: '512b0d6c0c8578bed7662f5279c2249c',
+  indexName: 'python-guide',
+  inputSelector: '#doc_search',
+  debug: false // Set debug to true if you want to inspect the dropdown
+})" async></script>
+
 <p>
   这份较为主观的指南旨在为Python初学者和专家提供一个关于Python安装、配置、和日常使用的最佳实践手册。
 </p>
 
-<h3>得到通知</h3>
-<p>获得新版本和未来项目的更新。</p>
-
-<p><iframe src="http://ghbtns.com/github-btn.html?user=prodesire&type=follow&count=false"
-  allowtransparency="true" frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
-
-<p><iframe src="http://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=false"
-  allowtransparency="true" frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
-
-<p><a href="https://twitter.com/kennethreitz" class="twitter-follow-button" data-show-count="false">Follow @kennethreitz</a> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script></p>
-
-<p><a href="http://tinyletter.com/kennethreitz">加入邮件列表</a>.</p>
-<p><a href="https://saythanks.io/to/kennethreitz">表示感谢</a></p>
-
-<a href="http://www.datacamp.com/?utm_source=python_guide&utm_campaign=display">
-<img src="{{ pathto('_static/ad.png', 1) }}" alt="">
-</a>
-
-<hr>
+<div style="display:block;position:relative;margin: 1em 0 1em 0;">
+  <div style="display:block;width:100%;padding-top:100%;"></div>
+  <div
+    class="rpad"
+    data-unit="1x1"
+    style="position:absolute;left:0;top:0;right:0;bottom:0;overflow:hidden;"
+  ></div>
+</div>
 
 <h3>O'Reilly 书籍</h3>
 
 <p>这份指南现在有纸质版啦！</p>
 
-<a href="https://www.amazon.com/Hitchhikers-Guide-Python-Practices-Development/dp/1491933178/ref=as_li_ss_il?ie=UTF8&linkCode=li2&tag=bookforkind-20&linkId=804806ebdacaf3b56567347f3afbdbca" target="_blank"><img border="0" src="https://ws-na.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=1491933178&Format=_SL160_&ID=AsinImage&MarketPlace=US&ServiceVersion=20070822&WS=1&tag=bookforkind-20" ></a><img src="//ir-na.amazon-adsystem.com/e/ir?t=bookforkind-20&l=li2&o=1&a=1491933178" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />
-
-<p>所有的收入都直接捐赠给 <a href="https://djangogirls.org">DjangoGirls</a> 组织。</p>
-
-
-
-<h3>其他项目</h3>
+<p>
+  <a href="/guide-book" target="_blank"
+    ><img
+      style="max-width: 100%; text-align: center;"
+      src="/_static/guide-book-cover.jpg"
+      alt="Python Guide Book Cover"
+  /></a>
+</p>
 
-<p>更多 <a href="http://kennethreitz.org/">Kenneth Reitz</a> 项目：</p>
-<ul>
-    <li><a href="http://wsl-guide.org/">wsl-guide.org</a></li>
-    <li><a href="http://edmsynths.com/">edmsynths.com</a></li>
-    <li><a href="http://pipenv.org/">pipenv</a></li>
-    <li><a href="http://pep8.org/">pep8.org</a></li>
-    <li><a href="http://python-requests.org">Requests: HTTP for Humans</a></li>
-    <li><a href="https://github.com/kennethreitz/maya">Maya: Datetimes for Humans</a></li>
-    <li><a href="https://github.com/kennethreitz/records">Records: SQL for Humans</a></li>
-    <li><a href="http://www.git-legit.org">Legit: Git for Humans</a></li>
-    <li><a href="http://docs.python-tablib.org/en/latest/">Tablib: Tabular Datasets</a></li>
-</ul>
+<p>
+  所有的收入都直接捐赠给
+  <a href="https://djangogirls.org">DjangoGirls</a> 组织。
+</p>
 
 <h3>贡献者</h3>
 <p>
   这份指南是世界各地
-  <a href="https://github.com/kennethreitz/python-guide/graphs/contributors">数百人</a>
+  <a href="https://github.com/kennethreitz/python-guide/graphs/contributors"
+    >数百人</a
+  >
   的成果, 也
-  <a href="http://docs.python-guide.org/en/latest/notes/contribute/">欢迎</a>您来贡献!
+  <a href="https://docs.python-guide.org/en/latest/notes/contribute/">欢迎</a
+  >您来贡献!
 </p>
 
-
 <h3>有用的链接</h3>
 <ul>
-  <li><a href="http://python-guide.org/">Python指南英文版</a></li>
-  <li><a href="https://github.com/Prodesire/Python-Guide-CN">Python指南中文版@GitHub</a></li>
-  <li><a href="http://github.com/kennethreitz/python-guide/issues">Issue追踪</a></li>
-  <li><a href="https://media.readthedocs.org/pdf/python-guide/latest/python-guide.pdf">Python指南PDF版</a></li>
+  <li><a href="https://docs.python-guide.org/">Python指南英文版</a></li>
+  <li>
+    <a href="https://github.com/Prodesire/Python-Guide-CN"
+      >Python指南中文版@GitHub</a
+    >
+  </li>
+  <li>
+    <a href="https://github.com/realpython/python-guide"
+      >Python指南英文版@ GitHub</a
+    >
+  </li>
+  <li>
+    <a href="https://github.com/realpython/python-guide/issues">Issue追踪</a>
+  </li>
+  <li>
+    <a
+      href="https://media.readthedocs.org/pdf/python-guide/latest/python-guide.pdf"
+      >Python指南PDF版</a
+    >
+  </li>
 </ul>
 
 <h3>翻译</h3>
 <ul>
-  <li><a href="http://docs.python-guide.org/en/latest/">English</a></li>
-  <li><a href="https://python-guide-fr.readthedocs.io/fr/latest/">French</a></li>
-  <li><a href="https://pythonguidecn.readthedocs.io/zh/latest/">Chinese</a></li>
-  <li><a href="http://python-guideja.readthedocs.io/ja/latest/">Japanese</a></li>
-  <li><a href="https://python-guide-kr.readthedocs.io/ko/latest/">Korean</a></li>
-  <li><a href="http://python-guide-pt-br.readthedocs.io/pt_BR/latest/">Brazilian Portuguese</a></li>
+  <li><a href="https://docs.python-guide.org/en/latest/">English</a></li>
+  <li>
+    <a href="https://python-guide-fr.readthedocs.io/fr/latest/">French</a>
+  </li>
+  <li><a href="https://prodesire.github.io/Python-Guide-CN/">Chinese</a></li>
+  <li>
+    <a href="https://python-guideja.readthedocs.io/ja/latest/">Japanese</a>
+  </li>
+  <li>
+    <a href="https://python-guide-kr.readthedocs.io/ko/latest/">Korean</a>
+  </li>
+  <li>
+    <a href="https://python-guide-fil.readthedocs.io/en/latest/">Filipino</a>
+  </li>
+  <li>
+    <a href="https://python-guide-pt-br.readthedocs.io/pt_BR/latest/"
+      >Brazilian Portuguese</a
+    >
+  </li>
 </ul>
diff --git a/docs/_templates/sidebarlogo.html b/docs/_templates/sidebarlogo.html
index 90fabac..c510420 100644
--- a/docs/_templates/sidebarlogo.html
+++ b/docs/_templates/sidebarlogo.html
@@ -4,60 +4,54 @@
   </a>
 </p>
 
+{% include "github_star.html" %}
+
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
+<style>
+.algolia-autocomplete{
+  width: 100%;
+  height: 1.5em
+}
+.algolia-autocomplete a{
+  border-bottom: none !important;
+}
+#doc_search{
+  width: 100%;
+  height: 100%;
+}
+</style>
+<input id="doc_search" placeholder="搜索文档" autofocus/>
+<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js" onload="docsearch({
+  apiKey: '512b0d6c0c8578bed7662f5279c2249c',
+  indexName: 'python-guide',
+  inputSelector: '#doc_search',
+  debug: false // Set debug to true if you want to inspect the dropdown
+})" async></script>
+
 <p>
-  本指南目前持续不断地更新与完善。这份较为主观的指南旨在为Python初学者和专家提供一个关于Python安装、配置、和日常使用的最佳实践手册。
+  这份较为主观的指南旨在为Python初学者和专家提供一个关于Python安装、配置、和日常使用的最佳实践手册。
 </p>
 
-<h3>获取更新</h3>
-<p>获得新版本和未来项目的更新。</p>
-
-<p><iframe src="http://ghbtns.com/github-btn.html?user=prodesire&type=follow&count=false"
-  allowtransparency="true" frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
-  
-<p><iframe src="http://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=false"
-  allowtransparency="true" frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
-
-<p><a href="https://twitter.com/kennethreitz" class="twitter-follow-button" data-show-count="false">Follow @kennethreitz</a> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script></p>
-<p><a href="https://saythanks.io/to/kennethreitz">表示感谢</a></p>
-<p><a href="http://tinyletter.com/kennethreitz">加入邮件列表</a>.</p>
-
-<a href="http://www.datacamp.com/?utm_source=python_guide&utm_campaign=display">
-<img src="{{ pathto('_static/ad.png', 1) }}" alt="">
-</a>
-
-<hr>
+<div style="display:block;position:relative;margin: 1em 0 1em 0;">
+  <div style="display:block;width:100%;padding-top:100%;"></div>
+  <div class="rpad" data-unit="1x1" style="position:absolute;left:0;top:0;right:0;bottom:0;overflow:hidden;"></div>
+</div>
 
 <h3>O'Reilly 书籍</h3>
 
 <p>这份指南现在有纸质版啦！</p>
 
-<a href="https://www.amazon.com/Hitchhikers-Guide-Python-Practices-Development/dp/1491933178/ref=as_li_ss_il?ie=UTF8&linkCode=li2&tag=bookforkind-20&linkId=804806ebdacaf3b56567347f3afbdbca" target="_blank"><img border="0" src="https://ws-na.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=1491933178&Format=_SL160_&ID=AsinImage&MarketPlace=US&ServiceVersion=20070822&WS=1&tag=bookforkind-20" ></a><img src="//ir-na.amazon-adsystem.com/e/ir?t=bookforkind-20&l=li2&o=1&a=1491933178" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />
+<p><a href="/guide-book" target="_blank"><img style="max-width: 100%; text-align: center;" src="/_static/guide-book-cover.jpg" alt="Python Guide Book Cover"></a></p>
 
 <p>所有的收入都直接捐赠给 <a href="https://djangogirls.org">DjangoGirls</a> 组织。</p>
 
-
-
-<h3>其他项目</h3>
-
-<p>更多 <a href="http://kennethreitz.org/">Kenneth Reitz</a> 项目：</p>
-<ul>
-    <li><a href="http://wsl-guide.org/">wsl-guide.org</a></li>
-    <li><a href="http://edmsynths.com/">edmsynths.com</a></li>
-    <li><a href="http://pipenv.org/">pipenv</a></li>
-    <li><a href="http://pep8.org/">pep8.org</a></li>
-    <li><a href="http://python-requests.org">Requests: HTTP for Humans</a></li>
-    <li><a href="https://github.com/kennethreitz/maya">Maya: Datetimes for Humans</a></li>
-    <li><a href="https://github.com/kennethreitz/records">Records: SQL for Humans</a></li>
-    <li><a href="http://www.git-legit.org">Legit: Git for Humans</a></li>
-    <li><a href="http://docs.python-tablib.org/en/latest/">Tablib: Tabular Datasets</a></li>
-</ul>
-
 <h3>翻译</h3>
 <ul>
-  <li><a href="http://docs.python-guide.org/en/latest/">English</a></li>
+  <li><a href="https://docs.python-guide.org/en/latest/">English</a></li>
   <li><a href="https://python-guide-fr.readthedocs.io/fr/latest/">French</a></li>
-  <li><a href="https://pythonguidecn.readthedocs.io/zh/latest/">Chinese</a></li>
+  <li><a href="https://prodesire.github.io/Python-Guide-CN/">Chinese</a></li>
   <li><a href="http://python-guideja.readthedocs.io/ja/latest/">Japanese</a></li>
   <li><a href="https://python-guide-kr.readthedocs.io/ko/latest/">Korean</a></li>
+  <li><a href="http://python-guide-fil.readthedocs.io/en/latest/">Filipino</a></li>
   <li><a href="http://python-guide-pt-br.readthedocs.io/pt_BR/latest/">Brazilian Portuguese</a></li>
 </ul>
diff --git a/docs/conf.py b/docs/conf.py
index 4452d9f..e7f1e58 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -11,7 +11,9 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import sys, os
+import os
+import sys
+import datetime
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -46,7 +48,12 @@
 
 # General information about the project.
 project = u'pythonguide'
-copyright = u'2016. A <a href="http://kennethreitz.com/pages/open-projects.html">Kenneth Reitz</a> Project. <a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">CC BY-NC-SA 3.0</a>'
+current_year = datetime.datetime.now().year
+project = u'pythonguide'
+copyright = (u'2011-{} <a href="https://www.kennethreitz.org/projects">Kenneth Reitz</a>'
+             ' &amp; <a href="https://realpython.com">Real Python</a>'
+             ' &amp; <a href="http://github.com/Prodesire">Prodesire</a>.'
+             ' <a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">CC BY-NC-SA 3.0</a>').format(current_year)
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -197,8 +204,8 @@
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-  ('index', 'pythonguide.tex', u'Python Guide Documentation',
-   u'Kenneth Reitz', 'manual'),
+    ('index', 'pythonguide.tex', u'Python Guide Documentation',
+     u'Kenneth Reitz', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -241,7 +248,7 @@
 epub_title = u'pythonguide'
 epub_author = u'Kenneth Reitz'
 epub_publisher = u'Kenneth Reitz'
-epub_copyright = u'2016, Kenneth Reitz'
+epub_copyright = u'2011–{}, Kenneth Reitz & Real Python & Prodesire'.format(current_year)
 
 # The language of the text. It defaults to the language option
 # or en if the language is not set.
@@ -279,5 +286,5 @@
 todo_include_todos = True
 
 intersphinx_mapping = {
-    'python': ('http://docs.python.org/', None),
+    'python': ('https://docs.python.org/', None),
 }
diff --git a/docs/contents.rst.inc b/docs/contents.rst.inc
index 0eb173d..9b7a0f4 100644
--- a/docs/contents.rst.inc
+++ b/docs/contents.rst.inc
@@ -92,11 +92,12 @@ Python应用的场景指南
 部署优雅的Python代码
 --------------------------------
 
-这部分指南关注部署您的Python代码。
+这部分指南关注分享和部署您的Python代码。
 
 .. toctree::
    :maxdepth: 2
 
+   shipping/publishing
    shipping/packaging
    shipping/freezing
 
diff --git a/docs/dev/env.rst b/docs/dev/env.rst
index f499ba2..24373b6 100644
--- a/docs/dev/env.rst
+++ b/docs/dev/env.rst
@@ -1,7 +1,7 @@
 您的开发环境
 ============================
 
-.. image:: https://farm3.staticflickr.com/2930/33175624924_7febc46cc4_k_d.jpg
+.. image:: /_static/photos/33175624924_7febc46cc4_k_d.jpg
 
 
 文本编辑器
@@ -77,28 +77,28 @@ SuperTab_ 是一个小的Vim插件，通过使用 ``<Tab>`` 或任何其他定
 .. _indent: http://www.vim.org/scripts/script.php?script_id=974
 .. _syntax: http://www.vim.org/scripts/script.php?script_id=790
 .. _Pyflakes: http://pypi.python.org/pypi/pyflakes/
-.. _pycodestyle: https://pypi.python.org/pypi/pycodestyle/
-.. _syntastic: https://github.com/scrooloose/syntastic
-.. _Python-mode: https://github.com/klen/python-mode
+.. _pycodestyle: https://pypi.org/project/pycodestyle/
+.. _syntastic: https://github.com/vim-syntastic/syntastic
+.. _Python-mode: https://github.com/python-mode/python-mode
 .. _SuperTab: http://www.vim.org/scripts/script.php?script_id=1643
 .. _vim-flake8: https://github.com/nvie/vim-flake8
 
 Emacs
 -----
 
-Emacs是另一个强大的文本编辑器。它是完全可编程的（lisp），但要正确的工作要花些功夫。
+Emacs是另一个强大的文本编辑器。它是完全可编程的（Lisp），但要正确的工作要花些功夫。
 如果您已经是一名Emacs的用户了，在EmacsWiki上的 `Python Programming in Emacs`_ 
 将会是好的开始。
 
 1. Emacs 本身支持Python模式。
 
-.. _Python Programming in Emacs: http://emacswiki.org/emacs/PythonProgrammingInEmacs
+.. _Python Programming in Emacs: https://www.emacswiki.org/emacs/PythonProgrammingInEmacs
 
 TextMate
 --------
 
 `TextMate <http://macromates.com/>`_ 将苹果操作系统技术带入了文本编辑器的世界。
-通过桥接UNIX和GUI，TextMate将两者中最好的部分带给了脚本专家和新手用户。
+通过桥接Unix和GUI，TextMate将两者中最好的部分带给了脚本专家和新手用户。
 
 Sublime Text
 ------------
@@ -117,9 +117,17 @@ Atom
 所喜欢的编辑器的任何优秀特性，并构建于atom-shell上。
 
 Atom是web原生的（HTML、CSS、JS），专注于模块化的设计和简单的插件开发。它自带本地包管理
-和大量的包。Python开发所推荐的插件是 `Linter <https://github.com/AtomLinter/Linter>`_ 
+和大量的包。Python开发所推荐的插件是 `Linter <https://github.com/steelbrain/linter>`_ 
 和 `linter-flake8 <https://github.com/AtomLinter/linter-flake8>`_ 的组合。
 
+Python (on Visual Studio Code)
+------------------------------
+
+`Python for Visual Studio Code <https://marketplace.visualstudio.com/items?itemName=ms-python.python>`_ 是 `Visual Studio Code <https://code.visualstudio.com>`_ 的扩展。
+它是一个免费、轻量级的开源编辑器，支持 Mac、Windows 和 Linux。
+使用 Node.js 和 Python 等开源技术构建，具有 Intellisense（自动完成）、本地和远程调试、linting 等引人注目的功能。
+
+MIT 许可。
 
 IDEs
 ::::
@@ -130,13 +138,13 @@ PyCharm / IntelliJ IDEA
 `PyCharm <http://www.jetbrains.com/pycharm/>`_ 由JetBrains公司开发，此公司还以
 IntelliJ IDEA闻名。它们都共享着相同的基础代码，PyCharm中大多数特性能通过免费的 
 `Python 插件 <https://plugins.jetbrains.com/plugin/?idea&pluginId=631>`_ 
-带入到IntelliJ中。PyCharm由两个版本：专业版（Professional Edition）（30天试用）和
+带入到IntelliJ中。PyCharm有两个版本：专业版（Professional Edition）（30天试用）和
 拥有相对少特性的社区版（Community Edition）（Apache 2.0 License）。
 
-Python （在 Visual Studio Code中）
+Python （在 Visual Studio Code 中）
 -----------------------------------------
 
-`用于Visual Studio的Python <https://marketplace.visualstudio.com/items?itemName=donjayamanne.python>`_ 
+`用于Visual Studio的Python <https://marketplace.visualstudio.com/items?itemName=ms-python.python>`_ 
 是一款用于 `Visual Studio Code IDE <https://code.visualstudio.com>`_ 的扩展。
 它是一个免费的、轻量的、开源的IDE，支持Mac、Windows和Linux。它以诸如Node.js和Python等
 开源技术构建，具有如Intellisense（自动补全）、本地和远程调试、linting（代码检查）等
@@ -146,19 +154,19 @@ MIT 许可证。
 
 Enthought Canopy
 ----------------
-`Enthought Canopy <https://www.enthought.com/products/canopy/>`_ 是一款专门面向科学家
+`Enthought Canopy <https://www.enthought.com/product/canopy/>`_ 是一款专门面向科学家
 和工程师的Python IDE，它预装了为数据分析而用的库。
 
 Eclipse
 -------
 
-Eclipse中进行Python开发最流行的插件是Aptana的 `PyDev <http://pydev.org>`_ 。
+Eclipse中进行Python开发最流行的插件是Aptana的 `PyDev <https://pydev.org>`_ 。
 
 
 Komodo IDE
 ----------
 
-`Komodo IDE <http://www.activestate.com/komodo-ide>`_ 由ActiveState开发，并且是
+`Komodo IDE <https://www.activestate.com/komodo-ide>`_ 由ActiveState开发，并且是
 在Windows、Mac和Linux平台上的商业IDE。
 
 
@@ -166,8 +174,8 @@ Spyder
 ------
 
 `Spyder <https://github.com/spyder-ide/spyder>`_ 是一款专门面向和Python科学库
-（即 `Scipy <http://www.scipy.org/>`_ ）打交道的IDE。它集成了 pyflakes_ 、 
-`pylint <http://www.logilab.org/857>`_ 和 `rope <https://github.com/python-rope/rope>`_ 。
+（即 `SciPy <https://www.scipy.org/>`_ ）打交道的IDE。它集成了 pyflakes_ 、 
+`pylint <https://www.logilab.org/857>`_ 和 `rope <https://github.com/python-rope/rope>`_ 。
 
 Spyder是开源的（免费的），提供了代码补全、语法高亮、类和函数浏览器，以及对象检查的功能。
 
@@ -200,6 +208,16 @@ Eric (The Eric Python IDE)
 Python Shell、集成的调试器和灵活的插件系统等功能。它基于Qt GUI工具集，使用Python编写，
 集成了Scintilla编辑器控制。Eric是一款超过10年活跃开发的开源软件工程（GPLv3许可）。
 
+Mu
+--
+
+`Mu <https://codewith.mu/>`_ 是一个极简的 Python IDE，它可以在本地运行 Python 3 代码，也可以将代码部署到 BBC micro:bit
+和运行 CircuitPython 的 Adafruit 板上。
+
+Mu 为初学者设计，包含一个 Python 3 解释器，易于安装在 Windows、OS/X 和 Linux 上，还能在 Raspberry Pi 上很好地运行。
+
+gitter 上有一个 Mu 活跃的支持社区。
+
 
 解释器工具
 :::::::::::::::::
@@ -212,18 +230,18 @@ Python Shell、集成的调试器和灵活的插件系统等功能。它基于Qt
 因此就能避免潜在的版本冲突。
 
 To start using and see more information:
-`Virtual Environments <http://github.com/kennethreitz/python-guide/blob/master/docs/dev/virtualenvs.rst>`_ docs.
+`Virtual Environments <https://github.com/kennethreitz/python-guide/blob/master/docs/dev/virtualenvs.rst>`_ docs.
 开始使用和查阅更多信息：请参阅 `Virtual Environments <http://github.com/kennethreitz/python-guide/blob/master/docs/dev/virtualenvs.rst>`_ 文档。
 
 
 pyenv
 -----
 
-`pyenv <https://github.com/yyuu/pyenv>`_ 是一个允许多个Python解释器版本同时安装
+`pyenv <https://github.com/pyenv/pyenv>`_ 是一个允许多个Python解释器版本同时安装
 于一台机器的工具。这解决了不同的项目需要不同版本的Python的问题。比如，为了兼容性，
 可以很容易地为一个项目安装Python 2.7，而继续使用Python 3.4作为默认的编辑器。
-pyenv不止限于CPython版本——它还能安装PyPy、anaconda、miniconda、stackless、jython
-和ironpython解释器。
+pyenv不止限于CPython版本——它还能安装PyPy、Anaconda、miniconda、stackless、Jython
+和IronPython解释器。
 
 pyenv的工作原理是在一个叫做 ``shims`` 目录中创建Python解释器（以及其他工具像
 ``pip`` 和 ``2to3`` 等）的假版本。当系统寻找名为 ``python`` 的应用时，
@@ -231,7 +249,7 @@ pyenv的工作原理是在一个叫做 ``shims`` 目录中创建Python解释器
 pyenv基于环境变量、 ``.python-version`` 文件和全局默认设置的信息就知道该运行
 哪个版本的Python。
 
-pyenv不是管理虚拟环境的工具，但是有一个叫做 `pyenv-virtualenv <https://github.com/yyuu/pyenv-virtualenv>`_ 
+pyenv不是管理虚拟环境的工具，但是有一个叫做 `pyenv-virtualenv <https://github.com/pyenv/pyenv-virtualenv>`_ 
 的插件可以自动化不同环境的创建，而且也能够使用现有的pyenv工具，基于环境变量或者 
 ``.python-version`` 文件，来切换不同的环境。
 
@@ -241,7 +259,7 @@ pyenv不是管理虚拟环境的工具，但是有一个叫做 `pyenv-virtualenv
 IDLE
 ----
 
-:ref:`IDLE <python:idle>` 是一个集成的开发环境，它是Python标准库的一部分。
+:ref:`IDLE <python:idle>` 是一个集成的开发环境，它是Python标准发行的一部分。
 它完全由Python编写，并使用Tkinter GUI工具集。尽管IDLE不适用于作为成熟的Python开发工具，
 但它对尝试小的Python代码和对Python不同特性的实验非常有帮助。
 
@@ -258,11 +276,11 @@ IPython
 `IPython <http://ipython.org/>`_ 提供一个丰富的工具集来帮助您最大限度地和Python交互。
 它主要的组件有：
 
-* 强大的Python shell（终端和基于Qt）。
-* 一个基于网络的笔记本，拥有相同的核心特性，但是支持富媒体、文本、代码、数学表达式和内联绘图。
-* 支持交互式的数据可视化和GUI工具集的使用。
-* 灵活、嵌入的解释器载入到您的工程工程中。
-* 支持高级可交互的并行计算的工具。
+* 强大的Python shell（终端和基于Qt）
+* 一个基于网络的笔记本，拥有相同的核心特性，但是支持富媒体、文本、代码、数学表达式和内联绘图
+* 支持交互式的数据可视化和GUI工具集的使用
+* 灵活、嵌入的解释器载入到您的工程工程中
+* 支持高级可交互的并行计算的工具
 
 .. code-block:: console
 
@@ -277,17 +295,17 @@ IPython
 BPython
 -------
 
-`bpython <http://bpython-interpreter.org/>`_ 在类Unix操作系统中可替代Python解释器的接口。
+`bpython <https://bpython-interpreter.org/>`_ 在类Unix操作系统中可替代Python解释器的接口。
 它有以下特性：
 
-* 内联的语法高亮。
-* 行内输入时的自动补全建议。
-* 任何Python函数的期望参数列表。
-* 从内存中pop出代码的最后一行并重新运行（re-evaluate）的“倒带”功能.
-* 将输入的代码发送到pastebin。
-* 将输入的代码保存到一个文件中。
-* 自动缩进。
-* 支持Python 3。
+* 内联的语法高亮
+* 行内输入时的自动补全建议
+* 任何Python函数的期望参数列表
+* 从内存中pop出代码的最后一行并重新运行（re-evaluate）的“倒带”功能
+* 将输入的代码发送到pastebin
+* 将输入的代码保存到一个文件中
+* 自动缩进
+* 支持Python 3
 
 .. code-block:: console
 
@@ -296,16 +314,16 @@ BPython
 ptpython
 --------
 
-`ptpython <https://github.com/jonathanslenders/ptpython/>`_ 是一个构建在 
-`prompt_toolkit <http://github.com/jonathanslenders/python-prompt-toolkit>`_ 
+`ptpython <https://github.com/prompt-toolkit/ptpython/>`_ 是一个构建在 
+`prompt_toolkit <https://github.com/prompt-toolkit/python-prompt-toolkit>`_ 
 库顶部的REPL。它被视作是 BPython_ 的替代。特性包括：
 
 * 语法高亮
 * 自动补全
 * 多行编辑
-* Emacs和VIM模式
+* Emacs和Vim模式
 * 代码中嵌入的REPL
-* 语法合法性
+* 语法校验
 * Tab页
 * 通过安装Ipython ``pip install ipython`` 并运行 ``ptipython`` ，支持集成 IPython_ 的 shell
 
diff --git a/docs/dev/pip-virtualenv.rst b/docs/dev/pip-virtualenv.rst
index 9499f5a..69aee49 100644
--- a/docs/dev/pip-virtualenv.rst
+++ b/docs/dev/pip-virtualenv.rst
@@ -41,7 +41,7 @@ Pip和Virtualenv的更多配置
 
 .. code-block:: console
 
-    %HOME%\pip\pip.ini
+    %USERPROFILE%\pip\pip.ini
 
 如果在这些位置中并没有 :file:`pip.conf` 或 :file:`pip.ini` ，
 您可以在对应的操作系统中创建一个正确名字的新文件。
@@ -67,7 +67,7 @@ Pip和Virtualenv的更多配置
 .. code-block:: console
 
     gpip() {
-        PIP_REQUIRE_VIRTUALENV="" pip "$@"
+        PIP_REQUIRE_VIRTUALENV=false pip "$@"
     }
 
 在保存完这个修改以及使用 ``source ~/.bashrc`` 来source一下 :file:`~/.bashrc` 
@@ -82,9 +82,12 @@ Pip和Virtualenv的更多配置
 比如说，您可能在多个不同的项目上使用了 ``requests`` 。
 
 每当您开始一个新项目（并有一个新的虚拟环境）重新下载相同的包/库是没有必要的。幸运的是，
-您能通过下面的方式去配置pip来重用已经安装的库。
+自从6.0版本开始，pip提供 `默认缓存机制
+<https://pip.pypa.io/en/stable/reference/pip_install/#caching>`_ 而无需任何配置。
 
-在UNIX系统中，您可以添加以下两行到您的 :file:`.bashrc` 或 :file:`.bash_profile` 文件中。
+当使用更老的版本时，你可以用下面的方式来配置pip，以使它尝试重用已安装的包。
+
+在Unix系统中，您可以添加以下两行到您的 :file:`.bashrc` 或 :file:`.bash_profile` 文件中。
 
 .. code-block:: console
 
@@ -99,9 +102,9 @@ Pip和Virtualenv的更多配置
 
 .. code-block:: console
 
-    download-cache = %HOME%\pip\cache
+    download-cache = %USERPROFILE%\pip\cache
 
-类似的，如果您使用UNIX，就将下面一行添加到 :file:`pip.conf` 文件中的 ``[global]`` 设置下：
+类似的，如果您使用Unix，就将下面一行添加到 :file:`pip.conf` 文件中的 ``[global]`` 设置下：
 
 .. code-block:: console
 
diff --git a/docs/dev/virtualenvs.rst b/docs/dev/virtualenvs.rst
index 5be9c26..5581b60 100644
--- a/docs/dev/virtualenvs.rst
+++ b/docs/dev/virtualenvs.rst
@@ -21,7 +21,7 @@ Python 用于许多不同的目的。准确地说，您希望如何管理依赖
 在您进一步之前，请确保您有 Python，并且可从您的命令行中获得。
 您可以通过简单地运行以下命令来检查：
 
-.. code-block:: bash
+.. code-block:: console
 
     $ python --version
 
@@ -37,12 +37,12 @@ Python 用于许多不同的目的。准确地说，您希望如何管理依赖
           File "<stdin>", line 1, in <module>
         NameError: name 'python' is not defined
 
-    这是因为此命令要在 *shell*（也称为 *终端* 或 *控制台*）中运行。有关使用操作系统的
+    这是因为此命令要在 *shell* （也称为 *终端* 或 *控制台*）中运行。有关使用操作系统的
     shell 并和 Python 进行交互的介绍，请参阅面向 Python 新手的 `入门教程`_。
 
-另外，您需要确保 ``pip`` 是可用的。您可以通过运行以下命令来检查：
+另外，您需要确保 `pip`_ 是可用的。您可以通过运行以下命令来检查：
 
-.. code-block:: bash
+.. code-block:: console
 
     $ pip --version
 
@@ -52,20 +52,21 @@ Python 用于许多不同的目的。准确地说，您希望如何管理依赖
 
 .. _入门教程: https://opentechschool.github.io/python-beginners/en/getting_started.html#what-is-python-exactly
 .. _python.org: https://python.org
+.. _pip: https://pypi.org/project/pip/
 .. _Homebrew: https://brew.sh
-.. _安装 Python: http://docs.python-guide.org/en/latest/starting/installation/
+.. _安装 Python: https://docs.python-guide.org/starting/installation/
 
 
 安装 Pipenv
 -----------------
 
-``Pipenv`` 是 Python 项目的依赖管理器。如果您熟悉 Node.js 的 `npm`_ 或
-Ruby 的 `bundler`_，那么它们在思路上与这些工具类似。尽管 ``pip`` 可以安装 Python 包，
+`Pipenv`_ 是 Python 项目的依赖管理器。如果您熟悉 Node.js 的 `npm`_ 或
+Ruby 的 `bundler`_，那么它们在思路上与这些工具类似。尽管 `pip`_ 可以安装 Python 包，
 但仍推荐使用 Pipenv，因为它是一种更高级的工具，可简化依赖关系管理的常见使用情况。
 
 使用 ``pip`` 来安装 Pipenv：
 
-.. code-block:: shell
+.. code-block:: console
 
     $ pip install --user pipenv
 
@@ -75,7 +76,7 @@ Ruby 的 `bundler`_，那么它们在思路上与这些工具类似。尽管 ``p
     
     在 Linux 和 macOS 上，您可以通过运行 ``python -m site --user-base`` 找到
     用户基础目录，然后把 ``bin`` 加到目录末尾。比如，上述命令典型地会打印出
-    ``~/.local``（ ``~`` 会扩展为您的家目录的局对路径），然后将 ``~/.local/bin``
+    ``~/.local`` （ ``~`` 会扩展为您的家目录的绝对路径），然后将 ``~/.local/bin``
     添加到 ``PATH`` 中。您可以通过 `修改 ~/.profile`_ 永久地设置 ``PATH``。
 
     在 Windows 上，您通过运行 ``py -m site --user-site`` 找到用户基础目录，然后
@@ -84,6 +85,7 @@ Ruby 的 `bundler`_，那么它们在思路上与这些工具类似。尽管 ``p
     ``PATH`` 中包含 ``C:\Users\Username\AppData\Roaming\Python36\Scripts``。
     您可以在 `控制面板`_ 中永久设置用户的 ``PATH``。您可能需要登出 ``PATH`` 更改才能生效。
 
+.. _Pipenv: https://pipenv.kennethreitz.org/
 .. _npm: https://www.npmjs.com/
 .. _bundler: http://bundler.io/
 .. _用户基础目录: https://docs.python.org/3/library/site.html#site.USER_BASE
@@ -97,15 +99,17 @@ Ruby 的 `bundler`_，那么它们在思路上与这些工具类似。尽管 ``p
 Pipenv 管理每个项目的依赖关系。要安装软件包时，请更改到您的项目目录（或只是本教程中的
 一个空目录）并运行：
 
-.. code-block:: bash
+.. code-block:: console
 
-    $ cd myproject
+    $ cd project_folder
     $ pipenv install requests
 
-Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建一个 ``Pipfile``。
+Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建一个 `Pipfile`_。
 ``Pipfile`` 用于跟踪您的项目中需要重新安装的依赖，例如在与他人共享项目时。
 您应该得到类似的输出（尽管显示的确切路径会有所不同）：
 
+.. _Pipfile: https://github.com/pypa/pipfile
+
 .. code-block:: text
 
     Creating a Pipfile for this project...
@@ -133,7 +137,7 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
     Adding requests to Pipfile's [packages]...
     P.S. You have excellent taste! ✨ 🍰 ✨
 
-.. _Requests: https://python-requests.org
+.. _Requests: https://requests.readthedocs.io/en/latest/
 
 
 使用安装好的包
@@ -151,7 +155,7 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
 
 然后您就可以使用 ``pipenv run`` 运行这段脚本：
 
-.. code-block:: bash
+.. code-block:: console
 
     $ pipenv run python main.py
 
@@ -175,7 +179,7 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
 更低层次: virtualenv
 =======================
 
-`virtualenv <http://pypi.python.org/pypi/virtualenv>`_ 是一个创建隔绝的Python环境的
+`virtualenv <http://pypi.org/project/virtualenv>`_ 是一个创建隔绝的Python环境的
 工具。virtualenv创建一个包含所有必要的可执行文件的文件夹，用来使用Python工程所需的包。
 
 它可以独立使用，代替Pipenv。
@@ -186,7 +190,7 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
 
   $ pip install virtualenv
 
-测试您的安装
+测试您的安装：
 
 .. code-block:: console
 
@@ -199,23 +203,23 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
 
 .. code-block:: console
 
-   $ cd my_project_folder
-   $ virtualenv my_project
+   $ cd project_folder
+   $ virtualenv venv
 
-``virtualenv my_project`` 将会在当前的目录中创建一个文件夹，包含了Python可执行文件，
-以及 ``pip`` 库的一份拷贝，这样就能安装其他包了。虚拟环境的名字（此例中是 ``my_project`` ）
+``virtualenv venv`` 将会在当前的目录中创建一个文件夹，包含了Python可执行文件，
+以及 ``pip`` 库的一份拷贝，这样就能安装其他包了。虚拟环境的名字（此例中是 ``venv`` ）
 可以是任意的；若省略名字将会把文件均放在当前目录。
 
-在任何您运行命令的目录中，这会创建Python的拷贝，并将之放在叫做 :file:`my_project` 
+在任何您运行命令的目录中，这会创建Python的拷贝，并将之放在叫做 :file:`venv` 
 的文件中。
 
-您可以选择使用一个Python解释器（比如``python2.7``）：
+您可以选择使用一个Python解释器（比如 ``python2.7`` ）：
 
 .. code-block:: console
 
-   $ virtualenv -p /usr/bin/python2.7 my_project
+   $ virtualenv -p /usr/bin/python2.7 venv
 
-或者使用``~/.bashrc``的一个环境变量将解释器改为全局性的：
+或者使用 ``~/.bashrc`` 的一个环境变量将解释器改为全局性的：
 
 .. code-block:: console
 
@@ -226,18 +230,27 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
 
 .. code-block:: console
 
-   $ source my_project/bin/activate
+   $ source venv/bin/activate
 
-当前虚拟环境的名字会显示在提示符左侧（比如说 ``(my_project)您的电脑:您的工程 用户名$）
-以让您知道它是激活的。从现在起，任何您使用pip安装的包将会放在 ``my_project`` 文件夹中，
+当前虚拟环境的名字会显示在提示符左侧（比如说 ``(venv)您的电脑:项目目录 用户名$``）
+以让您知道它是激活的。从现在起，任何您使用pip安装的包将会放在 ``venv`` 文件夹中，
 与全局安装的Python隔绝开。
 
-像平常一样安装包，比如：
+对于Windows，可以使用步骤1中提到的相同命令来创建虚拟环境。 只是需要稍微不同的命令来激活环境。
+
+假设您在项目目录中：
+
+.. code-block:: console
+
+   C:\Users\SomeUser\project_folder> venv\Scripts\activate
+
+使用 ``pip`` 命令来安装包：
 
 .. code-block:: console
 
     $ pip install requests
 
+
 3. 如果您在虚拟环境中暂时完成了工作，则可以停用它：
 
 .. code-block:: console
@@ -246,11 +259,11 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
 
 这将会回到系统默认的Python解释器，包括已安装的库也会回到默认的。
 
-要删除一个虚拟环境，只需删除它的文件夹。（要这么做请执行  ``rm -rf my_project`` ）
+要删除一个虚拟环境，只需删除它的文件夹。（要这么做请执行  ``rm -rf venv`` ）
 
 然后一段时间后，您可能会有很多个虚拟环境散落在系统各处，您将有可能忘记它们的名字或者位置。
 
-其他注意
+其他注意事项
 --------------
 
 运行带 ``--no-site-packages`` 选项的 ``virtualenv`` 将不会包括全局安装的包。
@@ -263,7 +276,7 @@ Pipenv 将在您的项目目录中安装超赞的 `Requests`_ 库并为您创建
     $ pip freeze > requirements.txt
 
 这将会创建一个 :file:`requirements.txt` 文件，其中包含了当前环境中所有包及
-各自的版本的简单列表。您可以使用 “pip list”在不产生requirements文件的情况下，
+各自的版本的简单列表。您可以使用 ``pip list`` 在不产生requirements文件的情况下，
 查看已安装包的列表。这将会使另一个不同的开发者（或者是您，如果您需要重新创建这样的环境）
 在以后安装相同版本的相同包变得容易。
 
@@ -302,7 +315,7 @@ virtualenvwrapper
 
   $ pip install virtualenvwrapper-win
 
-在Windows中，WORKON_HOME默认的路径是 %USERPROFILE%\Envs 。
+在Windows中，WORKON_HOME默认的路径是 %USERPROFILE%\\Envs 。
 
 基本使用
 --------------
@@ -311,18 +324,18 @@ virtualenvwrapper
 
 .. code-block:: console
 
-   $ mkvirtualenv my_project
+   $ mkvirtualenv project_folder
 
-这会在 :file:`~/Envs` 中创建 :file:`my_project` 文件夹。
+这会在 :file:`~/Envs` 中创建 :file:`project_folder` 文件夹。
 
 2. 在虚拟环境上工作：
 
 .. code-block:: console
 
-   $ workon my_project
+   $ workon project_folder
 
 或者，您可以创建一个项目，它会创建虚拟环境，并在 ``$WORKON_HOME`` 中创建一个项目目录。
-当您使用 ``workon myproject`` 时，会 ``cd`` -ed 到项目目录中。
+当您使用 ``workon project_folder`` 时，会 ``cd`` 到项目目录中。
 
 .. code-block:: console
 
@@ -343,7 +356,7 @@ virtualenvwrapper
 
 .. code-block:: console
 
-   $ rmvirtualenv my_project
+   $ rmvirtualenv project_folder
 
 其他有用的命令
 -------------------
@@ -368,20 +381,15 @@ virtualenv-burrito
 有了 `virtualenv-burrito <https://github.com/brainsik/virtualenv-burrito>`_ ，
 您就能使用单行命令拥有virtualenv + virtualenvwrapper的环境。
 
-autoenv
+direnv
 -------
-当您 ``cd`` 进入一个包含 :file:`.env` 的目录中，就会 `autoenv <https://github.com/kennethreitz/autoenv>`_ 
+当您 ``cd`` 进入一个包含 :file:`.env` 的目录中，就会 `direnv <https://direnv.net>`_ 
 自动激活那个环境。
 
 使用 ``brew`` 在Mac OS X上安装它：
 
 .. code-block:: console
 
-   $ brew install autoenv
-
-在Linux上:
-
-.. code-block:: console
+   $ brew install direnv
 
-   $ git clone git://github.com/kennethreitz/autoenv.git ~/.autoenv
-   $ echo 'source ~/.autoenv/activate.sh' >> ~/.bashrc
+在 Linux 上，根据 `direnv.net <https://direnv.net>`_ 上的指南进行。
diff --git a/docs/index.rst b/docs/index.rst
index f0543d7..f843e4f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -3,8 +3,12 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
+.. meta::
+   :description: Python编程语言的自我主见指南，也是安装、配置和日常使用Python的最佳实践手册。
+
+#################################
 Python最佳实践指南！
-=================================
+#################################
 
 您好，地球人！欢迎来到Python最佳实践指南。
 
diff --git a/docs/intro/community.rst b/docs/intro/community.rst
index aead83c..3b677ff 100644
--- a/docs/intro/community.rst
+++ b/docs/intro/community.rst
@@ -1,27 +1,30 @@
 .. _the-community:
 
+#############
 社区
-=============
+#############
 
 .. image:: https://farm5.staticflickr.com/4225/34689432801_78d97ecec9_k_d.jpg
 
+****
 BDFL
-----
+****
 
 Python的创始人Guido van Rossum 通常被称为BDFL —— 生活的仁慈独裁者。
 
 
-
+##########################
 Python软件基金会
---------------------------
+##########################
 
 Python软件基金会的任务是促进、保护和发展Python编程语言，同时支持和帮助Python编程者的多样、国际化的社区的成长。
 
 `了解更多关于PSF的内容 <http://www.python.org/psf/>`_.
 
 
+****
 PEPs
-----
+****
 
 PEPs是 *Python 增强提议*。它们描述了Python自身或者相关库的变化。
 
@@ -63,15 +66,24 @@ PEPs会被同行审阅，并在大量的讨论后决定接受或拒绝。任何
 .. image:: ../_static/pep-0001-1.png
 
 
+**************************
 Python会议
---------------------------
+**************************
 
 Python社区主要的事件就是开发者会议。两个最著名的会议就是在美国举办的PyCon，和在欧洲举办的姊妹版会议EuroPython。
 
 会议的综合列表维护在 `pycon.org <http://www.pycon.org/>`_ 上。
 
 
+**************************
 Python用户组
---------------------------
+**************************
+
+用户组就是一群Python开发者见面现身或讨论感兴趣的Python话题的地方。一系列本地用户组维护在 `Python 软件基金会 Wiki <http://wiki.python.org/moin/LocalUserGroups>`_ 中。
+
+**************************
+Python 工作公告栏
+**************************
 
-用户组就是一群Python开发者见面现身或讨论感兴趣的Python话题的地方。一系列本地用户组维护在 `Python 软件基金会 Wiki <http://wiki.python.org/moin/LocalUserGroups>`_ 中。
\ No newline at end of file
+`Python Jobs HQ <https://www.pythonjobshq.com>`_ 是一个面向Python开发人员的Python工作公告栏。
+该网站汇总了发布自网络的Python职位，并允许雇主直接在网站上发布Python职位。
\ No newline at end of file
diff --git a/docs/intro/documentation.rst b/docs/intro/documentation.rst
index e6320a7..ce20534 100644
--- a/docs/intro/documentation.rst
+++ b/docs/intro/documentation.rst
@@ -1,10 +1,14 @@
+
+
+#############
 文档
-=============
+#############
 
 .. image:: https://farm5.staticflickr.com/4178/33928823133_2f3d32cf32_k_d.jpg
 
+**********************
 官方文档
-----------------------
+**********************
 
 Python语言和库的官方文档能够在这里找到：
 
@@ -12,16 +16,18 @@ Python语言和库的官方文档能够在这里找到：
     - `Python 3.x <https://docs.python.org/3/>`_
 
 
+**********************
 Read the Docs
--------------
+**********************
 
 Read the Docs是一个流行的社区项目，存放着开源软件的文档。它拥有很多Python模块，优秀且流行。
 
     `Read the Docs <https://readthedocs.org/>`_
 
 
+*****
 pydoc
------
+*****
 
 :program:`pydoc` 是一个在您安装Python时跟着安装的工具。它允许您在shell中快速检索和查找文档。比如，如果您需要对 :mod:`time` 模块的进行快速回顾，查看文档就是像下面这么简单：
 
diff --git a/docs/intro/duction.rst b/docs/intro/duction.rst
index 1169b10..75cd975 100644
--- a/docs/intro/duction.rst
+++ b/docs/intro/duction.rst
@@ -1,9 +1,12 @@
+
+
+############
 介绍
-============
+############
 
 .. image:: https://farm5.staticflickr.com/4180/34725946825_0f85497e60_k_d.jpg
 
-来自 `Python官方网站 <http://python.org/about/>`_ 的介绍：
+来自 `Python官方网站 <https://python.org/about/>`_ 的介绍：
 
 Python是一门通用的高级编程语言，类似于Tcl、Perl、Ruby、Scheme或者Java。其一些主要的关键特性包括：
 
@@ -15,7 +18,7 @@ Python是一门通用的高级编程语言，类似于Tcl、Perl、Ruby、Scheme
 
   Python有时被描述为“自带电池（batteries included）”（引申为“功能完备”），就是因为它拥有大量的 `标准库 <http://docs.python.org/library/>`_ ，这包括正则表达式、文件IO、分数处理、对象序列化等。
 
-  此外，`Python Package Index <http://pypi.python.org/pypi/>`_ 允许用户提交他们的包以得到更广泛的使用，类似于Perl的 `CPAN <http://www.cpan.org>`_ 。Python拥有生机蓬勃的社区，他们开发出非常强大的Python框架和工具，比如 `Django <http://www.djangoproject.com>`_ 网络框架和 `NumPy <http://numpy.scipy.org>`_ 数学库。
+  此外，`Python Package Index <https://pypi.org>`_ 允许用户提交他们的包以得到更广泛的使用，类似于Perl的 `CPAN <https://www.cpan.org>`_ 。Python拥有生机蓬勃的社区，他们开发出非常强大的Python框架和工具，比如 `Django <https://www.djangoproject.com>`_ 网络框架和 `NumPy <http://numpy.scipy.org>`_ 数学库。
 
 * **和其他系统集成**
 
@@ -33,8 +36,9 @@ Python是一门通用的高级编程语言，类似于Tcl、Perl、Ruby、Scheme
 
 .. _about-ref:
 
+################
 关于这份指南
-----------------
+################
 
 目的
 ~~~~~~~
diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst
index 62096ba..02c2655 100644
--- a/docs/intro/learning.rst
+++ b/docs/intro/learning.rst
@@ -1,10 +1,12 @@
+###############
 学习Python
-===============
+###############
 
-.. image:: https://farm3.staticflickr.com/2840/32800783863_11a00db52c_k_d.jpg
+.. image:: /_static/photos/32800783863_11a00db52c_k_d.jpg
 
+********
 初学者
---------
+********
 
 The Python Tutorial
 ~~~~~~~~~~~~~~~~~~~~
@@ -13,6 +15,20 @@ The Python Tutorial
 
     `The Python Tutorial <http://docs.python.org/tutorial/index.html>`_
 
+Real Python
+~~~~~~~~~~~
+
+Real Python 是由各种专业的Python开发团队创建的免费且深入的Python教程库。在Real Python中，您可以从头开始学习Python的所有内容。从Python的最基础的知识到Web开发和Web爬取，再到数据可视化等等。
+
+    `Real Python <https://realpython.com/>`_
+
+Python Basics
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+pythonbasics.org 是初学者的入门教程，包括练习、涵盖了基础知识，还有深入的课程（如面向对象编程和正则表达式）。
+
+   `Python basics <https://pythonbasics.org/>`_
+
 Python for beginners
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -20,32 +36,30 @@ thepythonguru.com是一个专注于初学程序员的教程。它深入涵盖了
 它还教您一些Python的高级概念，如lambda表达式、正则表达式等。最后，它以教程
 “如何使用python访问MySQL数据库”结束。
 
-   `Python for beginners <http://thepythonguru.com/>`_
-
-交互学习Python数据科学
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-如果您喜欢在线互动环境学习数据科学Python， `DataCamp的免费python教程 <https://www.datacamp.com/courses/intro-to-python-for-data-science?tap_a=5644-dce66f&tap_s=116411-750171>`_ 
-是一个很好的入门方式。如果您已经在机器学习方面有所进步并且感兴趣，请查看这个 `使用scikit监督学习的课程 <https://www.datacamp.com/courses/supervised-learning-with-scikit-learn?tap_a=5644-dce66f&tap_s=116411-750171>`_，
-由scikit学习的核心开发人员之一提供。
-
-
-`Python for data science <http://datacamp.com/?tap_a=5644-dce66f&tap_s=116411-750171>`_
+   `Python for beginners <https://thepythonguru.com/>`_
 
-Learn Python
+Learn Python Interactive Tutorial
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Learnpython.org是一个简单易懂的了解Python的途径。网站采用了和流行的 
-`Try Ruby <http://tryruby.org/>`_ 相同的方式，有一个交互式的Python解释器内建于网站中，
+`Try Ruby <https://ruby.github.io/TryRuby>`_ 相同的方式，有一个交互式的Python解释器内建于网站中，
 允许您在学习Python课程时不需要在本地安装Python。
 
     `Learn Python <http://www.learnpython.org/>`_
 
+Python for You and Me
+~~~~~~~~~~~~~~~~~~~~~
 
 如果您想要更加传统的书籍， *Python For You and Me* 是一个极佳的学习Python所有方面的资源。
 
     `Python for You and Me <https://pymbook.readthedocs.io/>`
-    `Learn Python Interactively with DataCamp! <https://www.datacamp.com/>`_
+
+Learn Python Step by Step
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Techbeamers.com 提供了手把手的教程讲解Python。每个教程都补充了相关代码段，并配备了关于所学主题的后续测验。里面的 `Python 面试题 <https://www.techbeamers.com/python-interview-questions-programmers>`_ 部分可以帮助求职者。您还可以阅读必备的 `Python 技巧 <https://www.techbeamers.com/essential-python-tips-tricks-programmers>`_ ，并学习编写高质量代码的 `最佳编程实践 <https://www.techbeamers.com/python-code-optimization-tips-tricks>`_ 。在这里，你将获得快速学习Python的正确平台。
+
+`学习 Python 从基础到高级 <https://www.techbeamers.com/python-tutorial-step-by-step>`_
 
 Online Python Tutor
 ~~~~~~~~~~~~~~~~~~~
@@ -78,7 +92,7 @@ Learn Python the Hard Way
 
 这是一部极佳的新手编程者的Python指南。它涵盖了从控制台到web的“hello world”。
 
-    `Learn Python the Hard Way <http://learnpythonthehardway.org/book/>`_
+    `Learn Python the Hard Way <https://learnpythonthehardway.org/book/>`_
 
 
 Crash into Python
@@ -87,7 +101,7 @@ Crash into Python
 这个指南也叫 *Python for Programmers with 3 Hours* ，它给有其他语言开发经验的开发人员
 一个关于Python的快速教程。
 
-    `Crash into Python <http://stephensugden.com/crash_into_python/>`_
+    `Crash into Python <https://stephensugden.com/crash_into_python/>`_
 
 
 Dive Into Python 3
@@ -96,7 +110,7 @@ Dive Into Python 3
 Dive Into Python 3对准备使用Python 3的人来说是一本不错的书。如果您是从Python 2迁移到
 Python 3或者您已经有其他语言的编程经验，那么将会很好阅读。
 
-    `Dive Into Python 3 <http://www.diveintopython3.net/>`_
+    `Dive Into Python 3 <http://diveintopython3.problemsolving.io/>`_
 
 
 Think Python: How to Think Like a Computer Scientist
@@ -116,18 +130,17 @@ Think Python 通过使用Python语言来介绍计算机科学中的基本概念
 Python Koans
 ~~~~~~~~~~~~
 
-Python Koans是Edgecase's Ruby Koans的迁移版。它使用测试驱动的方法（参阅TEST DRIVEN 
-DESIGN SECTION）提供一个交互式的教程，来讲解基本的Python概念。通过修复在测试脚本中
-失败的断言，从而提供连续的步骤来学习Python。
+Python Koans是Edgecase's Ruby Koans的迁移版。它使用测试驱动的方法提供一个交互式的教程，
+来讲解基本的Python概念。通过修复在测试脚本中失败的断言，从而提供连续的步骤来学习Python。
 
 对于那些使用语言并找出自己的困惑的人来说，这会是个有趣并有吸引力的选择。对于新手来说，
 拥有一个额外的资源或者参考会是很有用的。
 
-    `Python Koans <http://bitbucket.org/gregmalcolm/python_koans>`_
+    `Python Koans <https://github.com/gregmalcolm/python_koans>`_
 
 要了解更多关于测试驱动开发的内容，可以查看以下资源：
 
-    `测试驱动开发 <http://en.wikipedia.org/wiki/Test-driven_development>`_
+    `测试驱动开发 <https://en.wikipedia.org/wiki/Test-driven_development>`_
 
 
 A Byte of Python
@@ -140,18 +153,38 @@ A Byte of Python
     `A Byte of Python for Python 3.x <https://python.swaroopch.com/>`_
 
 
-Learn to Program in Python with Codeacademy
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Computer Science Path on Codecademy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-此Codeacademy课程面向绝对的Python初学者。这门免费、互动的课程提供和教授Python编程的基础
+此Codecademy课程面向绝对的Python初学者。这门免费、互动的课程提供和教授Python编程的基础
 （和以后）的内容，同时测试用户之间知识的进展。
 本课程还内置了一个解释器，用于获取学习过程中的即时反馈。
 
-    `Learn to Program in Python with Codeacademy <http://www.codecademy.com/en/tracks/python>`_
+    `Computer Science Path on Codecademy <https://www.codecademy.com/learn/paths/computer-science>`_
 
 
+Code the blocks
+~~~~~~~~~~~~~~~
+
+*Code the blocks* 为初学者提供免费的交互式Python教程。它将Python编程与3D环境相结合，
+您可以在其中“放置方块”并构建结构。本教程将教您如何使用Python创建逐渐精细的3D结构，
+从而使得学习Python的过程变得有趣和吸引人。
+
+    `Code the blocks <https://codetheblocks.com/tutorials/introduction>`_
+
+
+************
 中级
-------------
+************
+
+Python Tricks: The Book
+~~~~~~~~~~~~~~~~~~~~~~~
+
+通过简单的示例发现Python的最佳实践，并开始编写更美观的且Pythonic的代码。"Python Tricks: The Book"向您展示了具体方法。
+
+您将通过实际示例和清晰的叙述掌握Python的中级和高级功能：
+
+    `Python Tricks: The Book <https://realpython.com/products/python-tricks-book/>`_
 
 Effective Python
 ~~~~~~~~~~~~~~~~
@@ -159,10 +192,11 @@ Effective Python
 本书包含59种具体方法来改进编写Pythonic代码。在这227页中，这是一个关于程序员需要做的一些
 最常见的程序以成为高效的中级Python程序员的非常简要的概述。
 
-    `Effective Python <http://www.effectivepython.com/>`_
+    `Effective Python <https://effectivepython.com/>`_
 
+********
 进阶者
---------
+********
 
 Pro Python
 ~~~~~~~~~~
@@ -170,7 +204,7 @@ Pro Python
 本书是面向从中级到高级，想明白Python是如何以及为何这样工作，如何将代码水平提高一级的
 Python程序员。
 
-    `Pro Python <http://propython.com>`_
+    `Pro Python <https://www.apress.com/gp/book/9781430227571>`_
 
 
 Expert Python Programming
@@ -184,7 +218,7 @@ Expert Python Programming讲解编写Python的最佳实践，并专注更高级
 zc.buildout的一个章节。后面的章节详细讲述了最佳实践，比如编写文档、测试驱动开发、
 版本控制、优化和分析。
 
-    `Expert Python Programming <http://www.packtpub.com/expert-python-programming/book>`_
+    `Expert Python Programming <https://www.packtpub.com/product/expert-python-programming-third-edition/9781789808896>`_
 
 
 A Guide to Python's Magic Methods
@@ -195,12 +229,13 @@ A Guide to Python's Magic Methods
 
     `A Guide to Python's Magic Methods <http://www.rafekettler.com/magicmethods.html>`_
 
-.. note:: Rafekettler.com目前已关闭，您可以直接访问他们的Github版本。 在这里您可以找到一个PDF版本:
+.. note:: Rafekettler.com目前已关闭，您可以直接访问他们的GitHub版本。 在这里您可以找到一个PDF版本:
     `A Guide to Python's Magic Methods (repo on GitHub) <https://github.com/RafeKettler/magicmethods/blob/master/magicmethods.pdf>`_
-    
 
+
+****************************
 工程师和科学家
-----------------------------
+****************************
 
 A Primer on Scientific Programming with Python
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -208,7 +243,7 @@ A Primer on Scientific Programming with Python
 A Primer on Scientific Programming with Python 由 Hans Petter Langtangen编写，
 主要涵盖了Python在科学领域的使用。在这本书中，例子是从数学和自然科学中选出的。
 
-    `A Primer on Scientific Programming with Python <http://www.springer.com/mathematics/computational+science+%26+engineering/book/978-3-642-30292-3>`_
+    `A Primer on Scientific Programming with Python <https://www.springer.com/us/book/9783642302930#otherversion=9783642302923>`_
 
 Numerical Methods in Engineering with Python
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -216,10 +251,12 @@ Numerical Methods in Engineering with Python
 Numerical Methods in Engineering with Python 由 Jaan Kiusalaas 编写，
 其重点是数值方法以及如何用Python来实现。
 
-    `Numerical Methods in Engineering with Python <http://www.cambridge.org/us/academic/subjects/engineering/engineering-mathematics-and-programming/numerical-methods-engineering-python-2nd-edition>`_
+    `Numerical Methods in Engineering with Python <https://www.cambridge.org/us/academic/subjects/engineering/engineering-mathematics-and-programming/numerical-methods-engineering-python-2nd-edition>`_
+
 
+********************
 各种各样的话题
---------------------
+********************
 
 Problem Solving with Algorithms and Data Structures
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -242,8 +279,8 @@ Programming Collective Intelligence介绍了大量基础的机器学习和数据
 Transforming Code into Beautiful, Idiomatic Python
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Transforming Code into Beautiful, Idiomatic Python 是由 Raymond Hettinger制作的视频。
-通过它可以学习到更好地使用Python最佳特性，通过一系列的代码转换来改进现有代码，
+Transforming Code into Beautiful, Idiomatic Python 是由 Raymond Hettinger 制作的视频。
+通过它可以学习到更好地使用Python的最佳特性，通过一系列的代码转换来改进现有代码：
 “当您看见这个，就那样去做”。
 
     `Transforming Code into Beautiful, Idiomatic Python <https://www.youtube.com/watch?v=OSGv2VnC0go>`_
@@ -260,8 +297,17 @@ Fullstack Python为使用Python进行Web开发提供了完整的自顶向下的
 
     `Fullstack Python <https://www.fullstackpython.com>`_
 
+PythonistaCafe
+~~~~~~~~~~~~~~
+
+PythonistaCafe 是一个邀请式的在线社区，里面的 Python 和软件开发爱好者互帮互助、彼此成长。可以把它看做是 Pythonista 共同进行改进的俱乐部。在这里，每天都会讨论广泛的编程问题、职业建议，同时也会涉及其他主题。
+
+    `PythonistaCafe <https://www.pythonistacafe.com>`_
+
+
+**********
 参考
-----------
+**********
 
 Python in a Nutshell
 ~~~~~~~~~~~~~~~~~~~~
@@ -309,6 +355,6 @@ Writing Idiomatic Python 由 Jeff Knupp 编写，包含了最常见和最重要
 其形式尽可能地有辨识度和易于理解。每个习语都是编写一些常用代码片段的推荐方式，
 其后会解释为什么这个习语是重要的。每个习语均有两个代码样例：“有害的”方式和“理想的”方式。
 
-	`For Python 2.7.3+ <http://www.amazon.com/Writing-Idiomatic-Python-2-7-3-Knupp/dp/1482372177/>`_
+	`For Python 2.7.3+ <https://www.amazon.com/Writing-Idiomatic-Python-Jeff-Knupp-ebook/dp/B00B5KG0F8/>`_
 	
-	`For Python 3.3+  <http://www.amazon.com/Writing-Idiomatic-Python-Jeff-Knupp-ebook/dp/B00B5VXMRG/>`_
+	`For Python 3.3+  <https://www.amazon.com/Writing-Idiomatic-Python-Jeff-Knupp-ebook/dp/B00B5VXMRG/>`_
diff --git a/docs/intro/news.rst b/docs/intro/news.rst
index e4dfa36..6489bfa 100644
--- a/docs/intro/news.rst
+++ b/docs/intro/news.rst
@@ -1,66 +1,97 @@
+
+
+########
 新闻
-====
+########
 
 .. image:: https://farm4.staticflickr.com/3804/33573767786_eececc5d27_k_d.jpg
 
+
+****************
+PyCoder's Weekly
+****************
+
+PyCoder's Weekly 是一个面向 Python 开发者的免费的每周简讯，包括项目、文章、新闻和工作。
+
+    `PyCoder's Weekly <http://www.pycoders.com/>`_
+
+
+***********
+Real Python
+***********
+
+在 Real Python 中，您可以通过每周免费且深入的教程从头开始学习 Python 的所有内容，
+包括 Python 最基础的知识，再到 Web 开发和 Web 爬取，再到数据可视化等等。
+
+    `Real Python <https://realpython.com/>`_
+
+
+*************
 Planet Python
-~~~~~~~~~~~~~
+*************
 
 这是一个聚合的，展示不断增长的开发者内容的Python新闻。
 
-    `Planet Python <http://planet.python.org>`_
+    `Planet Python <https://planetpython.org>`_
+
 
+*********
 /r/python
-~~~~~~~~~
+*********
 
 /r/python是Reddit的Python社区，在这里用户会贡献和投票出和Python相关的新闻。
 
-    `/r/python <http://reddit.com/r/python>`_
+    `/r/python <https://reddit.com/r/python>`_
+
 
+*******************
 Talk Python Podcast
-~~~~~~~~~~~~~~~~~~~
+*******************
 
 第一个关注 Python 的播客，涵盖了 Python 中的人和想法。
 
     `Talk Python To Me <https://talkpython.fm>`_
 
+
+********************
 Python Bytes Podcast
-~~~~~~~~~~~~~~~~~~~~
+********************
 
 一个简短的 Python 播客，涵盖了最近的开发人员头条。
 
     `Python Bytes <https://pythonbytes.fm>`_
 
-Pycoder's Weekly
-~~~~~~~~~~~~~~~~
-
-Pycoder's Weekly是一个面向Python开发者的免费的每周简讯，包括项目、文章、新闻和工作。
-
-    `Pycoder's Weekly <http://www.pycoders.com/>`_
 
+*************
 Python Weekly
-~~~~~~~~~~~~~
+*************
 
 Python Weekly是一个免费的每周简讯，其特色包括与Python相关的新闻、文章、新的发行版本、工作等。
 
-    `Python Weekly <http://www.pythonweekly.com/>`_
+    `Python Weekly <https://www.pythonweekly.com/>`_
+
 
+***********
 Python News
-~~~~~~~~~~~~~
+***********
 
 Python News是Python官方网站的新闻章节。它简短突出来自Python社区的新闻。
 
-    `Python News <http://www.python.org/news/>`_
+    `Python News <http://www.python.org/blogs/>`_
 
+
+********************
 Import Python Weekly
-~~~~~~~~~~~~~~~~~~~~
+********************
 
 Weekly Python Newsletter包含有Python文章、项目、视频、Tweets，并发送到您的收件箱。能够保持您的Python编程技能持续更新。
 
     `Import Python Weekly Newsletter <http://www.importpython.com/newsletter/>`_
 
+
+*************************
 Awesome Python Newsletter
-~~~~~~~~~~~~~~~~~~~~~~~~~
+*************************
 
 每周最流行的Python新闻、文章和包的概述。
 
diff --git a/docs/notes/contribute.rst b/docs/notes/contribute.rst
index 20ec9a8..92a87a6 100644
--- a/docs/notes/contribute.rst
+++ b/docs/notes/contribute.rst
@@ -1,7 +1,8 @@
+##########
 贡献
-~~~~~~~~~~
+##########
 
-.. image:: https://farm3.staticflickr.com/2858/33573769116_49c1ef51e7_k_d.jpg
+.. image:: /_static/photos/33573769116_49c1ef51e7_k_d.jpg
 
 Python-guide目前还在开发中，欢迎大家贡献代码。
 
@@ -10,20 +11,19 @@ Python-guide目前还在开发中，欢迎大家贡献代码。
 `贡献者一览 <https://github.com/kennethreitz/python-guide/contributors>`_ 中。
 
 
+***********
 风格指南
------------
+***********
 
 请戳这里 :ref:`guide-style-guide`.
 
 .. _todo-list-ref:
 
+*********
 要做的事
----------
+*********
 
-如果您想为我们做些贡献，这里有我们的计划。一个简短的 todo_ 列表。
+如果您想为我们做些贡献，请查看 GitHub_ 上的 issue 列表。
 
-    .. include:: ../../TODO.rst
 
-
-.. _GitHub: http://github.com/kennethreitz/python-guide/
-.. _todo: https://github.com/kennethreitz/python-guide/blob/master/TODO.rst
+.. _GitHub: https://github.com/kennethreitz/python-guide/
diff --git a/docs/notes/license.rst b/docs/notes/license.rst
index cd3aca8..88f2a21 100644
--- a/docs/notes/license.rst
+++ b/docs/notes/license.rst
@@ -1,6 +1,6 @@
-=======
+#######
 许可证
-=======
+#######
 
 .. image:: https://farm4.staticflickr.com/3762/32800805573_568d6b72fd_k_d.jpg
 
diff --git a/docs/notes/styleguide.rst b/docs/notes/styleguide.rst
index 3cdb667..6af971e 100644
--- a/docs/notes/styleguide.rst
+++ b/docs/notes/styleguide.rst
@@ -1,8 +1,8 @@
 .. _guide-style-guide:
 
-=====================
+#####################
 风格指南指引
-=====================
+#####################
 
 .. image:: https://farm4.staticflickr.com/3684/33573755856_7f43d43adf_k_d.jpg
 
@@ -14,20 +14,22 @@
 
 .. note:: 在任何一个渲染后的HTML页面，您可以点击“查看源码（Show Source）”来看作者是如何排版的。
 
+*********
 关联
----------
+*********
 
 尽量保持任何贡献与 :ref:`本指南目的 <about-ref>` 相关。
 
 * 避免在主题中包含太多与Python开发并不直接相关的信息。
 * 如果其他资源已存在，最好以链接的形式来展示。确保描述出您所链接的内容和原因。
-* `Cite <http://sphinx.pocoo.org/rest.html?highlight=citations#citations>`_
+* `Cite <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#citations>`_
   引用在需要的地方。
 * 如果某主题并不与Python直接相关，但是和Python之间的关联又很有用（比如Git、GitHub、数据库等），以链接的形式引用这些资源，并描述为什么它对Python有用。
 * 如果疑问，就去询问。
 
+********
 标题
---------
+********
 
 使用下列风格作为标题。
 
@@ -43,37 +45,43 @@
 
 .. code-block:: rest
 
-    ===================
+    *******************
     时间是种幻觉
-    ===================
+    *******************
 
 小节标题:
 
 .. code-block:: rest
 
     午餐时间加倍
-    -------------------
+     ===================
 
 次小节标题:
 
 .. code-block:: rest
 
     非常深
-    ~~~~~~~~~
+    ---------
 
+
+*****
 换行
------
+*****
 
 每78个字符进行文字换行。必要时可以超过78个字符，尤其是那种换行使得源内容更难阅读的情况。
 
+使用标准的美式英语，而非英式英语。
+
 `序列逗号（serial comma） <https://en.wikipedia.org/wiki/Serial_comma>`_ 
 （也称为Oxford comma，牛津逗号）的使用是100%没有选择的。 任何尝试以缺少的连续逗号提交内容
 将导致该项目的永久性移除，因为完全缺乏品味。
 
 流放？ 您在开玩笑吗？ 希望我们永远不必找出来。
 
+
+*************
 代码例子
--------------
+*************
 
 所有代码示例要在70个字符进行换行，以避免出现水平滚动条。
 
@@ -86,7 +94,9 @@
         $ run command --help
         $ ls ..
 
-确保每行前面包含了 ``$`` 前缀。
+Unix 控制台用例中，确保每行前面包含了 ``$`` 前缀。
+
+Windows 控制台用例中，使用 ``doscon`` 或 ``powershell`` 而非 ``console``，并且去掉 ``$`` 前缀。
 
 Python解释器例子：
 
@@ -109,8 +119,9 @@ Python 例子：
         def get_answer():
             return 42
 
+******************
 外部链接
-------------------
+******************
 
 * 链接时最好使用众所周知的主题（比如一些合适的名词）：
 
@@ -118,21 +129,22 @@ Python 例子：
 
       Sphinx_ 通常用来文档化Python。
 
-      .. _Sphinx: http://sphinx.pocoo.org
+      .. _Sphinx: https://www.sphinx-doc.org
 
 * 最好使用带有内联链接的描述性标签，而不是单纯的链接:
 
   .. code-block:: rest
 
-      阅读 `Sphinx 教程 <http://sphinx.pocoo.org/tutorial.html>`_
+      阅读 `Sphinx 教程 <https://www.sphinx-doc.org/en/master/usage/quickstart.html>`_
 
 * 避免使用诸如“点击这里”、“这个”等标签。最好使用描述性标签（值得搜索引擎优化，SEO worthy）。
 
+********************************
 指向指南内部章节的链接
---------------------------------
+********************************
 
 要交叉引用本文档的其他部分，使用 `:ref:
-<http://sphinx.pocoo.org/markup/inline.html#cross-referencing-arbitrary-locations>`_ 关键字和标签。
+<https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-ref>`_ 关键字和标签。
 
 要使引用标签更加清晰和独特，通常加上一个 ``-ref`` 后缀：
 
@@ -143,10 +155,12 @@ Python 例子：
     Some Section
     ------------
 
+
+******************
 注意和警告
-------------------
+******************
 
-使用适当的 `警告指示 <http://sphinx.pocoo.org/rest.html#directives>`_ 来说明注意内容。
+使用适当的 `警告指示 <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#directives>`_ 来说明注意内容。
 
 注意:
 
@@ -163,14 +177,14 @@ Python 例子：
 
     .. warning:: DON'T PANIC
 
+***************
 要做的事
----------------
+***************
 
-请用 `todo 指示 <http://sphinx.pocoo.org/ext/todo.html?highlight=todo#directive-todo>`_ 来标记本指南中任何未完成的部分。避免使 :ref:`todo-list-ref` 混乱，为未完的文档或者大量未完的小节使用单独的 ``todo``。
+请用 `todo 指示 <https://www.sphinx-doc.org/en/master/usage/extensions/todo.html>`_ 来标记本指南中任何未完成的部分。避免使 :ref:`todo-list-ref` 混乱，为未完的文档或者大量未完的小节使用单独的 ``todo``。
 
 .. code-block:: rest
 
     .. todo::
         Learn the Ultimate Answer to the Ultimate Question
         of Life, The Universe, and Everything
-
diff --git a/docs/scenarios/admin.rst b/docs/scenarios/admin.rst
index 0ed21bc..0486eac 100644
--- a/docs/scenarios/admin.rst
+++ b/docs/scenarios/admin.rst
@@ -1,10 +1,13 @@
+
+######################
 系统管理
-======================
+######################
 
 .. image:: https://farm5.staticflickr.com/4179/34435690580_3afec7d4cd_k_d.jpg
 
+******
 Fabric
-------
+******
 
 `Fabric <http://docs.fabfile.org>`_ 是一个简化系统管理任务的库。
 Chef和Puppet倾向于关注管理服务器和系统库，而Fabric更加关注应用级别的任务，比如说部署。
@@ -16,7 +19,7 @@ Chef和Puppet倾向于关注管理服务器和系统库，而Fabric更加关注
     $ pip install fabric
 
 下面的代码将会创建我们可以使用的两个任务： ``memory_usage`` 和 ``deploy``。
-前者将会在每台机器上输出内存使用情况。后者将会ssh到每台服务器，cd到我们的工程目录，
+前者将会在每台机器上输出内存使用情况。后者将会SSH到每台服务器，cd到我们的工程目录，
 激活虚拟环境，拉取最新的代码库，以及重启应用服务器。
 
 .. code-block:: python
@@ -65,8 +68,9 @@ and we can deploy with:
 
     `Fabric 文档 <http://docs.fabfile.org>`_
 
+****
 Salt
-----
+****
 
 `Salt <http://saltstack.org/>`_ 是一个开源的基础管理工具。
 它支持从中心节点（主要的主机）到多个主机（指从机）的远程命令执行。
@@ -116,8 +120,9 @@ Salt也提供状态系统。状态能够用来配置从机。
     `Salt 文档 <http://docs.saltstack.com>`_
 
 
+******
 Psutil
-------
+******
 
 `Psutil <https://github.com/giampaolo/psutil/>`_ 是获取不同系统信息
 （比如CPU、内存、硬盘、网络、用户、进程）的接口。
@@ -133,45 +138,47 @@ Psutil
     # 用于email服务的包:
     import smtplib
     import string
-    MAX_NET_USAGE = 400000
+    MAX_NET_USAGE = 400000  # 每秒字节数
     MAX_ATTACKS = 4
     attack = 0
-    counter = 0
     while attack <= MAX_ATTACKS:
         sleep(4)
-        counter = counter + 1
-        # Check the cpu usage
-        if cpu_percent(interval = 1) > 70:
-            attack = attack + 1
-        # Check the net usage
-        neti1 = net_io_counters()[1]
-        neto1 = net_io_counters()[0]
+
+        # 使用命名元组检查网络使用情况
+        neti1 = net_io_counters().bytes_recv
+        neto1 = net_io_counters().bytes_sent
         sleep(1)
-        neti2 = net_io_counters()[1]
-        neto2 = net_io_counters()[0]
-        # Calculate the bytes per second
+        neti2 = net_io_counters().bytes_recv
+        neto2 = net_io_counters().bytes_sent
+
+        # 计算每秒字节数
         net = ((neti2+neto2) - (neti1+neto1))/2
-        if net > MAX_NET_USAGE:
-            attack = attack + 1
-        if counter > 25:
-            attack = 0
-            counter = 0
+
+        # 检查网络和cpu使用
+        if (net > MAX_NET_USAGE) or (cpu_percent(interval = 1) > 70):
+            attack+=1
+        elif attack > 1:
+            attack-=1
+
     # 如果attack大于4，就编写一封十分重要的email
     TO = "you@your_email.com"
     FROM = "webmaster@your_domain.com"
     SUBJECT = "Your domain is out of system resources!"
     text = "Go and fix your server!"
-    BODY = string.join(("From: %s" %FROM,"To: %s" %TO,"Subject: %s" %SUBJECT, "",text), "\r\n")
+    string="\r\n"
+    BODY = string.join(("From: %s" %FROM,"To: %s" %TO,
+                        "Subject: %s" %SUBJECT, "",text))
     server = smtplib.SMTP('127.0.0.1')
     server.sendmail(FROM, [TO], BODY)
     server.quit()
 
 
-一个类似于基于psutil并广泛扩展的top，并拥有客服端-服务端监控能力的完全终端应用叫做 
-`glance <https://github.com/nicolargo/glances/>`_ 。
+一个基于psutil，类似于top命令并广泛扩展的功能全面的终端应用程序叫做 `glance <https://github.com/nicolargo/glances/>`_ ，它具备客户端-服务端监控能力。
 
+
+*******
 Ansible
--------
+*******
 
 `Ansible <http://ansible.com/>`_ 是一个开源系统自动化工具。
 相比于Puppet或者Chef最大的优点是它不需要客户机上的代理。
@@ -218,8 +225,10 @@ Ansible playbook在 :file:`hosts.yml` 中将会ping所有的服务器。您也
 `Ansible教程 <https://serversforhackers.com/an-ansible-tutorial/>`_ 也是一个很棒的且详细的指引来开始熟悉Ansible。
 
 
+****
 Chef
-----
+****
+
 `Chef <https://www.chef.io/chef/>`_ 是一个系统的云基础设施自动化框架，
 它使部署服务器和应用到任何物理、虚拟或者云终端上变得简单。您可以选择进行配置管理，那将主要使用Ruby去编写您的基础设施代码。
 
@@ -243,8 +252,10 @@ Chef通过使用定制的在cookbook中实现的食谱（配置元素）来工
 
 - `Chef 文档 <https://docs.chef.io/>`_
 
+
+******
 Puppet
-------
+******
 
 `Puppet <http://puppetlabs.com>`_ 是来自Puppet Labs的IT自动化和配置管理软件，允许系统管理员定义他们的IT基础设施状态，
 这样就能够提供一种优雅的方式管理他们成群的物理和虚拟机器。
@@ -254,7 +265,7 @@ Puppet均可作为开源版和企业版获取到。其模块是小的、可共
 
 Puppet代理安装于其状态需要被监控或者修改的节点上。作为特定服务器的Puppet Master负责组织代理节点。
 
-代理节点发送系统的基本信息到Puppet Master，比如说操作系统、内核、架构、ip地址、主机名等。
+代理节点发送系统的基本信息到Puppet Master，比如说操作系统、内核、架构、IP地址、主机名等。
 接着，Puppet Master编译携带有节点生成信息的目录，告知每个节点应如何配置，并发送给代理。
 代理便会执行前述目录中的变化，并向Puppet Master发送回一份报告。
 
@@ -322,22 +333,29 @@ Puppet有多种资源类型，需要时可以使用包-文件-服务（package-f
 
 了解更多信息，参考 `Puppet Labs 文档 <http://docs.puppetlabs.com>`_ 。
 
+
+*********
 Blueprint
----------
+*********
 
 .. todo:: Write about Blueprint
 
+********
 Buildout
---------
+********
 
 `Buildout <http://www.buildout.org>`_ 是一个开源软件构件工具。Buildout由Python编写。
-它实现了配置和构建脚本分离的原则。Buildout主要用于下载和设置正在开发或部署软件的Python egg格式的依赖。
+它实现了配置和构建脚本分离的原则。Buildout主要用于下载和设置正在开发或部署软件的
+`Python eggs <https://stackoverflow.com/questions/2051192/what-is-a-python-egg>` 格式的依赖。
 在任何环境中构建任务的指南（recipe，原意为“食谱”，引申为“指南”）能被创建，许多早已可用。
 
+
+*******
 Shinken
--------
+*******
 
-`Shinken <http://www.shinken-monitoring.org/>`_ 是一个使用Python编写的现代化的兼容Nagios的监控框架。
-其主要目标是为用户的设计成可扩展到大型环境的监控系统提供灵活的框架。
+`Shinken <http://www.shinken-monitoring.org/>`_ 是一个由 Python 编写的现代化、兼容 Nagios
+的监控框架。它的主要目标是为用户的监控系统提供灵活的架构，并且这个架构被设计为可扩展到大型环境。
 
-Shinken与Nagios配置标准和插件向后兼容。它适用于任何支持Python的操作系统和架构，包括Windows、GNU/Linux和FreeBSD。
\ No newline at end of file
+Shinken 向后兼容 Nagios 的配置标准和插件。它可以在任何支持 Python 的操作系统和架构上运行，
+包括 Windows、Linux 和 FreeBSD。
diff --git a/docs/scenarios/ci.rst b/docs/scenarios/ci.rst
index fa317c3..187f26f 100644
--- a/docs/scenarios/ci.rst
+++ b/docs/scenarios/ci.rst
@@ -1,10 +1,16 @@
+######################
 持续集成
-======================
+######################
 
 .. image:: https://farm5.staticflickr.com/4173/33907150594_9abba7ad0a_k_d.jpg
 
+.. note::
+    关于编写测试更多的建议，参阅 :doc:`/writing/tests`。
+
+
+************
 为什么?
-------------
+************
 
 Martin Fowler 和 Kent Beck 首次提出 `Continuous Integration <http://martinfowler.com/articles/continuousIntegration.html>`_ 
 （简称：CI），将之描述为：
@@ -14,23 +20,25 @@ Martin Fowler 和 Kent Beck 首次提出 `Continuous Integration <http://martinf
     检测错误。许多团队发现这种方法可以显著的减少集成问题并且可以使团队的开发更加
     快捷。
 
+
+*******
 Jenkins
--------
+*******
 
 `Jenkins CI <http://jenkins-ci.org>`_ 可扩展的持续集成引擎。 使用它吧！
 
 
-
+********
 Buildbot
---------
+********
 
 `Buildbot <http://docs.buildbot.net/current/>`_ 是一个检查代码变化的自动化编译/
 测试的Python系统。
 
 
-
+***
 Tox
----
+***
 
 `Tox <https://tox.readthedocs.io/en/latest/>`_ 是一款为Python软件提供打包、测试和
 开发的自动化工具，基于命令行或CI服务器。它是一个通用的虚拟环境管理和测试的命令行
@@ -41,13 +49,13 @@ Tox
 * 作为前端持续集成服务器，减少样板文件，合并了CI和基于shell的测试。
 
 
-
+*********
 Travis-CI
----------
+*********
 
 `Travis-CI <https://travis-ci.org/>`_ 是一个分布式CI服务器，免费为开源项目构建测试。
 它提供多个worker运行Python测试，并能和GitHub无缝集成。您甚至可以用它对您的Pull Requests
-评论是否构建这个特定的变更集。Travis-ci是一个很好的、简单的方式去了解持续集成。
+评论是否构建这个特定的变更集。Travis-CI 是一个很好的、简单的方式去了解持续集成。
 
 作为开始，将 :file:`.travis.yml` 文件加入到您的仓库中，内容如下::
 
@@ -65,9 +73,9 @@ Travis-CI
 
 
 这将会使您的工程在罗列的Python版本中，用给定的脚本进行测试，而且只会构建主干分支。
-有许多可供开启的选项，包括通知、步骤前后等。 `Travis-ci docs <http://about.travis-ci.org/docs/>`_ 
+有许多可供开启的选项，包括通知、步骤前后等。 `Travis-CI docs <http://about.travis-ci.org/docs/>`_ 
 详尽地解释了所有这些操作。
 
-为了激活您的工程的测试，去 `travis-ci 网站 <https://docs.travis-ci.com/user/languages/python/>`_ 登录您的GitHub
+为了激活您的工程的测试，去 `Travis-CI 网站 <https://docs.travis-ci.com/user/languages/python/>`_ 登录您的GitHub
 账号。然后在您的profile设置中激活您的工程。现在，每一次push到GitHub上的提交将会运行
 您的工程中的测试。
\ No newline at end of file
diff --git a/docs/scenarios/cli.rst b/docs/scenarios/cli.rst
index 4be89c4..1b0ada5 100644
--- a/docs/scenarios/cli.rst
+++ b/docs/scenarios/cli.rst
@@ -1,5 +1,7 @@
+
+#########################
 命令行应用
-=========================
+#########################
 
 .. image:: https://farm5.staticflickr.com/4272/34435690330_11930b5987_k_d.jpg
 
@@ -14,51 +16,61 @@
 
 一些流行的命令行应用包括：
 
-* `Grep <http://en.wikipedia.org/wiki/Grep>`_ - 一个纯文本数据搜索工具
+* `grep <http://en.wikipedia.org/wiki/grep>`_ - 一个纯文本数据搜索工具
 * `curl <http://curl.haxx.se/>`_ - 基于URL语法的数据传输工具
 * `httpie <https://github.com/jakubroztocil/httpie>`_ - 一个用户友好的命令行HTTP客户端，可以代替cURL
-* `git <http://git-scm.com/>`_ - 一个分布式版本控制系统
-* `mercurial <https://www.mercurial-scm.org/>`_ - 一个主体是Python的分布式版本控制系统
-
-Clint
------
+* `Git <http://git-scm.com/>`_ - 一个分布式版本控制系统
+* `Mercurial <https://www.mercurial-scm.org/>`_ - 一个主体是Python的分布式版本控制系统
 
-`clint <https://pypi.python.org/pypi/clint/>`_ 是一个Python模块，它包含了很多
-对命令行应用开发有用的工具。它支持诸如CLI着色以及缩进，简洁而强大的列打印，
-基于进度条的迭代以及参数控制的特性。
 
+*****
 Click
------
+*****
+
+`click <https://click.palletsprojects.com>`_ 是一个以尽可能少的代码，用组合方式创建命令行接口的Python包。
+命令行接口创建工具（“Command-Line Interface Creation Kit”, Click）高度可配置，但也有开箱即用的默认值设置。
 
-`click <http://click.pocoo.org/>`_ 是一个以尽可能少的代码，用组合方式创建命令行接口的Python包。
-命令行接口创建工具（“Command-line Interface Creation Kit”, Click）高度可配置，但也有开箱即用的默认值设置。
 
+******
 docopt
-------
+******
 
 `docopt <http://docopt.org/>`_ 是一个轻量级，高度Pythonic风格的包，它支持
 简单而直觉地创建命令行接口，它是通过解析POSIX-style的用法指示文本实现的。
 
+
+****
 Plac
-------
+****
+
+`Plac <https://pypi.org/project/plac>`_ 是对 Python 标准库 
+`argparse <http://docs.python.org/2/library/argparse.html>`_ 的简单封装。
+它使用声明式接口隐藏其复杂性：参数解析器是被推断出来，而非强制编写。
+此模块面向不熟练的用户、程序员、系统管理员、科学家以及只想
+写个只一次性脚本的人们。他们选择创建命令行界面，因为它快速而简单。
 
-`Plac <https://pypi.python.org/pypi/plac>`_ Python标准库 
-`argparse <http://docs.python.org/2/library/argparse.html>`_ 的简单封装，
-它隐藏了大量声明接口的细节：参数解析器是被推断的，其优于写命令明确处理。
-这个模块的面向是不想太复杂的用户，程序员，系统管理员，科学家以及只是想
-写个只运行一次的脚本的人们，使用这个命令行接口的理由是它可以快速实现并且简单。
 
+*****
 Cliff
-------
+*****
 
 `Cliff <http://docs.openstack.org/developer/cliff/>`_  是一个建立命令行程序的框架。
 它使用setuptools入口点（entry points）来提供子命令，输出格式化，以及其他的扩展。这个框架
-可以用来创建多层命令程序，如subversion与git，其主程序要进行一些简单的参数解析然后调用
+可以用来创建多层命令程序，如 ``svn`` 和 ``git``，其主程序要进行一些简单的参数解析然后调用
 一个子命令干活。
 
+
+******
 Cement
-------
+******
 
 `Cement <http://builtoncement.com/>`_ 是一个高级的CLI应用程序框架。
 其目标是为简单和复杂的命令行应用程序引入标准和功能完整的平台，并支持快速开发需求，而不会牺牲质量。
-Cement是灵活的，它的用例范围涵盖了从微框架的简单到巨型框架的复杂。
\ No newline at end of file
+Cement是灵活的，它的用例范围涵盖了从微框架的简单到巨型框架的复杂。
+
+
+***********
+Python Fire
+***********
+
+`Python Fire <https://github.com/google/python-fire/>`_ 是一个能根据任意 Python 对象自动生成出命令行接口的库。它能帮助您更轻松地通过命令行调试 Python 代码，根据现有代码创建命令行接口，还能让您以在 REPL 中交互式地浏览 Python 对象，并简化 Python 和 Bash（或任何其他 Shell）之间的转换。
diff --git a/docs/scenarios/clibs.rst b/docs/scenarios/clibs.rst
index 3000453..6e06fd2 100644
--- a/docs/scenarios/clibs.rst
+++ b/docs/scenarios/clibs.rst
@@ -1,14 +1,21 @@
+
+################################
 与C/C++库交互
-================================
+################################
 
 .. image:: https://farm5.staticflickr.com/4173/34725951345_c8f5959a2e_k_d.jpg
 
-C语言外部函数接口(CFFI)
-----------------------------
 
-`CFFI <https://cffi.readthedocs.io/en/latest/>`_ 通过CPython和PyPy给出了和
-C语言交互的简单使用机制。它支持两种模式：一种是内联的ABI兼容模式(示例如下)，
-它允许您动态加载和运行可执行模块的函数(本质上与LoadLibrary和dlopen拥有相同的功能)；
+############################
+C语言外部函数接口(CFFI)
+############################
+
+`CFFI <https://cffi.readthedocs.io/en/latest/>`_ 通过 CPython 和 PyPy 给出了和
+C语言交互的简单使用机制。它支持两种模式：一种是内联的 
+`ABI <https://stackoverflow.com/questions/2171177/what-is-an-application-binary-interface-abi>`_  
+兼容模式(示例如下)，它允许您动态加载和运行可执行模块的函数(本质上与 
+`LoadLibrary <https://docs.microsoft.com/en-us/windows/desktop/api/libloaderapi/nf-libloaderapi-loadlibrarya>`_ 或 
+`dlopen <https://www.tldp.org/HOWTO/C++-dlopen/index.html>`_ 拥有相同的功能)；
 另一种为API模式，它允许您构建C语言扩展模块。
 
 ABI 交互
@@ -25,11 +32,13 @@ ABI 交互
     # prints: 23
     print("{}".format(length))
 
+
+******
 ctypes
-------
+******
 
 `ctypes <https://docs.python.org/3/library/ctypes.html>`_ 是CPython中与C/C++
-交互的事实上的库。它不仅能完全访问大多数主流操作系统(比如：Windows上的Kernel32，
+交互的事实上的标准库。它不仅能完全访问大多数主流操作系统(比如：Windows上的Kernel32，
 \*nix上的libc)的纯C接口，并且支持对动态库的加载和交互，如DLL和运行时共享对象。
 它同时涵盖许多可和系统API交互的类型，并允许您以相对简单的方式定义自己的复杂类型，
 如struct和union，并在需要时允许您作出如填充、对齐这样的修改。对它的使用可能稍显复杂，
@@ -59,8 +68,10 @@ Struct Equivalents
         _fields_ = [("a", c_int),
                     ("b", c_int)]
 
+
+****
 SWIG
-----
+****
 
 `SWIG <http://www.swig.org>`_ 并不仅仅应用于Python(它支持多种脚本语言)，
 它是生成解释性语言和C/C++头文件绑定的工具。它极易使用：使用者只需简单的定义接口文件
@@ -110,8 +121,9 @@ SWIG
     %include "MyClass.h"
 
 
+************
 Boost.Python
-------------
+************
 
 `Boost.Python <http://www.boost.org/doc/libs/1_59_0/libs/python/doc/>`_ 
 需要一些手动工作来展现C++对象的功能，但它可提供SWIG拥有的所有特性。同时，
diff --git a/docs/scenarios/client.rst b/docs/scenarios/client.rst
index e513fb7..d9ac9d9 100644
--- a/docs/scenarios/client.rst
+++ b/docs/scenarios/client.rst
@@ -1,36 +1,41 @@
+
+####################
 网络应用
-====================
+####################
 
 .. image:: https://farm5.staticflickr.com/4251/34364815780_bea6614025_k_d.jpg
 
+
+****
 HTTP
-::::
+****
 
 超文本传输协议(HTTP)是为分布式的、协同的多媒体信息系统而设计的应用协议，是万维网数据传输的基础。
 
 Requests
---------
+~~~~~~~~
 
 Python的urllib2标准模块涵盖了所需的大多数HTTP功能，但它的API却是支离破碎的。它构建在一个和现今完全不同的时期——以及为了一个不一样的网络。一个简单的任务便需要耗费它大量的工作(即使重写函数也无济于事)。
 
 Requests将所有Python HTTP相关的功能剥离了出来，并与网络服务无缝衔接。Requests无需再在URL中添加查询语句或格式编码的POST数据。而集成在Requests中urllib3，则实现了持久连接和HTTP连接池的完全自动化。
 
-- `文档 <http://docs.python-requests.org/en/latest/index.html>`_
-- `PyPi <http://pypi.python.org/pypi/requests>`_
+- `文档 <https://requests.readthedocs.io/en/latest/>`_
+- `PyPI http://pypi.org/project/requests>`_
 - `GitHub <https://github.com/kennethreitz/requests>`_
 
 
+********************
 分布式系统
-::::::::::::::::::::
+********************
 
 
 ZeroMQ
-------
+~~~~~~
 
 ØMQ(也被称作ZeroMQ, 0MQ 或 ZMQ)是一种高性能异步消息传递库，旨在应用于可扩展分布的或并发的应用。它提供一个消息队列，但与面向消息的中间件不同，ØMQ系统可在不依赖专用消息代理的情况下运行。ØMQ旨在设计成为类似于socket风格的API。
 
 RabbitMQ
---------
+~~~~~~~~
 
 RabbitMQ是一种使用了高级消息队列协议(AMQP)的开源消息代理软件。RabbitMQ服务由Erlang编程语言写成，并构建在开放电信平台框架上，应用于集群和故障转移。与该代理交互的客户端库支持所有主流编程语言。
 
diff --git a/docs/scenarios/crypto.rst b/docs/scenarios/crypto.rst
index e34c670..85d7c93 100644
--- a/docs/scenarios/crypto.rst
+++ b/docs/scenarios/crypto.rst
@@ -1,15 +1,19 @@
+
+############
 密码学
-============
+############
 
 .. image:: https://farm5.staticflickr.com/4220/33907152824_bf91078cc1_k_d.jpg
 
-Cryptography
-------------
 
-`Cryptography <https://cryptography.io/en/latest/>`_ 是一个开发活跃的库，它提供
+************
+cryptography
+************
+
+`cryptography <https://cryptography.io/en/latest/>`_ 是一个开发活跃的库，它提供
 了加密方法（recipes）和基元（primitives），支持Python 2.6-2.7、Python 3.3+ 和 PyPy。
 
-Cryptography 分为两个层，方法（recipes）层和危险底层（hazardous materials，简称hazmat）。
+cryptography 分为两个层，方法（recipes）层和危险底层（hazardous materials，简称hazmat）。
 方法层提供用于适当的对称加密，hazmat层提供底层的加密基元。
 
 安装
@@ -33,30 +37,49 @@ Cryptography 分为两个层，方法（recipes）层和危险底层（hazardous
 	plain_text = cipher_suite.decrypt(cipher_text)
 
 
+**************
+GPGME bindings
+**************
 
-PyCrypto
---------
+`GPGME Python bindings <https://dev.gnupg.org/source/gpgme/browse/master/lang/python/>`_ 提供Pythonic的方式访问 `GPG Made Easy <https://dev.gnupg.org/source/gpgme/browse/master/>`_ ，这是整个GNU Privacy Guard项目套件，包括GPG、libgcrypt和gpgsm（S/MIME 引擎），的C API。它支持Python 2.6、2.7、3.4及以上版本。取决于Python的SWIG C接口以及GnuPG软件和库。
 
-`PyCrypto <https://www.dlitz.net/software/pycrypto/>`_ 是另一个密码库，它提供
-安全的哈希函数和各种加密算法，支持Python 2.1到3.3。
+这里有更全面的GPGME Python Bindings HOWTO的 `源码版 <https://dev.gnupg.org/source/gpgme/browse/master/lang/python/docs/GPGMEpythonHOWTOen.org>`_  和 `HTML版 <http://files.au.adversary.org/crypto/GPGMEpythonHOWTOen.html>`_。还提供了Python 3版本的HOWTO示例脚本的源代码，并且可以在 `这里 <https://dev.gnupg.org/source/gpgme/browse/master/lang/python/examples/howto/>`_ 访问。
+
+其在与GnuPG其余项目的相同条款（GPLv2和LGPLv2.1，均带有“或更高版本”）下可用。
 
 安装
 ~~~~~~~~~~~~
 
-.. code-block:: console
-
-    $ pip install pycrypto
+如果配置脚本定位到了所支持的python版本（配置时位于$PATH中），那么在编译GPGME时会默认包含它。
 
 例子
 ~~~~~~~
 
-.. code-block:: python
-
-	from Crypto.Cipher import AES
-	# Encryption
-	encryption_suite = AES.new('This is a key123', AES.MODE_CBC, 'This is an IV456')
-	cipher_text = encryption_suite.encrypt("A really secret message. Not for prying eyes.")
-
-	# Decryption
-	decryption_suite = AES.new('This is a key123', AES.MODE_CBC, 'This is an IV456')
-	plain_text = decryption_suite.decrypt(cipher_text)
+.. code-block:: python3
+
+	import gpg
+	
+	# Encryption to public key specified in rkey.
+	a_key = input("Enter the fingerprint or key ID to encrypt to: ")
+	filename = input("Enter the filename to encrypt: ")
+	with open(filename, "rb") as afile:
+	    text = afile.read()
+	c = gpg.core.Context(armor=True)
+	rkey = list(c.keylist(pattern=a_key, secret=False))
+	ciphertext, result, sign_result = c.encrypt(text, recipients=rkey,
+	                                            always_trust=True,
+						    add_encrypt_to=True)
+	with open("{0}.asc".format(filename), "wb") as bfile:
+	    bfile.write(ciphertext)
+	# Decryption with corresponding secret key
+	# invokes gpg-agent and pinentry.
+	with open("{0}.asc".format(filename), "rb") as cfile:
+	    plaintext, result, verify_result = gpg.Context().decrypt(cfile)
+	with open("new-{0}".format(filename), "wb") as dfile:
+	    dfile.write(plaintext)
+	# Matching the data.
+	# Also running a diff on filename and the new filename should match.
+	if text == plaintext:
+	    print("Hang on ... did you say *all* of GnuPG?  Yep.")
+	else:
+	    pass
diff --git a/docs/scenarios/db.rst b/docs/scenarios/db.rst
index c9281fc..ac79194 100644
--- a/docs/scenarios/db.rst
+++ b/docs/scenarios/db.rst
@@ -1,13 +1,17 @@
+
+#########
 数据库
-=========
+#########
 
 .. image:: https://farm5.staticflickr.com/4225/33907152464_a99fdcc8de_k_d.jpg
 
+
+******
 DB-API
-------
+******
 
 Python数据库API（DB-API）定义了一个Python数据库访问模块的标准接口。它的文档在 :pep:`249` 可以查看。
-几乎所有Python数据库模块，诸如 `sqlite3`， `psycopg` 以及 `mysql-python` 都遵循这个接口。
+几乎所有Python数据库模块，诸如 `sqlite3`、 `psycopg` 以及 `mysql-python` 都遵循这个接口。
 
 
 关于如何与遵守这一接口的模块交互的教程可以在这里找到：
@@ -15,8 +19,10 @@ Python数据库API（DB-API）定义了一个Python数据库访问模块的标
 `这里 <http://web.archive.org/web/20120815130844/http://www.amk.ca/python/writing/DB-API.html>`__ 。
 
 
+
+**********
 SQLAlchemy
-----------
+**********
 
 `SQLAlchemy <http://www.sqlalchemy.org/>`_ 是一个流行的数据库工具。不像很多
 数据库库，它不仅提供一个ORM层，而且还有一个通用API来编写避免SQL的数据库无关代码。
@@ -25,8 +31,10 @@ SQLAlchemy
 
     $ pip install sqlalchemy
 
+
+*******
 Records
--------
+*******
 
 `Records <https://github.com/kennethreitz/records>`_ 是极简SQL库，旨在将原始SQL查询发送到各种数据库。 
 数据可以以编程方式使用，也可以导出到一些有用的数据格式。
@@ -37,44 +45,62 @@ Records
 
 还包括用于导出SQL数据的命令行工具。
 
+
+******
+PugSQL
+******
+
+`PugSQL <https://pugsql.org>`_ 是一个简单的用于组织和使用参数化手写SQL的Python接口，。
+它是一个低保真哲学的反ORM，但仍在Python中提供了一个简洁的接口。
+
+.. code-block:: console
+
+    $ pip install pugsql
+
+
+**********
 Django ORM
-----------
+**********
 
-Django ORM 是 `Django <http://www.djangoproject.com>`_ 用来进行数据库访问的接口。
+Django ORM 是 `Django <https://www.djangoproject.com>`_ 用来进行数据库访问的接口。
 
 它的思想建立在 `models <https://docs.djangoproject.com/en/dev/#the-model-layer>`_ ，
 之上。这是一个致力于简化Python中数据操作的抽象层。
 
 基础：
 
-- 每个model是django.db.models.Model的子类。
-- model的每个属性表示数据库的域（field）。
+- 每个model是django.db.models.Model的子类
+- model的每个属性表示数据库的域（field）
 - Django给您一个自动生成的数据库访问API，参见
-  `Making queries <https://docs.djangoproject.com/en/dev/topics/db/queries/>`__。
+  `Making queries <https://docs.djangoproject.com/en/dev/topics/db/queries/>`__
 
+
+******
 peewee
-------
+******
 
 `peewee <http://docs.peewee-orm.com/en/latest/>`_ 是另一个ORM，它致力于轻量级和支持Python2.6+与3.2+默认支持的
-SQLite，MySQL以及Postgres。 `model layer <https://peewee.readthedocs.io/en/latest/peewee/quickstart.html#model-definition>`_
+SQLite、MySQL以及PostgreSQL。 `model layer <https://peewee.readthedocs.io/en/latest/peewee/quickstart.html#model-definition>`_
 与Django ORM类似并且它拥有 `SQL-like methods <https://peewee.readthedocs.io/en/latest/peewee/quickstart.html#retrieving-data>`_
-来查询数据。除了将SQLite，MySQL以及Postgres变为开箱即用，还有进一步的扩展功能可以在这里找到：
+来查询数据。除了将SQLite、MySQL以及PostgreSQL变为开箱即用，还有进一步的扩展功能可以在这里找到：
 `collection of add-ons <https://peewee.readthedocs.io/en/latest/peewee/playhouse.html#playhouse>`_。
 
+
+*******
 PonyORM
--------
+*******
 
 `PonyORM <http://ponyorm.com/>`_ 是一个ORM，它使用与众不同的方法查询数据库，有别于
 使用类似SQL的语言或者布尔表达式，它使用Python的生成器达到目的。而且还有一个图形化
-schema编辑器生成PonyORM实体。它支持Python2.6+与3.3+并且可以连接SQLite，MySQL，Postgres与Oracle。
-
+schema编辑器生成PonyORM实体。它支持Python2.6+与3.3+并且可以连接SQLite、MySQL、PostgreSQL与Oracle。
 
 
+*********
 SQLObject
----------
+*********
 
 `SQLObject <http://www.sqlobject.org/>`_ 是另一个ORM。它支持广泛的数据库，常见的
-MySQL，Postgres以及SQLite与更多的特别系统如SAP DB，SyBase与MSSQL。它只支持Python 2
+MySQL、PostgreSQL以及SQLite与更多的特别系统如SAP DB、SyBase与MSSQL。它只支持Python 2
 
 
 .. There's no official information on this on their page, this information was gathered by looking at their source code
diff --git a/docs/scenarios/gui.rst b/docs/scenarios/gui.rst
index 4bb37f6..0848a32 100644
--- a/docs/scenarios/gui.rst
+++ b/docs/scenarios/gui.rst
@@ -1,91 +1,146 @@
+
+################
 GUI应用
-================
+################
 
 .. image:: https://farm5.staticflickr.com/4250/33907143624_cd621b535c_k_d.jpg
 
 以下GUI应用按字母顺序排列。
 
+
+*******
 Camelot
--------
-除了Python，SQLAlchemy和Qt之外，`Camelot <http://www.python-camelot.com>`_ 
+*******
+
+除了Python、SQLAlchemy和Qt之外，`Camelot <http://www.python-camelot.com>`_ 
 提供构建应用的组件。它的灵感取决于Django的管理接口。
 
 如下是主要的信息资源网站: http://www.python-camelot.com
-，邮件列表网站： http://groups.google.com/forum/#!forum/project-camelot
+，邮件列表网站： http://groups.google.com/forum/#!forum/project-camelot 。
 
+
+*****
 Cocoa
------
+*****
+
 .. note:: Cocoa框架仅在OS X中可用。如果您正在写一个跨平台的应用，不要选用这个!
 
+
+***
 GTk
----
-PyGTK提供GTK+工具包的Python绑定。和GTK+库一样，PyGTK当前由GNU LGPL授权。
-PyGTK当前只支持Gtk-2.X的API（Gtk-3.0不支持）。值得一提的是，PyGTK不适用于新项目，
-而已经存在的应用不能从PyGTK移植到PyGObject。
+***
+
+.. note:: PyGTK提供GTK+工具包的Python绑定。但是，它已被PyGObject取代。 PyGTK不应该用于新项目，现有项目应该移植到PyGObject。
 
+
+********************
 PyGObject aka (PyGi)
---------------------
+********************
+
 `PyGObject <https://wiki.gnome.org/Projects/PyGObject>`_ 提供了Python绑定，可以访问整个GNOME软件平台。
 它完全兼容GTK+ 3。使用“Python GTK+ 3 教程”（https://python-gtk-3-tutorial.readthedocs.io/en/latest/>`_）
 来开始学习。
 
 `API 参考 <http://lazka.github.io/pgi-docs/>`_
 
+
+****
 Kivy
-----
+****
+
 `Kivy <http://kivy.org>`_ 是一个Python库，该库用于开发多点触控的媒体应用。
 当代码需要重复利用并且可部署时，它能够实现快速简单的交互设计，并且加速成形。
 
 Kivy使用Python编写，并且基于OpenGL，除此，它支持不同的输入设备，
 例如鼠标、双鼠标、WiiMote、WM_TOUCH、HIDtouch和苹果的产品等等。
 
-Kivy由社区积极开发，并且免费使用。它适用于所有主要的平台（Linux，OSX, Windows, Android）
+Kivy由社区积极开发，并且免费使用。它适用于所有主要的平台（Linux，OS X, Windows, Android）
 
 如下是主要的信息资源网站： http://kivy.org
 
+
+******
 PyObjC
-------
+******
+
 .. note:: 仅在OS X中可用。如果您正在写一个跨平台的应用，不要选用这个。
 
+
+******
 PySide
-------
+******
+
 PySide是跨平台的Qt GUI工具包的Python绑定。
+它的包名取决于主要的 Qt 版本（`PySide` 用于 Qt4，`PySide2` 用于 Qt5，`PySide6` 用于 Qt6）。
+这组绑定由 `Qt 公司 <https://qt.io>`_ 开发。
+
+.. code-block:: console
+
+  $ pip install pyside6
 
-  pip install pyside
+https://pyside.org
 
-https://wiki.qt.io/Category:LanguageBindings::PySide::Downloads
 
+****
 PyQt
-----
+****
+
 .. note:: 如果软件不能完全遵循GPL，那么就需要商业许可证。
 
 PyQt提供Qt框架的Python绑定（见如下）
 
 http://www.riverbankcomputing.co.uk/software/pyqt/download
 
-PyjamasDesktop (pyjs Desktop)
------------------------------
-PyjamasDesktop是Pyjamas的端口。PyjamasDesktop是桌面应用工具集，并且是跨平台框架
-（在发布的v0.6版本之后，PyjamasDesktop是Pyjamas (Pyjs)的一部分）。简而言之，
-它允许完全一样的Python网页应用资源代码能够如独立的桌面应用执行。
+
+***************************************
+Pyjs Desktop (formerly Pyjamas Desktop)
+***************************************
+
+Pyjs Desktop 是一个用于桌面和跨平台框架的应用程序小部件集。
+它允许完全相同的 Python Web 应用程序源代码作为独立的桌面应用程序来执行。
 
 `PyjamasDesktop的Python维基百科 <http://wiki.python.org/moin/PyjamasDesktop>`_.
 
-主要的网址: `pyjs Desktop <http://pyjs.org/>`_.
+主要的网址: `pyjs <http://pyjs.org/>`_。
 
+
+**
 Qt
---
+**
+
 `Qt <http://qt-project.org/>`_ 是跨平台应用框架，它被广泛用于借GUI开发软件，但是也可用于非GUI应用。
 
+
+***********
+PySimpleGUI 
+***********
+
+`PySimpleGUI <https://pysimplegui.readthedocs.io/>`_ 是 Tkinter 一层包装。
+使用 PySimpleGUI 实现自定义 GUI 所需的代码量要比使用 Tkinter 直接编写相同的 GUI 要少得多。
+使用 Tkinter 作为底层是因为它与其他 GUI 框架相比，能运行在更多的平台上。
+
+.. code-block:: console 
+
+  $ pip install pysimplegui
+
+PySimpleGUI 完全包含在一个 PySimpleGUI.py 文件中。
+如果 pip 安装不可用，将 PySimpleGUI.py 粘贴到项目文件夹中以便引用，即可。
+
+
+****
 Toga
-----
+****
+
 `Toga <https://toga.readthedocs.io/en/latest/>`_ 是一个原生Python和操作系统的
 跨平台GUI工具包。Toga由一个具有共享接口的基础组件库组成，以简化与平台无关的GUI开发。
 
 Toga适用于Mac OS、Windows、Linux（GTK）以及Android和iOS等移动平台。
 
+
+**
 Tk
---
+**
+
 Tkinter是Tcl/Tk上的面向对象层。 **它的优势是包括Python标准库，能够使编程更加方便，兼容性更强。**
 
 不管是Tk还是Tkinter，在大多数Unix平台，以及Windows和Macintosh系统都可用。
@@ -94,10 +149,13 @@ Tkinter是Tcl/Tk上的面向对象层。 **它的优势是包括Python标准库
 在 `TkDocs <http://www.tkdocs.com/tutorial/index.html>`_ 中有一个非常好的多语言Tk教程，
 所有例子使用Python。更多信息可以看 `Python 维基百科 <http://wiki.python.org/moin/TkInter>`_.
 
+
+********
 wxPython
---------
+********
+
 wxPython是Python语言编写的GUI工具包。Python编写人员能够使简单容易地使用健壮，高功能的图形用户接口编程。
 把流行的wxWidgets包在跨平台GUI库中，从而作为Python的扩展模块，这用C++编写。
 
 **安装（稳定版）wxPython可以去如下网址**
-http://www.wxpython.org/download.php#stable ，并且下载适用于当前操作系统的安装包。
+https://www.wxpython.org/pages/downloads/ ，并且下载适用于当前操作系统的安装包。
diff --git a/docs/scenarios/imaging.rst b/docs/scenarios/imaging.rst
index 4d95946..40ba310 100644
--- a/docs/scenarios/imaging.rst
+++ b/docs/scenarios/imaging.rst
@@ -1,6 +1,6 @@
-==================
+##################
 图像处理
-==================
+##################
 
 .. image:: https://farm5.staticflickr.com/4157/34575689432_3de8e9a348_k_d.jpg
 
@@ -9,14 +9,16 @@ OpenSource Computer Vision (OpenCV)。
 
 下面是这两个库的简略介绍。
 
+
+**********************
 Python 图形库
-----------------------
+**********************
+
+`Python Imaging Library <http://www.pythonware.com/products/pil/>`_ ，或者叫PIL，简略来说，
+是Python图像操作的核心库。不幸的是，它的开发陷入了停滞，最后一次更新是2009年。
 
- `Python Imaging Library <http://www.pythonware.com/products/pil/>`_ ，或者叫PIL，简略来说，
- 是Python图像操作的核心库。不幸的是，它的开发陷入了停滞，最后一次更新是2009年。
- 
- 对您而言幸运的是，存在一个活跃的PIL开发分支，叫做 `Pillow <http://python-pillow.github.io/>`_ 
- 它很容易安装，运行在各个操作系统上，而且支持Python3。
+对您而言幸运的是，存在一个活跃的PIL开发分支，叫做 `Pillow <http://python-pillow.github.io/>`_ 
+它很容易安装，运行在虽有的主流操作系统上，而且支持Python3。
 
 安装
 ~~~~~~~~~~~~
@@ -59,8 +61,9 @@ Python 图形库
 `Pillow 教程 <https://pillow.readthedocs.io/en/3.0.x/handbook/tutorial.html>`_。
 
 
+**************************
 开源计算机视觉（OpenCv）
---------------------------
+**************************
 
 OpenSource Computer Vision,其更广为人知的名字是OpenCv，是一个在图像操作与处理上
 比PIL更先进的库。它可以在很多语言上被执行并被广泛使用。
@@ -84,8 +87,7 @@ NumPy可以从Python Package Index （PyPI）中下载：
 
 .. code-block:: python
 
-    from cv2 import *
-    import numpy as np
+    import cv2
     #读取图像
     img = cv2.imread('testimg.jpg')
     #显示图像
diff --git a/docs/scenarios/json.rst b/docs/scenarios/json.rst
index 59ab161..0edb045 100644
--- a/docs/scenarios/json.rst
+++ b/docs/scenarios/json.rst
@@ -1,13 +1,17 @@
+
+####
 JSON
-====
+####
 
 .. image:: https://farm5.staticflickr.com/4174/33928819683_97b5c6a184_k_d.jpg
 
-`json <https://docs.python.org/2/library/json.html>`_ 库可以自字符串或文件中解析JSON。
+`json <https://docs.python.org/3/library/json.html>`_ 库可以自字符串或文件中解析JSON。
 该库解析JSON后将其转为Python字典或者列表。它也可以转换Python字典或列表为JSON字符串。
 
+
+************
 解析JSON
-------------
+************
 
 创建下面包含JSON数据的字符串
 
@@ -41,20 +45,3 @@ JSON
 
     print(json.dumps(d))
     '{"first_name": "Guido", "last_name": "Rossum", "titles": ["BDFL", "Developer"]}'
-
-
-simplejson
-----------
-
-JSON库是Python2.6版中加入的。如果您使用更早版本的Python，
-可以通过PyPI获取 `simplejson <https://simplejson.readthedocs.io/en/latest/>`_ 库。
-
-simplejson类似json标准库，它使得使用老版本Python的开发者们可以使用json库中的最新特性。
-
-如果json库不可用，您可以将simplejson取别名为json来使用：
-
-.. code-block:: python
-    
-    import simplejson as json
-
-在将simplejson当成json导入后，上面的例子会像您在使用标准json库一样正常运行。
\ No newline at end of file
diff --git a/docs/scenarios/ml.rst b/docs/scenarios/ml.rst
index 6a5e78f..e5caf4e 100644
--- a/docs/scenarios/ml.rst
+++ b/docs/scenarios/ml.rst
@@ -1,6 +1,7 @@
-================
+
+################
 机器学习
-================
+################
 
 .. image:: https://farm4.staticflickr.com/3954/34018729885_002ced9b54_k_d.jpg
 
@@ -8,11 +9,13 @@ Python拥有大量的数据分析、统计和机器学习库，使其成为许
 
 一些广泛使用的机器学习和其他数据科学应用程序包被列在下面：
 
-Scipy 栈（Scipy stack）
----------------------------------
 
-Scipy 栈由数据科学所使用的一组核心帮助包组成，用于统计分析和数据可视化。
-由于其庞大的功能和易用性，scripy栈被认为是大多数数据科学应用的必备条件。
+*********************************
+SciPy 栈（SciPy stack）
+*********************************
+
+SciPy 栈由数据科学所使用的一组核心帮助包组成，用于统计分析和数据可视化。
+由于其庞大的功能和易用性，SciPy 栈被认为是大多数数据科学应用的必备条件。
 
 该栈包含以下包（提供文档链接）：
 
@@ -35,8 +38,10 @@ Scipy 栈由数据科学所使用的一组核心帮助包组成，用于统计
 **注意：** `Anaconda <https://www.continuum.io/anaconda-overview>`_ 是高推荐的，
 因为它可以无缝地安装和维护数据科学包。
 
+
+************
 scikit-learn
-------------
+************
 
 Scikit是一个用于Python的免费开源机器学习库。 它提供了现成的功能来实现诸如线性回归、
 分类器、SVM、k-均值和神经网络等多种算法。它还有一些可直接用于训练和测试的样本数据集。
diff --git a/docs/scenarios/network.rst b/docs/scenarios/network.rst
index c29c33b..f578c20 100644
--- a/docs/scenarios/network.rst
+++ b/docs/scenarios/network.rst
@@ -1,20 +1,25 @@
+
+##########
 网络
-==========
+##########
+
+.. image:: /_static/photos/34151833832_6bdfd930af_k_d.jpg
 
-.. image:: https://farm3.staticflickr.com/2892/34151833832_6bdfd930af_k_d.jpg
 
+*******
 Twisted
--------
+*******
 
-`Twisted <http://twistedmatrix.com/trac/>`_ 是一款基于事件驱动的网络引擎框架。
-支持创建基于不同网络协议的应用，包括 http 服务器与客户端，SMTP 应用，POP3，IMAP
-或 SSH 协议，即时通讯 `等等 <http://twistedmatrix.com/trac/wiki/Documentation>`_。
+`Twisted <https://twistedmatrix.com/trac/>`_ 是一款基于事件驱动的网络引擎框架。
+支持创建基于不同网络协议的应用，包括 HTTP 服务器与客户端、SMTP 应用、POP3、IMAP
+或 SSH 协议，即时通讯 `等等 <https://twistedmatrix.com/trac/wiki/Documentation>`_。
 
 
+*****
 PyZMQ
------
+*****
 
-`PyZMQ <http://zeromq.github.com/pyzmq/>`_ 是 `ZeroMQ <http://www.zeromq.org/>`_
+`PyZMQ <https://zeromq.github.com/pyzmq/>`_ 是 `ZeroMQ <http://www.zeromq.org/>`_
 的 Python捆绑库 (binding)，ZeroMQ 是一款高效率的异步消息库，它的一个显著优点就是能
 被用做消息队列且不需要消息代理。基本模式包括：
 
@@ -27,8 +32,10 @@ PyZMQ
 
 想要快速入门，阅读 `ZeroMQ 指南 <http://zguide.zeromq.org/page:all>`_.
 
+
+******
 gevent
-------
+******
 
 `gevent <http://www.gevent.org/>`_ 是一款基于协程的Python 网络库，它使用 greenlets
 提供在 libev 事件循环之上的高层次异步API。
\ No newline at end of file
diff --git a/docs/scenarios/scientific.rst b/docs/scenarios/scientific.rst
index 376a694..5b419ec 100644
--- a/docs/scenarios/scientific.rst
+++ b/docs/scenarios/scientific.rst
@@ -1,11 +1,14 @@
-=======================
+
+#######################
 科学应用
-=======================
+#######################
+
+.. image:: /_static/photos/33925223870_97e44f5629_k_d.jpg
 
-.. image:: https://farm3.staticflickr.com/2890/33925223870_97e44f5629_k_d.jpg
 
+*******
 背景
-:::::::
+*******
 
 
 Python被经常使用在高性能科学应用中。它之所以在学术和科研项目中得到
@@ -13,17 +16,18 @@ Python被经常使用在高性能科学应用中。它之所以在学术和科
 
 
 由于科学计算对高性能的要求，Python中相关操作经常借用外部库，通常是
-以更快的语言（如C，或者FORTRAN来进行矩阵操作）写的。其主要的库有 `Numpy`_,
-`Scipy`_ 以及 `Matplotlib`_。关于这些库的细节超出了本指南的范围。不过，
+以更快的语言（如C，或者Fortran来进行矩阵操作）写的。其主要的库有 `Numpy`_,
+`SciPy`_ 以及 `Matplotlib`_。关于这些库的细节超出了本指南的范围。不过，
 关于Python的科学计算生态的综合介绍可以在这里找到
 `Python Scientific Lecture Notes <http://scipy-lectures.github.com/>`_。
 
 
+*****
 工具
-:::::
+*****
 
 IPython
--------
+~~~~~~~
 
 
 `IPython <http://ipython.org/>`_ 是一个加强版Python解释器，它提供了科学工作者
@@ -35,13 +39,14 @@ python 笔记本。这个笔记本允许您保存一些代码块，伴随着它
 注释（HTML,LaTex,Markdown）。这个笔记本可以被共享并以各种文件格式导出。
 
 
+*****
 库
-:::::::::
+*****
 
 NumPy
------
+~~~~~
 
-`NumPy <http://numpy.scipy.org/>`_ 是一个用C和FORTRAN写的底层库，它提供一些高层
+`NumPy <http://numpy.scipy.org/>`_ 是一个用C和Fortran写的底层库，它提供一些高层
 数学函数。NumPy通过多维数组和操作这些数组的函数巧妙地解决了Python运行算法较慢的问题。
 任何算法只要被写成数组中的函数，就可以运行得很快。
 
@@ -51,21 +56,21 @@ NumPy是SciPy项目中的一部分，它被发布为一个独立的库，这样
 NumPy兼容Python 2.4-2.7.2以及3.1+。
 
 Numba
------
+~~~~~
 
 `Numba <http://numba.pydata.org>`_ 是一个针对NumPy的Python编译器（即时编译器,JIT）
 它通过特殊的装饰器，将标注过的Python（以及NumPy）代码编译到LLVM（Low Level Virtual Machine，底层虚拟机）中。简单地说，Python使用一种机制，用LLVM将Python代码编译为
 能够在运行时执行的本地代码。
 
 SciPy
------
+~~~~~
 
 `SciPy <http://scipy.org/>`_ 是基于NumPy并提供了更多的数学函数的库。
 SciPy使用NumPy数组作为基本数据结构，并提供完成各种常见科学编程任务的模块，
 包括线性代数，积分（微积分），常微分方程求解以及信号过程。
 
 Matplotlib
-----------
+~~~~~~~~~~
 
 `Matplotlib <http://matplotlib.sourceforge.net/>`_ 是一个可以灵活绘图的库，它
 能够创建2D、3D交互式图形，并能保存成具有稿件质量（manuscript-quality）的图表。
@@ -73,52 +78,60 @@ Matplotlib
 很容易转移到Python。在 `matplotlib gallery <http://matplotlib.sourceforge.net/gallery.html>`_ 中可以找到很多例子以及实现它们的源代码（可以在此基础上再创造）。
 
 Pandas
-------
+~~~~~~
 
 `Pandas <http://pandas.pydata.org/>`_ 是一个基于NumPy的数据处理库，它提供了
 许多有用的函数能轻松地对数据进行访问、索引、合并以及归类。其主要数据结构（DataFrame）
 与R统计学包十分相近；也就是，使用名称索引的异构数据（heterogeneous data）表、时间序列操作以及对数据的自动对准（auto-alignment）。
 
+xarray
+~~~~~~
+
+`xarray <http://xarray.pydata.org/en/stable/>`_ 和 Pandas 类似，但是为包装多维科学数据而生。
+通过给数据标记维度、坐标和属性使得多维操作变得更加清晰和直观。它还包装了matplotlib以快速绘图，还可以通过 
+`dask <http://xarray.pydata.org/en/stable/dask.html>`_ 来并行地进行大多数的操作。
+
 Rpy2
-----
+~~~~
 
 `Rpy2 <http://rpy2.bitbucket.org>`_ 是一个对R统计学包的Python绑定，
 它能够让Python执行R函数，并在两个环境中交换数据。Rpy2是
 对 `Rpy <http://rpy.sourceforge.net/rpy.html>`_ 绑定的面向对象实现。
 
 PsychoPy
---------
+~~~~~~~~
 
 `PsychoPy <http://www.psychopy.org/>`_ 是面向认知科学家的库，它允许创建
 认知心理学和神经科学实验（译者注：指的是那种您坐在电脑前，给您一个刺激测
 您反应的实验，基本上就是个UI）。这个库能够处理刺激表示、实验设计脚本以及
 数据收集。
 
+
+*********
 资源
-:::::::::
+*********
 
 安装这些科学计算Python包可能会有些麻烦，因为它们中很多是用Python的C扩展实现的，
 这就意味着需要编译。这一节列举了各种科学计算Python发行版，它们提供了预编译编译
 且易于安装的科学计算Python包。
 
 Python扩展包的非官方Windows二进制文件（库）
----------------------------------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 很多人在Windows平台上做科学计算，然而众所周知的是，其中很多科学计算包在该平台上
 难以构建和安装。不过， `Christoph Gohlke <http://www.lfd.uci.edu/~gohlke/pythonlibs/>`_ 将一系列有用的Python包编译成了Windows的二进制文件，其数量还在不断增长。如果您在
 Windows上工作，您也许想要看看。
 
 Anaconda
---------
+~~~~~~~~
 
-`Continuum Analytics <http://continuum.io/>`_ 提供了
-`Anaconda Python Distribution <https://store.continuum.io/cshop/anaconda>`_，它
-拥有所有常见的Python科学包，也包括与数据分析和大数据相关的包。Anaconda是免费的
-而Continuum销售一些专有的额外组件。学术研究者可以获取这些组件的免费许可。
+`Anaconda Python 发行版 <https://store.continuum.io/cshop/anaconda>`_
+包含所有常见的Python科学包，也包括与数据分析和大数据相关的包。Anaconda是免费的
+也有一些收费的个人插件。学术研究者可以获取这些插件的免费许可。
 
 Canopy
-------
+~~~~~~
 
-`Canopy <https://www.enthought.com/products/canopy/>`_ 是另一个Python科学发布版，由
+`Canopy <https://www.enthought.com/product/canopy/>`_ 是另一个Python科学发布版，由
 `Enthought <https://www.enthought.com/>`_ 提供。其受限制的 'Canopy Express' 版本
 是免费提供的，但是Enthought负责完整版。学术研究者可以获取到免费许可。
diff --git a/docs/scenarios/scrape.rst b/docs/scenarios/scrape.rst
index 73bc366..15b322a 100644
--- a/docs/scenarios/scrape.rst
+++ b/docs/scenarios/scrape.rst
@@ -1,23 +1,29 @@
+
+#############
 HTML 抓取
-=============
+#############
+
+.. image:: /_static/photos/34268661876_442428e122_k_d.jpg
 
-.. image:: https://farm3.staticflickr.com/2900/34268661876_442428e122_k_d.jpg
 
+************
 Web抓取
-------------
+************
 
 Web站点使用HTML描述，这意味着每个web页面是一个结构化的文档。有时从中
 获取数据同时保持它的结构是有用的。web站点不总是以容易处理的格式，
-如 ``csv`` 或者 ``json`` 提供它们的数据。
+如 CSV 或者 JSON 提供它们的数据。
 
 这正是web抓取出场的时机。Web抓取是使用计算机程序将web页面数据进行收集
 并整理成所需格式,同时保存其结构的实践。
 
+
+*****************
 lxml和Requests
------------------
+*****************
 
 `lxml <http://lxml.de/>`_ 是一个优美的扩展库，用来快速解析XML以及HTML文档
-即使所处理的标签非常混乱。我们也将使用 `Requests <http://docs.python-requests.org/en/latest/>`_ 
+即使所处理的标签非常混乱。我们也将使用 `Requests <https://requests.readthedocs.io/en/latest/>`_
 模块取代内建的urllib2模块，因为其速度更快而且可读性更好。您可以通过使用
 ``pip install lxml`` 与 ``pip install requests`` 命令来安装这两个模块。
 
@@ -68,8 +74,8 @@ XPath是一种在结构化文档（如HTML或XML）中定位信息的方式。
 
 .. code-block:: python
 
-    print 'Buyers: ', buyers
-    print 'Prices: ', prices
+    print('Buyers: ', buyers)
+    print('Prices: ', prices)
 
 ::
 
@@ -90,6 +96,3 @@ XPath是一种在结构化文档（如HTML或XML）中定位信息的方式。
 
 我们可以考虑一些更酷的想法：修改这个脚本来遍历该例数据集中剩余的页面，或者
 使用多线程重写这个应用从而提升它的速度。
-
-如果您想学习如何使用python导入数据 - 这个 `DataCamp 数据导入课程 <https://www.datacamp.com/courses/importing-data-in-r-part-1?tap_a=5644-dce66f&tap_s= 116411-750171>`_
-是个开始的好地方。
diff --git a/docs/scenarios/serialization.rst b/docs/scenarios/serialization.rst
index 0802115..fb48cf5 100644
--- a/docs/scenarios/serialization.rst
+++ b/docs/scenarios/serialization.rst
@@ -1,38 +1,223 @@
-==================
+
+##################
 数据序列化
-==================
+##################
 
-.. image:: https://farm3.staticflickr.com/2927/33467946364_3e59bd376a_k_d.jpg
+.. image:: /_static/photos/33467946364_3e59bd376a_k_d.jpg
 
+
+***************************
 什么是数据序列化？
----------------------------
+***************************
+
+数据序列化是指将结构化数据转换成允许以共享或存储的格式，并能恢复成原始结构。
+在某些情况下，数据序列化的第二个目的是减少数据大小，从而减小对磁盘和带宽的要求。
+
+********************
+Flat vs. Nested data
+********************
+
+在开始序列化数据之前，确定或决定在数据序列化期间如何结构化数据（扁平或嵌套）是非常重要的。
+以下示例中显示了两种风格的差异。
+
+扁平风格:
+
+.. code-block:: python
+
+    { "Type" : "A", "field1": "value1", "field2": "value2", "field3": "value3" }
+
+
+嵌套风格:
+
+.. code-block:: python
+
+    {"A"
+        { "field1": "value1", "field2": "value2", "field3": "value3" } }
+
+阅读两种风格的更多内容，请见如下讨论：
+`Python mailing list <https://mail.python.org/pipermail/python-list/2010-October/590762.html>`__,
+`IETF mailing list <https://www.ietf.org/mail-archive/web/json/current/msg03739.html>`__ and
+`in stackexchange <https://softwareengineering.stackexchange.com/questions/350623/flat-or-nested-json-for-hierarchal-data>`__.
+
+****************
+序列化文本
+****************
+
+=======================
+简单文件（扁平数据）
+=======================
+
+如果要序列化的数据位于文件中，并包含扁平数据，则Python提供了两种序列化数据的方法。
+
+repr
+----
+
+Python 中的 repr 方法接收单个对象参数，返回输入的可打印形式：
+
+.. code-block:: python
+
+    # 扁平文本作为输入
+    a =  { "Type" : "A", "field1": "value1", "field2": "value2", "field3": "value3" }
+
+    # 相同的输入可以读取自文件
+    a = open('/tmp/file.py', 'r')
+
+    # 返回输入的可打印形式
+    # 输出也能够写入文件
+    print(repr(a))
+
+    # 使用repr将内容写入文件
+    with open('/tmp/file.py') as f:f.write(repr(a))
+
+
+ast.literal_eval
+----------------
+
+literal_eval 方法安全地解析Python数据类型表达式并求值。其支持的数据类型有：字符串、数字、元组、列表、字典、布尔和None。
+
+.. code-block:: python
+
+    with open('/tmp/file.py', 'r') as f: inp = ast.literal_eval(f.read())
+
+====================
+CSV 文件 (扁平数据)
+====================
+
+Python 中的 CSV 模块实现了读取和写入CSV形式的表格数据的类。
+
+读取的简单例子：
+
+.. code-block:: python
+
+        # 从文件中读取CSV数据
+        import csv
+        with open('/tmp/file.csv', newline='') as f:
+            reader = csv.reader(f)
+            for row in reader:
+                print(row)
 
-数据序列化是将结构化数据转换成允许以共享或存储的格式，可恢复其原始结构的概念。
-在某些情况下，数据序列化的第二个目的是将要序列化数据的大小最小化，从而使磁盘空间
-或带宽要求最小化。
+写入的简单例子：
 
-Pickle
-------
+.. code-block:: python
+
+        # 将CSV数据写入文件
+        import csv
+        with open('/temp/file.csv', 'w', newline='') as f:
+            writer = csv.writer(f)
+            writer.writerows(iterable)
+
+
+该模块的内容、函数和例子可以在
+`Python 文档中 <https://docs.python.org/3/library/csv.html>`__ 查阅。
+
+==================
+YAML (嵌套数据)
+==================
+
+Python 中有许多第三方库用来解析和读取/写入 YAML 文件，例子如下：
+
+.. code-block:: python
+
+        # 使用load方法从文件中读取 YAML 内容
+        import yaml
+        with open('/tmp/file.yaml', 'r', newline='') as f:
+            try:
+                print(yaml.load(f))
+            except yaml.YAMLError as ymlexcp:
+                print(ymlexcp)
+
+第三方库的文档可以在
+`PyYAML 文档 <https://pyyaml.org/wiki/PyYAMLDocumentation>`__ 中查阅。
+
+=======================
+JSON 文件 (嵌套数据)
+=======================
+
+Python 的 JSON 模块可以用来读取和写入 JSON 模块。示例如下：
+
+读取：
+
+.. code-block:: python
+
+        # 从文件中读取 JSON 内容
+        import json
+        with open('/tmp/file.json', 'r') as f:
+            data = json.load(f)
+
+写入：
+
+.. code-block:: python
+
+        # 使用 dump 方法将 JSON 内容写入文件
+        import json
+        with open('/tmp/file.json', 'w') as f:
+            json.dump(data, f, sort_keys=True)
+
+=================
+XML (嵌套数据)
+=================
+
+Python 中 XML 的解析可以使用 `xml` 库。
+
+示例：
+
+.. code-block:: python
+
+        # 从文件中读取 XML 内容
+        import xml.etree.ElementTree as ET
+        tree = ET.parse('country_data.xml')
+        root = tree.getroot()
+
+使用 `xml.dom` 和 `xml.sax` 包的更多文档可以在
+`Python XML 库文档 <https://docs.python.org/3/library/xml.html>`__ 中找到。
+
+*******
+二进制
+*******
+
+=======================
+NumPy Array (扁平数据)
+=======================
+
+Python 的 NumPy 数组可以将数据序列化成字节形式，或从字节形式的数据反序列化。
+
+示例：
+
+.. code-block:: python
+
+    import NumPy as np
+
+    # 将 NumPy 数组转换为字节形式
+    byte_output = np.array([ [1, 2, 3], [4, 5, 6], [7, 8, 9] ]).tobytes()
+
+    # 将字节形式转换回 NumPy 数组
+    array_format = np.frombuffer(byte_output)
+
+=======================
+Pickle (扁平数据)
+=======================
 
 Python原生的数据序列化模块称为 `Pickle <https://docs.python.org/2/library/pickle.html>`_ 。
 
-例子如下：
+示例：
 
 .. code-block:: python
        
-        import pickle
-        
-        #Here's an example dict
-        grades = { 'Alice': 89, 'Bob': 72, 'Charles': 87 }
+    import pickle
+    
+    # 示例字典
+    grades = { 'Alice': 89, 'Bob': 72, 'Charles': 87 }
       
-        #Use dumps to convert the object to a serialized string
-        serial_grades = pickle.dumps( grades )
+    # 使用 dumps 将对象转换为序列化字符串
+    serial_grades = pickle.dumps( grades )
        
-        #Use loads to de-serialize an object 
-        received_grades = pickle.loads( serial_grades )
+    # 使用 loads 反序列化为对象
+    received_grades = pickle.loads( serial_grades )
+
 
+********
 Protobuf
---------
+********
 
 如果您正在寻找支持多种语言的序列化模块，那么Google的 `Protobuf 
 <https://developers.google.com/protocol-buffers>`_ 库就是一个选择。
diff --git a/docs/scenarios/speed.rst b/docs/scenarios/speed.rst
index 7ffc7b3..7c4ab8e 100644
--- a/docs/scenarios/speed.rst
+++ b/docs/scenarios/speed.rst
@@ -1,7 +1,9 @@
+
+#####
 速度
-=====
+#####
 
-.. image:: https://farm3.staticflickr.com/2826/33175625804_e225b90f3e_k_d.jpg
+.. image:: /_static/photos/33175625804_e225b90f3e_k_d.jpg
 
 CPython作为最流行的Python环境，对于CPU密集型任务（CPU bound tasks）较慢，而 `PyPy`_ 则较快。
 
@@ -33,8 +35,10 @@ CPython作为最流行的Python环境，对于CPU密集型任务（CPU bound tas
    1.54693889618
    1.60109114647
 
+
+*******
 Context
-:::::::
+*******
 
 
 The GIL
@@ -48,22 +52,24 @@ David Beazley 有一个关于GIL如何工作的 `指导`_ 。他也讨论了 Pyt
 它如何影响您的特定程序，您拥有多少核，以及您程序瓶颈在哪。
 
 C 扩展
-------------
+--------------
 
 
 GIL
--------
+---
 
 当写一个C扩展时必须 `特别关注`_  在解释器中注册您的线程。
 
+
+************
 C 扩展
-::::::::::::
+************
 
 
 Cython
 ------
 
-`Cython <http://cython.org/>`_ 是Python语言的一个超集，对其您可以为Python写C
+`Cython <https://cython.org/>`_ 是Python语言的一个超集，对其您可以为Python写C
 或C++模块。Cython也使得您可以从已编译的C库中调用函数。使用Cython让您得以发挥Python
 的变量与操作的强类型优势。
 
@@ -149,25 +155,25 @@ Cython
 .. code-block:: python
 
 	import time
-	#启动pyx编译器
+	# 启动pyx编译器
 	import pyximport
 	pyximport.install()
-	#Cython的素数算法实现
+	# Cython的素数算法实现
 	import primesCy
-	#Python的素数算法实现
+	# Python的素数算法实现
 	import primes
 
-	print "Cython:"
+	print("Cython:")
 	t1= time.time()
-	print primesCy.primes(500)
+	print(primesCy.primes(500))
 	t2= time.time()
-	print "Cython time: %s" %(t2-t1)
-	print ""
-	print "Python"
+	print("Cython time: %s" %(t2-t1))
+	print("")
+	print("Python")
 	t1= time.time()
-	print primes.primes(500)
+	print(primes.primes(500))
 	t2= time.time()
-	print "Python time: %s" %(t2-t1)
+	print("Python time: %s" %(t2-t1))
 
 
 这两行代码需要一些说明：
@@ -209,8 +215,10 @@ Pyrex
 Shedskin?
 ---------
 
-Concurrency
-:::::::::::
+
+***********
+并发
+***********
 
 
 Concurrent.futures
@@ -314,7 +322,7 @@ add_done_callback(fn)
 
 有关使用 `concurrent.futures`_ 模块的更多信息，请参阅官方文档。
 
-Threading
+threading
 ---------
 
 标准库带有一个 `threading`_ 模块，允许用户手动处理多个线程。
@@ -351,7 +359,7 @@ Threading
 
 由于多个线程可以访问相同的内存部分，有时可能会出现两个或多个线程尝试同时写入同一资源的情况，
 或者输出取决于某些事件的顺序或时序。 这被称为 `数据竞争` 或竞争条件。当这种情况发生时，
-输出将会出现乱码，或者可能会遇到难以调试的问题。 `stackoverflow post`_ 是个很好的例子。
+输出将会出现乱码，或者可能会遇到难以调试的问题。 `Stack Overflow post`_ 是个很好的例子。
 
 可以避免的方法是每个线程在写入共享资源之前获取 `Lock`_ 。 锁可以通过环境上下文协议
 （ `with` 语句）或直接使用 `acquire()` 和 `release()` 来获取和释放。
@@ -389,22 +397,22 @@ Threading
 
 
 Spawning Processes
-------------------
+~~~~~~~~~~~~~~~~~~
 
 
 Multiprocessing
----------------
+~~~~~~~~~~~~~~~
 
 
 .. _`PyPy`: http://pypy.org
-.. _`GIL`: http://wiki.python.org/moin/GlobalInterpreterLock
+.. _`GIL`: https://wiki.python.org/moin/GlobalInterpreterLock
 .. _`指导`: http://www.dabeaz.com/python/UnderstandingGIL.pdf
 .. _`新GIL`: http://www.dabeaz.com/python/NewGIL.pdf
-.. _`特别关注`: http://docs.python.org/c-api/init.html#threads
+.. _`特别关注`: https://docs.python.org/c-api/init.html#threads
 .. _`David Beazley的`: http://www.dabeaz.com/GIL/gilvis/measure2.py
 .. _`concurrent.futures`: https://docs.python.org/3/library/concurrent.futures.html
 .. _`Future`: https://docs.python.org/3/library/concurrent.futures.html#concurrent.futures.Future
 .. _`threading`: https://docs.python.org/3/library/threading.html
-.. _`stackoverflow post`: http://stackoverflow.com/questions/26688424/python-threads-are-printing-at-the-same-time-messing-up-the-text-output
+.. _`Stack Overflow post`: https://stackoverflow.com/questions/26688424/python-threads-are-printing-at-the-same-time-messing-up-the-text-output
 .. _`data race`: https://en.wikipedia.org/wiki/Race_condition
 .. _`Lock`: https://docs.python.org/3/library/threading.html#lock-objects
diff --git a/docs/scenarios/web.rst b/docs/scenarios/web.rst
index 65ba7f7..648b3ba 100644
--- a/docs/scenarios/web.rst
+++ b/docs/scenarios/web.rst
@@ -1,16 +1,17 @@
-================
+
+#############################
 Web 应用 & 框架
-================
+#############################
 
-.. image:: https://farm3.staticflickr.com/2891/34309496175_b82d104282_k_d.jpg
+.. image:: /_static/photos/34309496175_b82d104282_k_d.jpg
 
 Python作为一门强大的脚本语言，能够适应快速原型和较大项目的制作，
 它被广泛用于web应用程序的开发中。
 
-Context
-:::::::
-
 
+*******
+Context
+*******
 
 WSGI
 ----
@@ -21,8 +22,9 @@ Web服务网关接口（Web Server Gateway Interface，简称“WSGI”）是一
 :ref:` 符合WSGI的web服务器 <wsgi-servers-ref>` 上。WSGI记录在 :pep:`3333`。
 
 
+*******
 框架
-::::::::::
+*******
 
 广义地说，Web框架包含一系列库和一个主要的处理器（handler），这样您就能够构建自己的代码来实现Web应用
 （比如说一个交互式的网站）。大多数web框架包含模式和工具，至少实现以下功能：
@@ -43,14 +45,15 @@ Web服务器开发（Development Web Server）
 Django
 ------
 
-`Django <http://www.djangoproject.com>`_ 是一个功能齐备的web应用框架。它是创建面向内容网站的极佳选择。
+`Django <https://www.djangoproject.com>`_ 是一个功能齐备的web应用框架。它是创建面向内容网站的极佳选择。
 通过提供众多工具和模式，Django使得快速构建复杂的、有数据库支持的web应用成为可能，
 同时鼓励使用它作为编写代码的最佳实践。
 
-Django拥有非常庞大和活跃的社区。此外，许多预构建的 `可重用模块 <http://djangopackages.com/>`_ 
+Django拥有非常庞大和活跃的社区。此外，许多预构建的 `可重用模块 <https://djangopackages.com/>`_ 
 可以原样合并到新工程中，或者定制成符合需求的样子。
 
-在 `美国 <http://djangocon.us>`_ 和 `欧洲 <http://djangocon.eu>`_ 均有每年度的Django会议。
+在 `美国 <https://djangocon.us>`_ 、 `欧洲 <https://djangocon.eu>`_ 和 
+`Australia <https://djangocon.com.au>`_ 均有每年度的Django会议。
 
 如今大部分新的Python web应用都是用Django构建的。
 
@@ -71,8 +74,20 @@ Flask不会提供一切您可能需要的内容，而是实现了web应用框架
 Flask是任何不适用Django的Python web应用的默认选择。
 
 
+Falcon
+------
+
+当您的目标是构建快速、可扩展的REST风格API微服务时， `Falcon <https://falconframework.org/>`_ 是个不错的选择。
+
+这是一个可靠的、高性能的Python Web框架，用于构建大规模应用后端和微服务。Falcon鼓励REST架构风格的
+URI到资源的映射，以花费尽可能少的精力同时又保持高效。
+
+Falcon重点关注四个方面：速度、可靠性、灵活性和可调试性。它通过"响应者（responder）"
+（诸如 ``on_get()``、 ``on_put()`` 等）来实现HTTP。这些响应者接收直接的请求，以及响应对象。
+
+
 Tornado
---------
+-------
 `Tornado <http://www.tornadoweb.org/>`_ 是一个面向Python的异步web框架，它有自己的事件。
 这就使得它，举个例子，可以原生地支持WebSockets。编写良好的Tornado应用具有卓越的性能特性。
 
@@ -80,17 +95,44 @@ Tornado
 
 
 Pyramid
---------
+-------
 
 `Pyramid <https://trypyramid.com/>`_ 是一个非常灵活的框架，重点关注模块化。 它内置少量库（“电池”），
-并鼓励用户扩展其基本功能。
+并鼓励用户扩展其基本功能。它提供一组cookiecutter模板，帮助用户生成新项目。Pyramid驱动了Python基础架构中
+最重要部分之一—— `PyPI <https://pypi.org/>`_。
 
 Pyramid不像Django和Flask，并没有庞大的用户基数。它一个有能力的框架，但如今新Python web 应用程序
 并没有十分青睐它。
 
+Masonite
+--------
+
+`Masonite <https://docs.masoniteproject.com>`_ 是一个现代的，以开发人员为中心的“功能齐备”的网络框架。
 
+Masonite 框架遵循 MVC（Model-View-Controller，模型-视图-控制器）架构模式，受到 Rails 和 Laravel 等框架的极大启发，
+因此如果您是从 Ruby 或 PHP 背景来到 Python，那么您将感到宾至如归！
+
+Masonite 提供了许多开箱即用的功能，包括一个功能强大的具有自动解析依赖注入IOC容器、craft 命令行工具和 Active Record 模式的 Orator ORM。
+
+Masonite 非常适合初学者或经验丰富的开发人员。从安装到部署都相当快速和容易。只需尝试一次，你就会爱上它。
+
+FastAPI
+-------
+
+`FastAPI <https://fastapi.tiangolo.com>`_ 是一个使用 Python 3.6+ 版本来构建API的现代化 Web 框架。
+
+由于它是基于 `Starlette <https://www.starlette.io>`_ 和 `Pydantic <https://pydantic-docs.helpmanual.io>`_，
+具有非常高的性能。
+
+FastAPI 利用函数参数中标准的 Python 类型声明来声明请求参数和实体、执行数据转换（序列化、分析）、数据验证，
+以及使用 ** OpenAPI 3 **（包括 ** JSON Schema **）自动生成 API 文档。
+
+它包括用于安全性和身份验证的工具和实用程序（包括带有JWT令牌的OAuth2）、依赖注入系统、交互式 API 文档生成器以及其他功能。
+
+
+***********
 Web 服务端
-:::::::::::
+***********
 
 .. _nginx-ref:
 
@@ -104,8 +146,10 @@ Nginx
 
 .. _wsgi-servers-ref:
 
+
+************
 WSGI 服务器
-::::::::::::
+************
 
 独立WSGI服务器相比传统web服务器，使用更少的资源，并提供最高的性能 [1]_。
 
@@ -114,7 +158,7 @@ WSGI 服务器
 Gunicorn
 --------
 
-`Gunicorn <http://gunicorn.org/>`_ （Green Unicorn，绿色独角兽）是一个纯Python WSGI服务器，
+`Gunicorn <https://gunicorn.org/>`_ （Green Unicorn，绿色独角兽）是一个纯Python WSGI服务器，
 用来支持Python应用。不像其他Python web服务器，它有周全的用户界面，十分易于使用和配置。
 
 Gunicorn具有合理的默认配置。 然而，其他一些像uWSGI这样的服务器相较而言过于可定制化，因此更加难以高效使用。
@@ -147,16 +191,18 @@ uWSGI既能当作独立的web路由器来运行，也能运行在一个完整web
 .. _server-best-practices-ref:
 
 
+*********************
 服务端最佳实践
-:::::::::::::::::::::
+*********************
 
 如今，自承载Python应用的主体托管于WSGI服务器（比如说 :ref:`Gunicorn <gunicorn-ref>`）
 或是直接或间接在轻量级web服务器（比如说 :ref:`nginx <nginx-ref>`）之后。
 
 WSGI服务器为Python应用服务，它能更好的处理诸如静态文件服务、请求路由、DDoS保护和基本认证的任务。
 
+*******
 Hosting
-:::::::
+*******
 
 平台即服务（Platform-as-a-Service，PaaS）是一种云计算基础设施类型，抽象和管理基础设施、路由和网络应用的扩展。
 使用PaaS时，应用开发者只需关注编写应用代码，而无须关心配置细节。
@@ -164,27 +210,21 @@ Hosting
 Heroku
 ------
 
-`Heroku <http://www.heroku.com/python>`_ 为Python 2.7-3.5 应用程序提供一流的支持。
+`Heroku <https://www.heroku.com/python>`_ 为Python 2.7-3.5 应用程序提供一流的支持。
 
 Heroku 支持所有类型的Python web应用、服务器和框架。在Heroku上可以免费开发应用程序。
  一旦您的应用程序准备好面向生产环境，您可以升级到Hobby或专业应用。
 
-Heroku 维护了使用Python和Heroku交互的 `详细文章 <https://devcenter.heroku.com/categories/python>`_，
+Heroku 维护了使用Python和Heroku交互的 `详细文章 <https://devcenter.heroku.com/categories/python-support>`_，
 同时也有 `手把手指导 <https://devcenter.heroku.com/articles/getting-started-with-python>`_ 
 来告诉您如何建立第一个应用。
 
 Heroku是如今部署Python Web应用程序的推荐PaaS。
 
-Eldarion
---------
-
-`Eldarion <http://eldarion.cloud/>`_（被称为Gondor）是由Kubernetes、CoreOS和Docker提供的PaaS。
-它们支持任一WSGI应用程序，并提供了部署 
-`Django项目 <https://eldarion-gondor.github.io/docs/how-to/setup-deploy-first-django-project/>`_ 的指南。
-
 
+**********
 模板
-::::::::::
+**********
 
 多数WSGI应用响应HTTP请求，从而服务于HTML或其他标记语言中的内容。关注点分离的概念建议我们使用模板，
 而不是直接由Python生成文本内容。模板引擎管理一系列的模板文件，其系统的层次性和包容性避免了不必要的重复。
@@ -213,7 +253,7 @@ Jinja2
 它使用基于文本的模板语言，因此可以用于生成任何类型的标记，而不仅仅是HTML。 
 它允许自定义过滤器，标签，测试和全局变量。 它具有Django模板系统的许多改进。
 
-这里有一些在Jinja2中重要的html标签：
+这里有一些在Jinja2中重要的HTML标签：
 
 .. code-block:: html
 
@@ -323,12 +363,12 @@ Jinja2是新Python Web应用程序的推荐模板库。
 Chameleon
 ---------
 `Chameleon <https://chameleon.readthedocs.io/>`_ 页面模板是使用 
-`模板属性语言（Template Attribute Language, TAL） <https://en.wikipedia.io/wiki/Template_Attribute_Language>`_、 
+`模板属性语言（Template Attribute Language, TAL） <https://en.wikipedia.org/wiki/Template_Attribute_Language>`_、 
 `TAL表达语法（TAL Expression Syntax,TALES） <https://chameleon.readthedocs.io/en/latest/reference.html#expressions-tales>`_ 和 
 `宏扩展TAL（Macro Expansion TAL, Metal） <https://chameleon.readthedocs.io/en/latest/reference.html#macros-metal>`_ 
 语法的HTML/XML模板引擎实现。
 
-Chameleon在Python2.5及以上版本（包括3.x和pypy）都是可用的，并常被 `Pyramid Framework <http://trypyramid.com>`_ 使用。
+Chameleon在Python2.5及以上版本（包括3.x和PyPy）都是可用的，并常被 `Pyramid Framework <https://trypyramid.com>`_ 使用。
 
 页面模板是在文档结构中添加特定元素属性和文本标记。使用一系列简单语言概念，您能够控制文档流程、元素重复、文本替换和翻译。
 由于使用了基于属性的语法，未渲染的页面模板是合法的HTML，它可以在浏览器中查看，甚至能够在WYSIWYG编辑器中编辑。
@@ -416,4 +456,6 @@ Mako在Python web社区中受到重视。
 
 .. rubric:: References
 
-.. [1] `Benchmark of Python WSGI Servers <http://nichol.as/benchmark-of-python-web-servers>`_
+.. [1] `mod_python 项目现在正式终结 <http://blog.dscpl.com.au/2010/06/modpython-project-is-now-officially.html>`_
+.. [2] `mod_wsgi vs mod_python <http://modpython.org/pipermail/mod_python/2007-July/024080.html>`_
+.. [3] `Python WSGI 服务器基准测试 <http://nichol.as/benchmark-of-python-web-servers>`_
diff --git a/docs/scenarios/xml.rst b/docs/scenarios/xml.rst
index 3fff126..e10d75d 100644
--- a/docs/scenarios/xml.rst
+++ b/docs/scenarios/xml.rst
@@ -1,10 +1,13 @@
+
+###########
 XML解析
-===========
+###########
 
-.. image:: https://farm3.staticflickr.com/2808/33888714601_a1f7d020a2_k_d.jpg
+.. image:: /_static/photos/33888714601_a1f7d020a2_k_d.jpg
 
+********
 untangle
---------
+********
 
 `untangle <https://github.com/stchris/untangle>`_ 库可以将XML文档映射为一个Python
 对象，该对象于其结构中包含了原文档的节点与属性信息。
@@ -34,10 +37,11 @@ untangle
 
 untangle也支持从字符串或URL中载入XML。
 
+*********
 xmltodict
----------
+*********
 
-`xmltodict <http://github.com/martinblech/xmltodict>`_ 是另一个简易的库，
+`xmltodict <https://github.com/martinblech/xmltodict>`_ 是另一个简易的库，
 它致力于将XML变得像JSON。
 
 对于一个像这样的XML文件：
@@ -74,3 +78,30 @@ xmltodict
 
 xmltodict 也有unparse函数让您可以转回XML。该函数有一个streaming模式适合用来
 处理不能放入内存的文件，它还支持命名空间。
+
+**********
+xmlschema
+**********
+
+`xmlschema <https://github.com/sissaschool/xmlschema>`_ 提供了在Python中使用XSD模式的支持。
+与其他XML库不同，它提供了自动类型解析功能。因此，例如，如果模式定义一个元素为 ``int`` 类型，解析后的 ``dict`` 也将包含该元素的 ``int`` 值。
+此外，该库支持自动和显式验证XML文档是否符合模式。
+
+.. code-block:: python
+
+    from xmlschema import XMLSchema, etree_tostring
+
+    # 加载XSD模式文件
+    schema = XMLSchema("your_schema.xsd")
+
+    # 验证是否符合模式
+    schema.validate("your_file.xml")
+
+    # 或者
+    schema.is_valid("your_file.xml")
+
+    # 解码文件
+    data = schmema.decode("your_file.xml")
+
+    # 编码为字符串
+    s = etree_tostring(schema.encode(data))
diff --git a/docs/shipping/freezing.rst b/docs/shipping/freezing.rst
index 2d76476..91c106a 100644
--- a/docs/shipping/freezing.rst
+++ b/docs/shipping/freezing.rst
@@ -1,8 +1,9 @@
 .. _freezing-your-code-ref:
 
-==============================
+
+##############################
 冻结（freezing）您的代码
-==============================
+##############################
 
 .. image:: https://farm5.staticflickr.com/4227/33907151034_e0a9e53402_k_d.jpg
 
@@ -18,8 +19,10 @@
 冻结的一个缺点是它会增加大约2-12MB的发行大小。另外，如果修补了Python的安全漏洞，
 您将负责分发更新版本的应用程序。
 
+
+************************
 冻结的多种方式
-------------------------
+************************
 
 :ref:`打包您的代码<packaging-your-code-ref>` 是指把您的库或工具分发给其他开发者。
 
@@ -29,33 +32,37 @@
 .. todo:: 完善 "冻结您的代码" 部分（stub）。
 
 
+************************
 比较冻结工具
-----------------------
+************************
+
+写于2019年10月5日
 
 各解决方案的平台/特性支持性
 
-=========== ======= ===== ==== ======== ======= ============= ============== ==== =====================
-Solution    Windows Linux OS X Python 3 License One-file mode Zipfile import Eggs pkg_resources support
-=========== ======= ===== ==== ======== ======= ============= ============== ==== =====================
-bbFreeze    yes     yes   yes  no       MIT     no            yes            yes  yes
-py2exe      yes     no    no   yes      MIT     yes           yes            no   no
-pyInstaller yes     yes   yes  yes      GPL     yes           no             yes  no
-cx_Freeze   yes     yes   yes  yes      PSF     no            yes            yes  no
-py2app      no      no    yes  yes      MIT     no            yes            yes  yes
-=========== ======= ===== ==== ======== ======= ============= ============== ==== =====================
+=========== ======= ===== ==== ======== ======= ============= ============== ==== ===================== =====================
+Solution    Windows Linux OS X Python 3 License One-file mode Zipfile import Eggs pkg_resources support Latest release date
+=========== ======= ===== ==== ======== ======= ============= ============== ==== ===================== =====================
+bbFreeze    yes     yes   yes  no       MIT     no            yes            yes  yes                   Jan 20, 2014
+py2exe      yes     no    no   yes      MIT     yes           yes            no   no                    Oct 21, 2014
+pyInstaller yes     yes   yes  yes      GPL     yes           no             yes  no                    Jul 9, 2019
+cx_Freeze   yes     yes   yes  yes      PSF     no            yes            yes  no                    Aug 29, 2019
+py2app      no      no    yes  yes      MIT     no            yes            yes  yes                   Mar 25, 2019
+=========== ======= ===== ==== ======== ======= ============= ============== ==== ===================== =====================
 
     
 .. note::
     从Linux到Windows的冻结只有PyInstaller支持，
-    `其余的 <http://stackoverflow.com/questions/2950971/cross-compiling-a-python-script-on-linux-into-a-windows-executable#comment11890276_2951046>`_。
+    `其余的 <https://stackoverflow.com/questions/2950971/cross-compiling-a-python-script-on-linux-into-a-windows-executable#comment11890276_2951046>`_。
 
 .. note::
-    所有解决方案需要目前机器上安装了MS Visual C++ dll。除了py2app以外。
-    只有Pyinstaller创建了可以自足运行的exe文件，其绑定了dll，可以传递 ``--onefile`` 到
-    :file:`Configure.py`。
+    所有解决方案，除了py2app以外，需要在目标机器上安装了Microsoft Visual C++ dll。
+    只有PyInstaller可通过传递 ``--onefile`` 到 :file:`Configure.py` 中，
+    创建绑定了合适dll、可以自运行的exe文件。
 
+*******
 Windows
--------
+*******
 
 bbFreeze
 ~~~~~~~~
@@ -108,7 +115,7 @@ py2exe
 ~~~~~~
 
     
-前置要求是安装了 :ref:`Python on Windows <install-windows>`。
+前置要求是安装了 :ref:`Python on Windows <install-windows>`。py2exe 的最后一个版本是从2014年开始的，且没有处于积极的开发中。
 
 1. 下载并且安装 http://sourceforge.net/projects/py2exe/files/py2exe/
 
@@ -126,7 +133,7 @@ py2exe
 
 3. (可选) `包含图标 <http://www.py2exe.org/index.cgi/CustomIcons>`_
 
-4. (可选) `单文件模式 <http://stackoverflow.com/questions/112698/py2exe-generate-single-executable-file#113014>`_
+4. (可选) `单文件模式 <https://stackoverflow.com/questions/112698/py2exe-generate-single-executable-file#113014>`_
 
 5. 生成 :file: `.exe` 到 :file:`dist` 目录:
 
@@ -145,8 +152,9 @@ PyInstaller
 - `手册 <https://pyinstaller.readthedocs.io/en/stable/>`_
 
 
+****
 OS X
-----
+****
 
 
 py2app
@@ -209,12 +217,52 @@ PyInstaller可用于在Mac OS X 10.6（Snow Leopard）或更新版本上构建Un
 <http://pythonhosted.org/PyInstaller/spec-files.html#spec-file-options-for-a-mac-os-x-bundle>`_ 。 
 例如，要指定应用程序的图标，请使用 :code:`icon=\path\to\icon.icns` 选项。
 
+*****
 Linux
------
+*****
 
 
 bbFreeze
 ~~~~~~~~
+.. warning:: bbFreeze 仅在 Python 2.x 环境下工作, 根据以前的维护者的说法已不再进行维护。 如果您对此感兴趣请查看 `这里 <https://github.com/schmir/bbfreeze>`_。
+
+bbFreeze可以与所有已安装Python以及pip2和/或easy_install的发行版一起使用。
+
+对于pip2，请按以下内容进行：
+
+.. code-block:: console
+
+  $ pip2 install bbfreeze
+
+而对于 easy_install，则:
+
+.. code-block:: console
+
+  $ easy_install bbfreeze
+
+安装好bbFreeze后，您就可以冻结应用程序了。
+
+假设您有一个脚本，例如“hello.py”和名为“module.py”的模块，并且您在里面使用了一个函数。
+不费吹灰之力，您就可以通过冻结脚本的主要入口来冻结整个内容：
+
+.. code-block:: console
+
+  $ bbfreeze script.py
+
+这样，它就会创建一个名为dist/的文件夹，其中包含脚本的可执行文件以及Python脚本中使用的库所需.so（共享对象）文件。
+
+或者，您可以创建一个用于执行冻结的脚本。 冻结器的API可从以下库中获得：
+
+.. code-block:: python
+
+   from bbfreeze import Freezer
+
+   freezer = Freezer(distdir='dist')
+   freezer.addScript('script.py', gui_only=True) # 为使用GUI包的应用开启参数 gui_only
+   freezer()
 
 PyInstaller
 ~~~~~~~~~~~
+PyInstaller在Linux上的安装方式与在OS X中类似，参见OS X章节中的对应部分。
+
+不要忘记安装如Python和pip等依赖项。
diff --git a/docs/shipping/packaging.rst b/docs/shipping/packaging.rst
index c329934..df825ba 100644
--- a/docs/shipping/packaging.rst
+++ b/docs/shipping/packaging.rst
@@ -1,13 +1,14 @@
 .. _packaging-your-code-ref:
 
-===================
+
+###################
 打包您的代码
-===================
+###################
 
 .. image:: https://farm5.staticflickr.com/4325/36137234682_be6898bf57_k_d.jpg
 
-打包就是把您的代码分享给其他开发者。作为例子，共享一个库给其他开发者用在
-它们的应用中，或者作为一个开发工具，比如 'py.test'。
+打包就是把您的代码分享给其他开发者。例如，共享一个库给其他开发者用在
+他们的应用中，或者作为一个开发工具，比如 'py.test'。
 
 这种分发方式的一个优势是它拥有既已建成的良好的工具生态，如PyPI与pip，其使得其他
 开发者很容易下载与安装您的包，而无论是一个即兴实验还是作为一个巨型软件系统的一部分。
@@ -23,9 +24,9 @@
 提供了更多关于如何创建以及维护Python包的知识。
 
 
-
+*************************
 打包的多种方式
-:::::::::::::::::::::::::
+*************************
 
 为了分发应用给最终用户，您应该
 :ref:`冻结您的应用 <freezing-your-code-ref>`。
@@ -35,20 +36,19 @@
 (例 对于Debian或Ubuntu是一个 .deb文件)
 
 
+*********************
 对于Python开发者
-:::::::::::::::::::::
+*********************
 
-如果您编写了一个开源的Python模块， `PyPI <http://pypi.python.org>`_
-, 更多属性参见 *The Cheeseshop*，这是一个放它的地方。
+如果您编写了一个开源的Python模块， `PyPI <http://pypi.org>`_
+(更准确的叫法是 *The Cheeseshop*)是一个放它的地方。
 
 Pip vs. easy_install
 --------------------
 
-Use `pip <http://pypi.python.org/pypi/pip>`_.  More details
-`here <http://stackoverflow.com/questions/3220404/why-use-pip-over-easy-install>`_
 
-使用 `pip <http://pypi.python.org/pypi/pip>`_. 更多细节参见
-`here <http://stackoverflow.com/questions/3220404/why-use-pip-over-easy-install>`_
+使用 `pip <http://pypi.org/project/pip>`_. 更多细节参见
+`here <https://stackoverflow.com/questions/3220404/why-use-pip-over-easy-install>`_
 
 
 私人的PyPI
@@ -73,10 +73,10 @@ Use `pip <http://pypi.python.org/pypi/pip>`_.  More details
 .. code-block:: console
 
    $ cd archive
-   $ python -m SimpleHTTPServer 9000
+   $ python -m http.server 9000
 
 
-这运行了一个简单的http服务器，其监听端口9000并且将列出所有包（比如 **MyPackage**）。现在
+这运行了一个简单的HTTP服务器，其监听端口9000并且将列出所有包（比如 **MyPackage**）。现在
 您可以使用任何Python包安装器从您的服务器中安装 **MyPackage** 。若使用Pip,您可以这样做：
 
 .. code-block:: console
@@ -96,12 +96,12 @@ Use `pip <http://pypi.python.org/pypi/pip>`_.  More details
 pypiserver
 ++++++++++
 
-`Pypiserver <https://pypi.python.org/pypi/pypiserver>`_ 是一个精简的PyPI兼容服务器。
+`Pypiserver <https://pypi.org/project/pypiserver>`_ 是一个精简的PyPI兼容服务器。
 它可以被用来让一系列包通过easy_install与pip进行共享。它包含一些有益的命令，诸如管理
 命令（ ``-U`` ），其可以自动更新所有它的包到PyPI上的最新版。
 
 
-S3-Hosted PyPi
+S3-Hosted PyPI
 ++++++++++++++
 
 
@@ -137,13 +137,14 @@ Amazon AWS账号并且有 S3 bucket。
 .. _packaging-for-linux-distributions-ref:
 
 
+***********************
 在Linux上分发
-::::::::::::::::::::::::
+***********************
 
 
 创建一个Linux分发包对于Linux来说是个正确的决定。
 
-因为分发包可以不包含Python解释器，它使得下载与安装这些包可以减小2MB，
+因为分发包可以不包含Python解释器，它使得下载与安装这些包可以减小2-12 MB，
 :ref:`freezing your application <freezing-your-code-ref>`.
 
 并且，如果Python有了更新的版本，则您的应用可以自动使用新版本的Python。
@@ -154,9 +155,9 @@ bdist_rpm命令使得 `producing an RPM file <https://docs.python.org/3/distutil
 
  无论如何，创建和维持不同配置要求给不同的发布格式（如 对于Debian/Ubuntu是.deb，而对于Red
  Hat/Fedora是.rpm等）无疑需要大量的工作。如果您的代码是一个应用，而您计划分发到其他平台上，
- 则您需要创建并维护各个配置要求来冻结您的应用为Windows与OSX。它比创建和
+ 则您需要创建并维护各个配置要求来冻结您的应用为Windows与OS X。它比创建和
  维护一个单独的配置给每个平台要简单的多 :ref:`freezing tools <freezing-your-code-ref>`
- 其将产生独立可执行的文件给所有Linux发布版，就像Windows与OSX上一样，
+ 其将产生独立可执行的文件给所有Linux发布版，就像Windows与OS X上一样，
 
 创建一个对Python版本敏感的分发包也会造成问题。可能需要告诉Ubuntu的 *一些版本* 的
 用户他们需要增加 `the 'dead-snakes' PPA <https://launchpad.net/~fkrull/+archive/ubuntu/deadsnakes>`_
@@ -177,4 +178,4 @@ bdist_rpm命令使得 `producing an RPM file <https://docs.python.org/3/distutil
 
 - `fpm <https://github.com/jordansissel/fpm>`_
 - `alien <http://joeyh.name/code/alien/>`_
-- `dh-virtualenv <https://dh-virtualenv.readthedocs.io/en/latest/info.html>`_ (for APT/DEB omnibus packaging)
+- `dh-virtualenv <https://dh-virtualenv.readthedocs.io/>`_ (用于 APT/DEB 综合打包)
diff --git a/docs/shipping/publishing.rst b/docs/shipping/publishing.rst
new file mode 100644
index 0000000..70f31d2
--- /dev/null
+++ b/docs/shipping/publishing.rst
@@ -0,0 +1,61 @@
+.. _publishing-your-code-ref:
+
+
+####################
+发布您的代码
+####################
+
+.. todo:: Replace this kitten with the photo we want.
+
+.. image:: https://placekitten.com/800/600
+
+一个健康的开源项目需要一个地方来发布其代码和项目管理的内容，以便其他开发人员可以与您协作。
+这可以让您的用户更好地了解您的代码，跟上新的开发进度，报告错误以及贡献代码。
+
+此开发网站应包括源代码历史本身，错误跟踪器，补丁提交（也称为“Pull Request”）队列，以及可能的其他面向开发人员的文档。
+
+有几个免费的开源项目托管站点（又名“forges”），如 GitHub，SourceForge，Bitbucket和GitLab。
+GitHub目前是最好的。
+使用GitHub吧。
+
+
+*********************************
+在GitHub上创建项目
+*********************************
+
+要在GitHub上发布您的Python项目：
+
+1. 如果您还没有GitHub帐户，请创建一个帐户
+
+2. 为您的项目创建一个新的仓库
+
+   1. 单击页面右上角的头像旁边的“+”菜单，然后选择“New repository”
+
+   2. 给项目命名，并给它一个SEO友好的描述
+
+   3. 如果您没有现有项目仓库，请选择设置以添加 README、`.gitignore`和许可证。使用Python的 `.gitignore` 选项
+
+3. 在新创建的项目页面上，单击“Manage topics”并根据实际情况添加“python”和“python3”和/或“python2”标签
+
+4. 在项目的README中包含指向您的新GitHub仓库的链接，以便那些拿到项目分发版本的人知道在哪里找到它
+
+如果这是一个全新的仓库，请将其克隆到本地计算机并开始工作：
+
+.. code-block:: console
+
+    $ git clone https://github.com/<username>/<projectname>
+
+或者，如果您已经有一个项目Git仓库，请将您的新GitHub仓库添加为远程：
+
+.. code-block:: console
+
+    $ cd <projectname>
+    $ git remote add origin https://github.com/<username>/<projectname>
+    $ git push --tags
+
+**************************
+当您的项目增长时
+**************************
+
+要了解更多关于管理开源软件项目的内容，请参见
+`Producing Open Source Software <https://producingoss.com/>`_ 这本书。
diff --git a/docs/starting/install/linux.rst b/docs/starting/install/linux.rst
index 1ee5831..6758791 100644
--- a/docs/starting/install/linux.rst
+++ b/docs/starting/install/linux.rst
@@ -1,7 +1,9 @@
 .. _install-linux:
 
+
+############################
 在Linux上安装Python 2
-==========================
+############################
 
 .. image:: https://farm5.staticflickr.com/4268/34435688560_4cc2a7bcbb_k_d.jpg
 
@@ -28,10 +30,12 @@
 开发前，安装接下来教程中所介绍的工具和库。特别应该安装Setuptools和pip，它们将简化安装和使用
 Python第三方库的流程。
 
+
+****************
 Setuptools & Pip
-----------------
+****************
 
-`setuptools <https://pypi.python.org/pypi/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
+`setuptools <https://pypi.org/project/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
 是最重要的两个Python第三方软件包。一旦安装了它们，就可以通过一条指令下载、安装和卸载可获取到的
 Python应用包，还可以轻松地将这种网络安装的方式加入到自己开发的Python应用中。
 
@@ -45,8 +49,10 @@ Python 2.7.9 以及之后版本(Python2 系列)，和Python 3.4以及之后版
 
 `参考官方pip安装指南 <https://pip.pypa.io/en/latest/installing/>`_ 获取pip工具，并自动安装最新版本的setuptools。
 
+
+****************
 虚拟环境
---------------------
+****************
 
 虚拟环境工具(virturalenv)通过为不同项目创建专属的Python虚拟环境，以实现其依赖的库独立保存在不同的路径。
 这解决了“项目X依赖包版本1.x，但项目Y依赖包版本为4.x”的难题, 并且维持全局的site-packages目录干净、易管理。 
@@ -59,5 +65,5 @@ Python 2.7.9 以及之后版本(Python2 系列)，和Python 3.4以及之后版
 
 --------------------------------
 
-该页是 `另一份指南 <http://www.stuartellis.eu/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
+该页是 `另一份指南 <https://www.stuartellis.name/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
 
diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
index 0664641..62a0f12 100644
--- a/docs/starting/install/osx.rst
+++ b/docs/starting/install/osx.rst
@@ -1,16 +1,18 @@
 .. _install-osx:
 
+
+###############################
 在Mac OS X上安装Python 2
-=============================
+###############################
 
 .. image:: https://farm5.staticflickr.com/4268/34435688560_4cc2a7bcbb_k_d.jpg
 
 .. note::
     查看我们的 :ref:`在OS X上安装Python 3指南<install3-osx>`.
 
-最新版本的Mac OS X，High Sierra， **自带Python 2.7**。
+Mac OS X 自带 Python 2.7。
 
-您不必安装和配置即可直接使用Python进行开发。
+不必安装和配置即可直接使用Python进行开发。
 话虽如此，我还是强烈建议各位，在正式开始Python应用开发前，安装接下来教程中所介绍的工具和库。
 特别应该安装Setuptools——它将简化安装和使用Python第三方库的流程。
 
@@ -18,26 +20,27 @@ OS X自带的Python版本更适合用于学习而不是开发。因为版本与P
 <https://www.python.org/downloads/mac-osx/>`_ 相比可能已经过时。
 
 
+**************
 现在就开始吧！
---------------
+**************
 
 跟着我一起安装真实版本的Python吧。
 
 在正式安装之前，应先安装C编译器。最快的方式是运行 ``xcode-select --install`` 来安装Xcode命令行工具。
-您也可以从Mac应用商店下载完全版的 `XCode <http://developer.apple.com/xcode/>`_， 
+您也可以从Mac应用商店下载完全版的 `Xcode <https://developer.apple.com/xcode/>`_， 
 或者更轻巧的 `OSX-GCC-Installer <https://github.com/kennethreitz/osx-gcc-installer#readme>`_ 。
 
 .. note::
-    如果已经安装了XCode，请不要再安装 OSX-GCC-Installer。两者结合可能会引发难以诊断的问题。
+    如果已经安装了Xcode，请不要再安装 OSX-GCC-Installer。两者结合可能会引发难以诊断的问题。
 
 .. note::
-    执行XCode的全新安装完成后，须在终端执行下述命令 ``xcode-select --install`` 来安装命令行工具。
+    执行Xcode的全新安装完成后，须在终端执行下述命令 ``xcode-select --install`` 来安装命令行工具。
 
 
-尽管OS X系统附带了大量UNIX工具，熟悉Linux系统的人员使用时会发现缺少一个重要的组件——合适的包管理工具，
-`Homebrew <http://brew.sh>`_ 正好填补了这个空缺。
+尽管OS X系统附带了大量Unix工具，熟悉Linux系统的人员使用时会发现缺少一个重要的组件——合适的包管理工具，
+`Homebrew <https://brew.sh>`_ 正好填补了这个空缺。
 
-`安装 Homebrew <http://brew.sh/#install>`_ 只需打开 :file:`终端` 或个人常用的终端模拟器并运行：
+`安装 Homebrew <https://brew.sh/#install>`_ 只需打开 :file:`终端` 或个人常用的终端模拟器并运行：
 
 .. code-block:: console
 
@@ -49,33 +52,32 @@ OS X自带的Python版本更适合用于学习而不是开发。因为版本与P
 
 .. code-block:: console
 
-    export PATH=/usr/local/bin:/usr/local/sbin:$PATH
+    export PATH="/usr/local/bin:/usr/local/sbin:$PATH"
 
 接下来可以开始安装Python 2.7：
 
 .. code-block:: console
 
-    $ brew install python
+    $ brew install python@2
 
-或者 Python 3:
+因为 ``python@2`` 像一个“桶”，我们需要再次更新我们的``PATH``，以指向我们的新安装：
 
 .. code-block:: console
 
-    $ brew install python3
-
-耗时大概几分钟。
+    export PATH="/usr/local/opt/python@2/libexec/bin:$PATH"
 
 Homebrew命名可执行文件 ``python2``，以便您仍然可以通过可执行文件“python”运行系统Python。
 
 .. code-block:: console
 
-    $ python -V   # 系统Python解释器
+    $ python -V   # Homebrew安装的Python 3解释器（如果安装了）
     $ python2 -V  # Homebrew安装的Python 2解释器
     $ python3 -V  # Homebrew安装的Python 3解释器（如果安装了）
 
 
+****************
 Setuptools & Pip
-----------------
+****************
 
 Homebrew会自动安装好Setuptools和 ``pip`` 。
 Setuptools提供 ``easy_install`` 命令，实现通过网络（通常Internet）下载和安装第三方Python包。
@@ -89,12 +91,13 @@ Setuptools提供 ``easy_install`` 命令，实现通过网络（通常Internet
 .. code-block:: console
 
     $ pip2 -V  # pip指向Homebrew安装的Python 2解释器
-    $ pip3 -V  # pip指向Homebrew安装的Python 3解释器（如果安装了）
-
+    $ pip -V  # pip指向Homebrew安装的Python 3解释器（如果安装了）
 
 
+****************************************
 虚拟环境(Virtual Environment)
---------------------------------------
+****************************************
+
 虚拟环境工具(virturalenv)通过为不同项目创建专属的Python虚拟环境，以实现其依赖的库独立保存在不同的路径。
 这解决了“项目X依赖包版本1.x，但项目Y依赖包版本为4.x”的难题，并且维持全局的site-packages目录干净、易管理。
 
@@ -104,4 +107,4 @@ Setuptools提供 ``easy_install`` 命令，实现通过网络（通常Internet
 
 --------------------------------
 
-该页是 `另一份指南 <http://www.stuartellis.eu/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
\ No newline at end of file
+该页是 `另一份指南 <https://www.stuartellis.name/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
diff --git a/docs/starting/install/win.rst b/docs/starting/install/win.rst
index 641655b..c3c2745 100644
--- a/docs/starting/install/win.rst
+++ b/docs/starting/install/win.rst
@@ -1,15 +1,17 @@
 .. _install-windows:
 
+
+##############################
 在Windows上安装Python 2
-============================
+##############################
 
 .. image:: https://farm5.staticflickr.com/4268/34435688560_4cc2a7bcbb_k_d.jpg
 
 .. note::
     查看我们的 :ref:`在Windows上安装Python 3指南<install3-windows>`.
 
-首先，从官网下载 `最新版本 <https://www.python.org/ftp/python/2.7.14/python-2.7.14.msi>`_
-的Python 2.7。如果想要确保下载到最新版本，单击 `Python官网 <http://python.org>`_ 的
+首先，从官网下载 `最新版本 <https://www.python.org/ftp/python/2.7.15/python-2.7.15.msi>`_
+的Python 2.7。如果想要确保下载到最新版本，单击 `Python官网 <https://python.org>`_ 的
 Downloads > Windows 链接。
 
 Windows版本是MSI文件格式，双击它即可开始安装。MSI文件格式允许Windows管理员使用标准工具自动
@@ -22,13 +24,13 @@ Python将安装到内含版本号信息的路径，例如Python 2.7版本将被
 把默认使用的Python版本路径加到 :envvar:`PATH` 环境变量中，避免每次使用时都要冗余地写全Python
 解释器路径。假设安装路径是 :file:`C:\\Python27\\`, 将这段加入到 :envvar:`PATH` 中:
 
-.. code-block:: console
+.. code-block:: doscon
 
     C:\Python27\;C:\Python27\Scripts\
 
 或在 ``powershell`` 中运行:
 
-.. code-block:: console
+.. code-block:: powershell
 
     [Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python27\;C:\Python27\Scripts\", "User")
 
@@ -38,10 +40,12 @@ Python将安装到内含版本号信息的路径，例如Python 2.7版本将被
 就可以开始正式使用Python了，但我还是强烈建议各位，在正式开始Python应用开发前，安装接下来教程中所介绍
 的工具和库。特别应该安装Setuptools——它将简化安装和使用Python第三方库的流程。
 
+
+****************
 Setuptools + Pip
-----------------
+****************
 
-`setuptools <https://pypi.python.org/pypi/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
+`setuptools <https://pypi.org/project/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
 是两个最重要的第三方Python包。
 
 安装完成后，您可以使用单个命令下载、安装和卸载任何兼容的Python应用包。还可以轻松地这种网络安装的方式加入到自己开发
@@ -51,15 +55,16 @@ Python 2.7.9和更高版本（在Python 2系列上），Python 3.4和更高版
 
 要查看是否安装了pip，请打开命令提示符并运行：
 
-.. code-block:: console
+.. code-block:: doscon
 
-    $ command -v pip
+     command -v pip
 
 要安装pip， `请遵照官方的pip安装指南 <https://pip.pypa.io/en/latest/installing/>`_ —— 这将自动安装最新版本的setuptools。
 
 
+********************
 虚拟环境
---------------------
+********************
 
 虚拟环境工具(通常是指“virturalenv”)通过为不同项目创建专属的Python虚拟环境，以实现其依赖的库独立保存在不同的路径。
 这解决了“项目X依赖包版本1.x，但项目Y依赖包版本为4.x”的难题, 并且维持全局的site-packages目录干净、易管理。 
@@ -70,5 +75,5 @@ Python 2.7.9和更高版本（在Python 2系列上），Python 3.4和更高版
 
 --------------------------------
 
-该页是 `另一份指南 <http://www.stuartellis.eu/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
+该页是 `另一份指南 <https://www.stuartellis.name/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
 
diff --git a/docs/starting/install3/linux.rst b/docs/starting/install3/linux.rst
index 214657c..32859e1 100644
--- a/docs/starting/install3/linux.rst
+++ b/docs/starting/install3/linux.rst
@@ -1,11 +1,13 @@
 .. _install3-linux:
 
+
+############################
 在Linux上安装Python 3
-============================
+############################
 
 .. image:: https://farm5.staticflickr.com/4276/34435689480_2e6f358510_k_d.jpg
 
-这份文档描述了如何在Ubuntu Linux机器上安装Python 3.6。
+这份文档描述了如何在Ubuntu Linux机器上安装Python 3.6 或 3.8。
 
 想要获取已安装的Python 3版本号，可以通过终端运行命令：
 
@@ -18,12 +20,12 @@
     $ sudo apt-get update
     $ sudo apt-get install python3.6
 
-如果您使用的是其他版本的Ubuntu（比如LTS发行版），我们推荐使用 `deadsnakes PPA <https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa>`_ 来安装 Python 3.6::
+如果您使用的是其他版本的Ubuntu（例如最新的 LTS 版本）或者您想使用更新的Python，我们建议使用 `deadsnakes PPA <https://launchpad.net/~deadsnakes/+archive/ubuntu/ ppa>`_ 安装Python 3.8::
 
     $ sudo apt-get install software-properties-common
     $ sudo add-apt-repository ppa:deadsnakes/ppa
     $ sudo apt-get update
-    $ sudo apt-get install python3.6
+    $ sudo apt-get install python3.8
 
 如果您使用的是其他Linux发行版，有可能已经预装了Python 3。如果没有，使用发行版的包管理器。
 比如，在Fedora上您可以使用 `dnf`：
@@ -33,33 +35,36 @@
     $ sudo dnf install python3
 
 注意，如果 ``python3`` 包的版本不够新，还有其他方式安装更新的版本，这取决于所在的发行版。
-比如在Fedora 25上安装 ``python36`` 包来获取Python 3.6。如果您是Fedora用户，您可能想
+比如在Fedora 32上安装 ``python3.9`` 包来获取Python 3.9。如果您是Fedora用户，您可能想
 阅读 `Fedora中可用的多Python版本`_ 。
 
 .. _Fedora中可用的多Python版本: https://developer.fedoraproject.org/tech/languages/python/multiple-pythons.html
 
 
+*********************
 使用Python 3
----------------------
+*********************
 
-这个时候，在您系统上可能Python 2.7也是可用的。
+这个时候，在您系统上Python 2.7可能也是可用的。
 
 .. code-block:: console
 
     $ python
 
-将打开Python 2解释器。
+可能打开Python 2解释器。
 
 .. code-block:: console
 
     $ python3
 
-将打开Python 3解释器。
+将会打开Python 3解释器。
+
 
+****************
 Setuptools & Pip
-----------------
+****************
 
-`setuptools <https://pypi.python.org/pypi/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
+`setuptools <https://pypi.org/project/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
 是最重要的两个Python第三方软件包。一旦安装了它们，就可以通过一条指令下载、安装和卸载可获取到的
 Python应用包，还可以轻松地将这种网络安装的方式加入到自己开发的Python应用中。
 
@@ -82,8 +87,9 @@ Python 2.7.9 以及之后版本(Python2 系列)，和Python 3.4以及之后版
 不过，使用虚拟环境（下面描述）就无需担心这个问题。
 
 
+*****************************
 Pipenv & 虚拟环境
---------------------
+*****************************
 
 下一步安装 Pipenv，然后就可以安装依赖关系并管理虚拟环境。
 
@@ -96,5 +102,5 @@ Pipenv & 虚拟环境
 
 --------------------------------
 
-该页是 `另一份指南 <http://www.stuartellis.eu/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
+该页是 `另一份指南 <https://www.stuartellis.name/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
 
diff --git a/docs/starting/install3/osx.rst b/docs/starting/install3/osx.rst
index afde0d5..043021a 100644
--- a/docs/starting/install3/osx.rst
+++ b/docs/starting/install3/osx.rst
@@ -2,47 +2,57 @@
 
 .. _install3-osx:
 
+
+###############################
 在Mac OS X上安装Python 3
-================================
+###############################
 
 .. image:: https://farm5.staticflickr.com/4276/34435689480_2e6f358510_k_d.jpg
 
-最新版本的Mac OS X，High Sierra， **自带Python 2.7**。
+Mac OS X 自带 Python 2.7。
 
-您不必安装和配置即可直接使用Python 2。本教程用来说明Python 3的安装。
+不必安装和配置即可直接使用Python 2。本教程用来说明Python 3的安装。
 
 OS X自带的Python版本更适合用于学习而不是开发。因为版本与Python官网发布的 `官方最新稳定版本 
 <https://www.python.org/downloads/mac-osx/>`_ 相比可能已经过时。
 
+
+**************
 现在就开始吧！
---------------
+**************
 
 跟着我一起安装真实版本的Python吧。
 
 在正式安装之前，应先安装C编译器。最快的方式是运行 ``xcode-select --install`` 来安装Xcode命令行工具。
-您也可以从Mac应用商店下载完全版的 `XCode <http://developer.apple.com/xcode/>`_， 
+您也可以从Mac应用商店下载完全版的 `Xcode <https://developer.apple.com/xcode/>`_， 
 或者更轻巧的 `OSX-GCC-Installer <https://github.com/kennethreitz/osx-gcc-installer#readme>`_ 。
 
 .. note::
-    如果已经安装了XCode，请不要再安装 OSX-GCC-Installer。两者结合可能会引发难以诊断的问题。
+    如果已经安装了Xcode，请不要再安装 OSX-GCC-Installer。两者结合可能会引发难以诊断的问题。
 
 .. note::
-    执行XCode的全新安装完成后，须在终端执行下述命令 ``xcode-select --install`` 来安装命令行工具。
+    执行Xcode的全新安装完成后，须在终端执行下述命令 ``xcode-select --install`` 来安装命令行工具。
 
 
-尽管OS X系统附带了大量UNIX工具，熟悉Linux系统的人员使用时会发现缺少一个重要的组件——合适的包管理工具，
-`Homebrew <http://brew.sh>`_ 正好填补了这个空缺。
+尽管OS X系统附带了大量Unix工具，熟悉Linux系统的人员使用时会发现缺少一个重要的组件——合适的包管理工具，
+`Homebrew <https://brew.sh>`_ 正好填补了这个空缺。
 
-`安装 Homebrew <http://brew.sh/#install>`_ 只需打开 :file:`终端` 或个人常用的终端模拟器并运行：
+`安装 Homebrew <https://brew.sh/#install>`_ 只需打开 :file:`终端` 或个人常用的终端模拟器并运行：
 
 .. code-block:: console
 
-    $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+    $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
 
 运行这段脚本将列出它会引起的改变，并在安装开始前提示您。
 安装完成Homebrew后，需将其所在路径插入到 :envvar:`PATH` 环境变量的最前面，即在您所登录用户的
 :file:`~/.profile` 文件末尾加上这一行：
 
+.. code-block:: console
+
+    export PATH="/usr/local/opt/python/libexec/bin:$PATH"
+
+如果您使用的是 OS X 10.12（Sierra）或者更旧的系统，请使用如下命令
+
 .. code-block:: console
 
     export PATH=/usr/local/bin:/usr/local/sbin:$PATH
@@ -51,20 +61,23 @@ OS X自带的Python版本更适合用于学习而不是开发。因为版本与P
 
 .. code-block:: console
 
-    $ brew install python3
+    $ brew install python
 
 这将持续几分钟。
 
 
+***
 Pip
----
+***
 
 Homebrew 会为您安装 ``pip3`` 。
 
 ``pip3`` 是Homebrew版Python 3的 ``pip`` 的别名。
 
+
+*********************
 使用Python 3
----------------------
+*********************
 
 这个时候，在您系统上可能Python 2.7也是可用的。可能 :ref:`Homebrew 版本的Python 2 <install-osx>`
 和Python 3都安装了。 
@@ -73,7 +86,7 @@ Homebrew 会为您安装 ``pip3`` 。
 
     $ python
 
-将打开系统Python解释器。
+将打开通过HomeBrew安装的Python解释器。
 
 .. code-block:: console
 
@@ -88,11 +101,20 @@ Homebrew 会为您安装 ``pip3`` 。
 将会打开使用Homebrew安装的Python 3解释器（如果有）。
 
 如果Homebrew版的Python 2安装了，``pip2`` 指向Python 2。
-如果Homebrew版的Python 3安装了，``pip3`` 指向Python 3。
+如果Homebrew版的Python 3安装了，``pip`` 指向Python 3。
+
+本指南的其余部分假定 ``python`` 指 Python 3。
 
+.. code-block:: console
 
+    # 我安装Python 3了吗？
+    $ python --version
+    Python 3.6.4 # Success! 
+    # If you still see 2.7 ensure in PATH /usr/local/bin/ takes pecedence over /usr/bin/
+
+*********************
 Pipenv & 虚拟环境
---------------------
+*********************
 
 下一步安装 Pipenv，然后就可以安装依赖关系并管理虚拟环境。
 
@@ -105,5 +127,4 @@ Pipenv & 虚拟环境
 
 --------------------------------
 
-该页是 `另一份指南 <http://www.stuartellis.eu/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
-
+该页是 `另一份指南 <https://www.stuartellis.name/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
diff --git a/docs/starting/install3/win.rst b/docs/starting/install3/win.rst
index 03f569f..98dcdd0 100644
--- a/docs/starting/install3/win.rst
+++ b/docs/starting/install3/win.rst
@@ -1,82 +1,56 @@
 .. _install3-windows:
 
-在Windows上安装Python 3
-==============================
-
-.. image:: https://farm5.staticflickr.com/4276/34435689480_2e6f358510_k_d.jpg
-
-首先，从官网下载 `最新版本 <https://www.python.org/ftp/python/3.6.3/python-3.6.3.exe>`_
-的Python 3.6。如果想要确保下载到最新版本，单击 `Python官网 <http://python.org>`_ 的
-Downloads > Windows 链接。
-
-Python将安装到内含版本号信息的路径，例如Python 3.6版本将被安装到 :file:`C:\\Python36\\`, 
-故多个版本的Python可以共存在一个系统里，不会有冲突。当然仅有一个默认的Python解释器，
-:envvar:`PATH` 环境变量也不是自动修改的，开发人员可以控制要运行的Python版本。
-
-把默认使用的Python版本路径加到 :envvar:`PATH` 环境变量中，避免每次使用时都要冗余地写全Python
-解释器路径。假设安装路径是 :file:`C:\\Python36\\`, 将这段加入到 :envvar:`PATH` 中:
-
-.. code-block:: console
-
-    C:\Python36\;C:\Python36\Scripts\
 
-或在 ``powershell`` 中运行:
-
-.. code-block:: console
-
-    [Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python36\;C:\Python36\Scripts\", "User")
-
-这也是安装过程中的一个选择。
-
-其中第二个路径(:file:`Scripts`)可接收已安装包的命令文件，添加这个路径很有益处。虽然以上步骤完成后，
-就可以开始正式使用Python了，但我还是强烈建议各位，在正式开始Python应用开发前，安装接下来教程中所介绍
-的工具和库。特别应该安装Setuptools——它将简化安装和使用Python第三方库的流程。
-
-使用Python 3
----------------------
+##############################
+在Windows上安装Python 3
 
-这个时候，您可能已经安装了Python 2.7。
+##############################
 
-.. code-block:: console
+.. image:: https://farm5.staticflickr.com/4276/34435689480_2e6f358510_k_d.jpg
 
-    $ python
+首先，遵照 `Chocolatey <https://chocolatey.org/install>`_ 的安装指引。
+它是 Windows 7+ 的社区系统包管理器（很像Mac OS X上的Homebrew）。
 
-将打开Python 2解释器。
+完成之后，安装Python 3会非常简单，因为Chocolatey将Python 3作为默认设置。
 
-.. code-block:: console
+.. code-block:: doscon
 
-    $ python3
+    choco install python
 
-将打开Python 3解释器。
+一旦您运行了上述命令，您应该能够直接从控制台启动Python。（Chocolatey非常棒，会自动将Python添加到您的系统路径中。）
 
 
+****************
 Setuptools + Pip
-----------------
+****************
 
-`setuptools <https://pypi.python.org/pypi/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
+`setuptools <https://pypi.org/project/setuptools>`_ 和 `pip <https://pip.pypa.io/en/stable/>`_
 是两个最重要的第三方Python包。
 
 安装完成后，您可以使用单个命令下载、安装和卸载任何兼容的Python应用包。还可以轻松地这种网络安装的方式加入到自己开发
 的Python应用中。
 
-所有受支持的Python 3版本都包含pip，因此请确保它是最新的::
+所有受支持的Python 3版本都包含pip，因此请确保它是最新的:
+
+.. code-block:: doscon
 
     python -m pip install -U pip
 
 
+********************
 Pipenv & 虚拟环境
---------------------
+********************
 
 下一步安装 Pipenv，然后就可以安装依赖关系并管理虚拟环境。
 
 虚拟环境工具通过为不同项目创建专属的 Python 虚拟环境，以实现其依赖的库独立保存在不同的路径。
 这解决了“项目X依赖于 1.x 版本，但项目 Y 需要 4.x”的难题，并且维持全局的 site-packages 目录干净、易管理。 
 
-举个例子，通过这个工具可以实现依赖 Django 1.10 的项目与依赖 Django 1.8 的项目共存。
+举个例子，通过这个工具可以实现依赖 Django 2.0 的项目与依赖 Django 1.8 的项目共存。
 
 所以，向前！进入到 :ref:`Pipenv & 虚拟环境 <virtualenvironments-ref>` 文档中！
 
 --------------------------------
 
-该页是 `另一份指南 <http://www.stuartellis.eu/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
+该页是 `另一份指南 <https://www.stuartellis.name/articles/python-development-windows/>`_ 的混合版本，可通过同一份许可获取。
 
diff --git a/docs/starting/installation.rst b/docs/starting/installation.rst
index 883ad17..c15c510 100644
--- a/docs/starting/installation.rst
+++ b/docs/starting/installation.rst
@@ -1,7 +1,9 @@
 .. _installation:
 
+
+##########################
 正确地安装 Python
-==========================
+##########################
 
 .. image:: https://farm5.staticflickr.com/4303/36137232412_fdcb0f84eb_k_d.jpg
 
@@ -13,8 +15,9 @@
   —*Kenneth Reitz*
 
 
+*******************
 安装指南
--------------------
+*******************
 
 这份指南重温了 :ref:`Python <which-python>` 作为开发工具的正确安装方法，也包括 setuptools, pip 和 virtualenv 等工具的安装。
 
diff --git a/docs/starting/which-python.rst b/docs/starting/which-python.rst
index c27e08c..b5695e2 100644
--- a/docs/starting/which-python.rst
+++ b/docs/starting/which-python.rst
@@ -1,25 +1,30 @@
-选择一个 Python 解释器（3 vs. 2）
-============================================
+
+#####################################
+选择一个 Python 解释器（3 vs 2）
+#####################################
 
 .. image:: https://farm5.staticflickr.com/4265/34484834733_5b80f65ab1_k_d.jpg
 
 .. _which-python:
 
-Python的现状 (2 vs 3)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+***************************
+Python的现状 (3 vs 2)
+***************************
 
 当选择Python解释器的时候，一个首先要面对的问题是：“我应该选择Python 2还是Python 3？” 答案并不像人们想象的那么明显。
 
 
 现状的基本要点如下：
 
-1. 如今大部分生产应用使用 Python 2.7。
+1. 如今大部分生产应用使用 Python 3。
 2. Python 3 已准备好用于生产应用的部署。
-3. Python 2.7 直到 2020 前只会得到必要的安全更新 [#pep373_eol]_。
+3. Python 2.7 已在 2020 年 1 月终止维护 [#pep373_eol]_。
 4. “Python” 涵盖了 Python 3 和 Python 2。
 
+
+***************
 建议
-~~~~~~~~~~~~~~~
+***************
 
 
 .. note:: 使用 **Python 3** 是 *高度* 优先于 Python 2。如果您发现自己 *仍然* 在生产环境中使用 Python 2，
@@ -31,31 +36,27 @@ Python的现状 (2 vs 3)
 - 将 Python 3 用于新的 Python 应用程序。
 - 如果您是第一次学习 Python，熟悉 Python 2.7 将是非常有用的，但学习 Python 3 更有用。
 - 两者都学。它们都是 “Python”。
-- 已经构建的软件通常依赖于 Python 2.7。
-- 如果您正在编写一个新的开源 Python 库，最好同时为 Python 2 和 3 编写。
-  若新库只支持 Python 3 会是一项政治声明，并将疏远您的许多用户。
-  这不是一个问题 —— 慢慢地，在未来三年内，这种情况会减少。
 
+
+******************
 所以.... 3？
-~~~~~~~~~~~~~~~~
+******************
 
 如果您想选择一种Python的解释器，您又不是固执己见的人，我推荐您用最新的Python 3.x，
 因为每个版本都带来了新的改进了的标准库模块、安全性以及bug修复。进步就是进步。
 
 鉴于此，如果您有一个强有力的理由只用Python 2，比如Python 3 没有足够能替代的Python 2
-的特有库，或者您（像我）非常喜而且受Python 2启发。
-
-查看 `Can I Use Python 3? <https://caniusepython3.com/>`_ 来看看是否有您
-依赖的软件阻止您用Python 3。
+的特有库，或者您（像我）非常喜爱而且受Python 2启发。
 
 `延伸阅读 <http://wiki.python.org/moin/Python2orPython3>`_
 
 写 `能够同时兼容Python 2.6，2.7，和Python 3的代码 <https://docs.python.org/3/howto/pyporting.html>`_ 是可能的。
-这包括从简单到困难的各种难度，取决于您所写软件的类型；如果您是初学者，其实有更重要的东西要操心。请注意，Python 2.6
-是生命周期结束的上游，所以您不应该试着编写兼容2.6的代码，除非您被专门安排做这件事。
+这包括从简单到困难的各种难度，取决于您所写软件的类型；如果您是初学者，其实有更重要的东西要操心。
+
 
+***************
 实现
-~~~~~~~~~~~~~~~
+***************
 
 当人们谈论起 *Python*，他们不仅是在说语言本身，还包括其CPython实现。 
 *Python* 实际上是一个可以用许多不同的方式来实现的语言规范。
@@ -93,7 +94,7 @@ Jython
 如果您需要与现有的Java代码库对接或者基于其他原因需要为JVM编写Python代码，那么
 Jython是最好的选择。
 
-Jython现在支持到Python 2.7 [#jython_ver]_。
+Jython现在支持到Python 2.7 [#jython_ver]_ 。 IronPython 3 [#iron_ver3]_ 正在开发中，但截止到 2020 年 9 月尚未准备好。
 
 IronPython
 ----------
@@ -106,23 +107,26 @@ IronPython到Visual Studio开发环境中，使之成为Windows开发者的理
 
 IronPython支持Python 2.7 [#iron_ver]_。
 
-PythonNet
----------
+Python.Net
+----------
 
 `Python for .NET <http://pythonnet.github.io/>`_ 是一个近乎无缝集成的，
 提供给本机已安装的Python .NET公共语言运行时（CLR）包。它采取与IronPython
 （见上文）相反的方法，与其说是竞争，不如说是互补。
 
-PythonNet与Mono相结合使用，通过.NET框架，能使Python在非windows系统上（如OS X和Linux）完成操作。它可以在除外IronPython的环境中无冲突运行。
+Python.Net与Mono相结合使用，通过.NET框架，能使Python在非windows系统上（如OS X和Linux）完成操作。它可以在除外IronPython的环境中无冲突运行。
 
-PythonNet支持Python 2.3到2.7 [#pythonnet_ver]_。
+Python.Net兼容Python 2.7和3.5-3.8 [#pythonnet_ver1]_ 。
 
-.. [#pep373_eol] https://www.python.org/dev/peps/pep-0373/#id2
 
-.. [#pypy_ver] http://pypy.org/compat.html
+.. [#pypy_ver] https://pypy.org/compat.html
 
 .. [#jython_ver] https://hg.python.org/jython/file/412a8f9445f7/NEWS
 
-.. [#iron_ver] http://ironpython.codeplex.com/releases/view/81726
+.. [#iron_ver] https://ironpython.net/download/
+
+.. [#iron_ver3] https://github.com/IronLanguages/ironpython3
 
-.. [#pythonnet_ver] http://pythonnet.github.io/readme.html
+.. [#pythonnet_ver1] https://pythonnet.github.io/
+
+.. [#pep373_eol] https://www.python.org/dev/peps/pep-0373/#id2
diff --git a/docs/writing/documentation.rst b/docs/writing/documentation.rst
index f6a9489..1027e2e 100644
--- a/docs/writing/documentation.rst
+++ b/docs/writing/documentation.rst
@@ -1,13 +1,17 @@
+
+#############
 文档
-=============
+#############
 
 .. image:: https://farm5.staticflickr.com/4279/35620636012_f66aa88f93_k_d.jpg
 
 可读性是Python开发者需关注的重点，这包括项目和代码文档的可读性。遵循一些
 简单的最佳实践能够帮助您和其他人节省很多时间。
 
+
+*********************
 项目文档
----------------------
+*********************
 
 根目录下的 :file:`README` 文件应该告诉用户和维护者关于项目的基本信息。它应该是
 原始文本，用一些非常容易阅读的标记，比如 :ref:`reStructuredText-ref` 或 Markdown。
@@ -25,8 +29,10 @@
 :file:`CHANGELOG` 文件或者位于 :file:`README` 中的 ``CHANGELOG`` 区域应该呈现对
 代码库的最新修改的简短概述。
 
+
+*********************
 项目发布
--------------------
+*********************
 
 根据项目，您的文档中可能包含下列部分或所有的内容：
 
@@ -60,7 +66,7 @@ Sphinx_ 无疑是最流行的Python文档工具。**请使用它吧。** 它能
     Sphinx因API生成而著名，但它也适用于普通的项目文档。本指南使用 Sphinx_ 进行构建，
     并托管在 `Read The Docs`_ 上。
 
-.. _Sphinx: http://sphinx.pocoo.org
+.. _Sphinx: https://www.sphinx-doc.org
 .. _Read The Docs: http://readthedocs.org
 
 .. _restructuredtext-ref:
@@ -68,21 +74,21 @@ Sphinx_ 无疑是最流行的Python文档工具。**请使用它吧。** 它能
 reStructuredText
 ~~~~~~~~~~~~~~~~
 
-大多数Python文档是用 reStructuredText_ 编写的。它就像是内建了所有可选扩展的
-Markdown。
+大多数Python文档是用 reStructuredText_ 编写的。它和Markdown类似，但内建了所有可选扩展。
 
 `reStructuredText Primer`_ 和 `reStructuredText Quick Reference`_ 应该会帮助
 您熟悉它的语法。
 
 .. _reStructuredText: http://docutils.sourceforge.net/rst.html
-.. _reStructuredText Primer: http://sphinx.pocoo.org/rest.html
+.. _reStructuredText Primer: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
 .. _reStructuredText Quick Reference: http://docutils.sourceforge.net/docs/user/rst/quickref.html
 
 
+*************************
 代码文档建议
--------------------------
+*************************
 
-注释能使代码清晰，将其加入到代码中是为了理解代码起来更容易。在Python中，注意以一个hash（数字符号）（“#”）开始。
+注释能使代码清晰，将其加入到代码中是为了理解代码起来更容易。在Python中，注释以一个hash（数字符号）（“#”）开始。
 
 .. _docstring-ref:
 
@@ -151,7 +157,7 @@ Markdown。
 更适合于向其他用户（或是写完代码6个月内的您）解释您代码中的特定功能是 *如何* 使用，
 或是方法、类和模块的作用。
 
-编写文本字符串
+编写文档字符串
 ~~~~~~~~~~~~~~~~~~
 
 取决于函数、方法或类的复杂度，使用单行文档字符串可能十分合适。
@@ -207,8 +213,9 @@ Markdown。
 .. _`NumPy style`: http://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_numpy.html
 
 
+***********
 其他工具
------------
+***********
 
 您可能在其他场景看到过这些。使用 :ref:`sphinx-ref`。
  
diff --git a/docs/writing/gotchas.rst b/docs/writing/gotchas.rst
index f1c7dd0..101d8fe 100644
--- a/docs/writing/gotchas.rst
+++ b/docs/writing/gotchas.rst
@@ -1,5 +1,7 @@
+
+##############
 常见陷阱
-==============
+##############
 
 .. image:: https://farm5.staticflickr.com/4163/34435688380_b5a740762b_k_d.jpg
 
@@ -12,8 +14,10 @@
 
 .. _default_args:
 
+
+*************************
 可变默认参数
--------------------------
+*************************
 
 看起来，*最* 让Python程序员感到惊奇的是Python对函数定义中可变默认参数的处理。
 
@@ -32,10 +36,10 @@
 .. code-block:: python
 
     my_list = append_to(12)
-    print my_list
+    print(my_list)
 
     my_other_list = append_to(42)
-    print my_other_list
+    print(my_other_list)
 
 每次调用函数时，如果不提供第二个参数，就会创建一个新的列表，所以结果应是这样的：
 
@@ -79,8 +83,9 @@
 编写缓存函数。
 
 
-迟绑定闭包
----------------------
+****************************
+延迟绑定闭包
+****************************
 
 另一个常见的困惑是Python在闭包(或在周围全局作用域（surrounding global scope）)中
 绑定变量的方式。
@@ -99,7 +104,7 @@
 .. testcode::
 
     for multiplier in create_multipliers():
-        print multiplier(2)
+        print(multiplier(2))
 
 一个包含五个函数的列表，每个函数有它们自己的封闭变量 ``i`` 乘以它们的参数，得到::
 
@@ -171,8 +176,10 @@ Python的闭包是 *迟绑定* 。
 有时您就想要闭包有如此表现，迟绑定在很多情况下是不错的。不幸的是，循环创建
 独特的函数是一种会使它们出差错的情况。
 
+
+*********************************
 字节码（.pyc）文件无处不在！
----------------------------------
+*********************************
 
 默认情况下，当使用文件执行Python代码时，Python解释器会自动将该文件的字节码版本写入磁盘。
 比如， ``module.pyc``。
@@ -216,7 +223,7 @@ Python的闭包是 *迟绑定* 。
 流行的版本控制系统能够使用文件中定义的通配符来应用特殊规则。
 
 一份忽略文件将确保匹配的文件未被检入存储库。
-Git_ 使用 ``.gitignore``，而 Mercurial_ 使用``.hgignore```。
+Git_ 使用 ``.gitignore``，而 Mercurial_ 使用 ``.hgignore``。
 
 .. _Git: https://git-scm.com/
 .. _Mercurial: https://www.mercurial-scm.org/
diff --git a/docs/writing/license.rst b/docs/writing/license.rst
index 95f16e2..91ccdf3 100644
--- a/docs/writing/license.rst
+++ b/docs/writing/license.rst
@@ -1,5 +1,7 @@
+
+##################
 选择一个许可
-==================
+##################
 
 .. image:: https://farm5.staticflickr.com/4228/33907149294_82d7535a6c_k_d.jpg
 
diff --git a/docs/writing/logging.rst b/docs/writing/logging.rst
index b76df9b..74eda11 100644
--- a/docs/writing/logging.rst
+++ b/docs/writing/logging.rst
@@ -1,5 +1,7 @@
+
+#####################
 日志（Logging）
-=====================
+#####################
 
 .. image:: https://farm5.staticflickr.com/4246/35254379756_c9fe23f843_k_d.jpg
 
@@ -7,6 +9,8 @@
 模块自2.3版本开始便是Python标准库的一部分。它被简洁的描述在 :pep:`282`。
 众所周知，除了 `基础日志指南`_ 部分，该文档并不容易阅读。
 
+`loguru <https://github.com/Delgan/loguru>`_ 作为替代方案，
+提供了像使用 ``print`` 语句一样简单的日志打印方法。
 
 日志的两个目的：
 
@@ -15,11 +19,12 @@
 - **审计日志**  为商业分析而记录的日志。从审计日志中，可提取用户的交易信息，
   并结合其他用户资料构成用户报告或者用来优化商业目标。
 
-... 或者打印?
--------------------
+**************************
+... 或者打印（Print）?
+**************************
 
-当需要在命令行应用中显示帮助文档时， ``打印`` 是一个相对于日志更好的选择。
-而在其他时候，日志总能优于 ``打印`` ，理由如下：
+当需要在命令行应用中显示帮助文档时， ``print`` 是一个相对于日志更好的选择。
+而在其他时候，日志总能优于 ``print`` ，理由如下：
 
 - 日志事件产生的 `日志记录`_ ，包含清晰可用的诊断信息，如文件名称、路径、函数名和行号等。
 - 包含日志模块的应用，默认可通过根记录器对应用的日志流进行访问，除非您将日志过滤了。
@@ -27,8 +32,9 @@
   或可通过设置 :attr:`logging.Logger.disabled` 属性为 ``True`` 来禁用。
 
 
+**************************
 库中的日志
---------------------
+**************************
 
 `日志指南`_ 中含 `库日志配置`_ 的说明。由于是 *用户* ，而非库来指明如何响应日志事件，
 因此这里有一个值得反复说明的忠告：
@@ -47,11 +53,12 @@
     logging.getLogger(__name__).addHandler(logging.NullHandler())
 
 
+**************************
 应用程序中的日志
--------------------------
+**************************
 
-应用程序开发的权威指南， `应用的12要素 <http://12factor.net>`_ ，也在其中一节描述了 
-`日志的作用 <http://12factor.net/logs>`_ 。它特别强调将日志视为事件流，
+应用程序开发的权威指南， `应用的12要素 <https://12factor.net>`_ ，也在其中一节描述了 
+`日志最佳实践 <https://12factor.net/logs>`_ 。它特别强调将日志视为事件流，
 并将其发送至由应用环境所处理的标准输出中。
 
 
@@ -164,9 +171,9 @@ Python 2.7中，您可以使用字典实现详细配置。:pep:`391` 包含了
     logger.debug('often makes a very good meal of %s', 'visiting tourists')
 
 
-.. _基础日志指南: http://docs.python.org/howto/logging.html#logging-basic-tutorial
-.. _日志配置: https://docs.python.org/howto/logging.html#configuring-logging
-.. _日志指南: http://docs.python.org/howto/logging.html
-.. _库日志配置: https://docs.python.org/howto/logging.html#configuring-logging-for-a-library
-.. _日志记录: https://docs.python.org/library/logging.html#logrecord-attributes
+.. _基础日志指南: http://docs.python.org/3/howto/logging.html#logging-basic-tutorial
+.. _日志配置: https://docs.python.org/3/howto/logging.html#configuring-logging
+.. _日志指南: http://docs.python.org/3/howto/logging.html
+.. _库日志配置: https://docs.python.org/3/howto/logging.html#configuring-logging-for-a-library
+.. _日志记录: https://docs.python.org/3/library/logging.html#logrecord-attributes
 .. _requests 资源: https://github.com/kennethreitz/requests
diff --git a/docs/writing/reading.rst b/docs/writing/reading.rst
index e3ade6e..f57d0e9 100644
--- a/docs/writing/reading.rst
+++ b/docs/writing/reading.rst
@@ -1,22 +1,14 @@
+
+##################
 阅读好的代码
-==================
+##################
 
 .. image:: https://farm5.staticflickr.com/4221/34689452831_93d7fd0571_k_d.jpg
 
-设计Python的核心理念是创建可读性代码。这种设计的目的非常简单：Python编写者的首要事情是阅读好的代码。
-
 成为优秀Python编写者的秘诀是去阅读，理解和领会好的代码。
 
-.. raw:: html
-
-    <iframe width="560" 
-            height="315" 
-            src="https://www.youtube.com/embed/Jc8M9-LoEuo" 
-            frameborder="0" allowfullscreen></iframe>
-    
-
-良好的代码需要遵循
-:ref:`code_style` 中概述的指南,尽可能向读者表述简洁清楚。
+良好的代码通常遵循
+:ref:`code_style` 中的指南,尽可能向读者表述地简洁清楚。
 
 
 以下是推荐阅读的Python项目。每个项目都是Python代码的典范。
@@ -29,8 +21,8 @@
 
 
 - `Diamond <https://github.com/python-diamond/Diamond>`_
-  Diamond是python的守护进程，它收集指标，并且将他们发布至Graphite或其它后端。
-  它能够收集cpu,内存，网络，i/o，负载和硬盘指标。除此，它拥有实现自定义收集器的API，该API几乎能
+  Diamond是Python的守护进程，它收集指标，并且将他们发布至Graphite或其它后端。
+  它能够收集CPU,内存，网络，I/O，负载和硬盘指标。除此，它拥有实现自定义收集器的API，该API几乎能
   从任何资源中获取指标。
 
 - `Werkzeug <https://github.com/mitsuhiko/werkzeug>`_
@@ -40,7 +32,7 @@
 - `Requests <https://github.com/kennethreitz/requests>`_
   Requests是Apache2许可的HTTP库，使用Python编写。
 
-- `Tablib <https://github.com/kennethreitz/tablib>`_
+- `Tablib <https://github.com/jazzband/tablib>`_
   Tablib是无格式的表格数据集库，使用Python编写。
 
 
diff --git a/docs/writing/structure.rst b/docs/writing/structure.rst
index 75588c8..f8412d7 100644
--- a/docs/writing/structure.rst
+++ b/docs/writing/structure.rst
@@ -1,5 +1,8 @@
+
+
+########################
 结构化您的工程
-========================
+########################
 
 .. image:: https://farm5.staticflickr.com/4203/33907151224_0574e7dfc2_k_d.jpg
 
@@ -8,17 +11,18 @@
 “结构化”意味着通过编写简洁的代码，并且正如文件系统中文件和目录的组织一样，
 代码应该使逻辑和依赖清晰。
 
-哪个函数应该深入到哪个模块？数据在项目中如何流转？什么功能和函数应该组合
-或独立？要解决这些问题，您可以开始做个一计划，大体来说，即是您的最终产品
+哪个函数应该放到哪个模块？数据在项目中如何流转？什么功能和函数应该组合
+或独立？要解决这些问题，您可以开始做一个计划，大体来说，即是您的最终产品
 看起来会是怎样的。
 
 在这一章节中，我们更深入地去观察Python的模块和导入系统，因为它们是加强您
 的项目结构化的关键因素，接着我们会从不同层面去讨论如何去构建可扩展且测试
-可靠的的代码。
+可靠的代码。
 
 
+***************************
 仓库的结构
----------------------------
+***************************
 
 这很重要
 :::::::::::::::
@@ -42,9 +46,9 @@
 仓库样例
 :::::::::::::::::
 
-**请看这里**: 这是 `Kenneth Reitz <http://kennethreitz.org>`_ 推荐的。
+**请看这里**: 这是 `Kenneth Reitz在2013年推荐的 <https://kennethreitz.org/essays/2013/01/27/repository-structure-and-python>`_ 。
 
-这个仓库 `可以在Github上找到 <https://github.com/kennethreitz/samplemod>`__ 。
+这个仓库 `可以在GitHub上找到 <https://github.com/kennethreitz/samplemod>`__ 。
 
 ::
 
@@ -100,7 +104,7 @@ License
 
 如果您不太清楚您应该使用哪种许可方式，请查看 `choosealicense.com <http://choosealicense.com>`_.
 
-当然，您也可以在发布您的代码时不做任何许可说明，但是这显然阻碍潜在的用户使用您的代码。
+当然，您也可以在发布您的代码时不做任何许可说明，但是这会阻碍潜在的用户使用或参与贡献您的代码。
 
 Setup.py
 ::::::::
@@ -144,7 +148,7 @@ Test Suite
 ::::::::::
 
 
-*想了解关于编写测试的建议，请查阅 :doc:`/writing/tests`。*
+*想了解关于编写测试的建议，请查阅* :doc:`/writing/tests`。
 
 .. csv-table::
    :widths: 20, 40
@@ -172,7 +176,7 @@ Test Suite
 
 我极力推荐后者。如果使用 ``setup.py develop`` 来测试一个持续更新的代码库，需要为每一个版本的代码库设置一个独立的测试环境.太麻烦了。
 
-可以先创建一个包含上下文环境的文件 tests/context.py。
+可以先创建一个包含上下文环境的文件 ``tests/context.py``。
 file:
 
 ::
@@ -265,12 +269,9 @@ Makefile
     samplesite/sampleapp/models.py
 
 
-
-
-
-
+************************
 结构是一把钥匙
-----------------
+************************
 
 得益于Python提供的导入与管理模块的方式，结构化Python项目变得相对简单。
 这里说的简单，指的是结构化过程没有太多约束限制而且模块导入功能容易掌握。
@@ -304,8 +305,10 @@ Makefile
   合适结构的类或对象，如果您始终弄不清手头上的任务应该使用FurnitureTable，
   AssetTable还是Table，甚至TableNew，也许您已经陷入了混沌代码中。
 
+
+*******
 模块
--------
+*******
 
 Python模块是最主要的抽象层之一，并且很可能是最自然的一个。抽象层允许将代码分为
 不同部分，每个部分包含相关的数据与功能。
@@ -351,8 +354,8 @@ Python的模块查找功能。就 `my.spam.py` 来说，Python 认为需要在 :
 
 也可以使用import语句的特殊形式 ``from modu import *`` 模拟更标准的行为。但 ``import *`` 通常
 被认为是不好的做法。**使用** ``from modu import *`` **的代码较难阅读而且依赖独立性不足**。
-使用 ``from modu import func`` 能精确定位您想导入的方法并将其放到全局命名空间中。
-比 ``from modu import *`` 要好些，因为它明确地指明往全局命名空间中导入了什么方法，它和
+使用 ``from modu import func`` 能精确定位您想导入的方法并将其放到本地命名空间中。
+比 ``from modu import *`` 要好些，因为它明确地指明往本地命名空间中导入了什么方法，它和
 ``import modu`` 相比唯一的优点是之后使用方法时可以少打点儿字。
 
 
@@ -386,8 +389,10 @@ Python的模块查找功能。就 `my.spam.py` 来说，Python 认为需要在 :
 过份简洁而导致简短晦涩。除了简单的单文件项目外，其他项目需要能够明确指出类和方法
 的出处，例如使用 ``modu.func`` 语句，这将显著提升代码的可读性和易理解性。
 
+
+********
 包
---------
+********
 
 Python提供非常简单的包管理系统，即简单地将模块管理机制扩展到一个目录上(目录扩
 展为包)。
@@ -411,8 +416,9 @@ Python提供非常简单的包管理系统，即简单地将模块管理机制
 该语法允许使用 `mod` 替代冗长的 ``very.deep.module``。
 
 
+***************************
 面向对象编程
----------------------------
+***************************
 
 Python有时被描述为面向对象编程的语言，这多少是个需要澄清的误导。在Python中
 一切都是对象，并且能按对象的方式处理。这么说的意思是，例如函数是一等对象。
@@ -462,8 +468,10 @@ Python有时被描述为面向对象编程的语言，这多少是个需要澄
 应用或游戏的开发过程中，操作的元素(窗口、按钮、角色、车辆)在计算机内存里拥有相
 对较长的生命周期。
 
+
+**********
 装饰器
-----------
+**********
 
 Python语言提供一个简单而强大的语法: '装饰器'。装饰器是一个函数或类，它可以
 包装(或装饰)一个函数或方法。被 '装饰' 的函数或方法会替换原来的函数或方法。
@@ -491,8 +499,10 @@ Python语言提供一个简单而强大的语法: '装饰器'。装饰器是一
 好的使用装饰器的例子：您需要在table中储存一个耗时函数的结果，并且下次能直接
 使用该结果，而不是再计算一次。这显然不属于函数的逻辑部分。
 
+
+****************
 上下文管理器
-----------------
+****************
 
 上下文管理器是一个Python对象，为操作提供了额外的上下文信息。 这种额外的信息，
 在使用 ``with`` 语句初始化上下文，以及完成 ``with`` 块中的所有代码时，采用可调用的形式。 
@@ -528,7 +538,7 @@ CustomOpen 首先被实例化，然后调用它的`__enter__``方法，而且 ``
 ``as f`` 语句中被赋给 ``f`` 。 当 ``with`` 块中的内容执行完后，会调用 `__exit__`` 方法。
 
 而生成器方式使用了Python自带的
-`contextlib <https://docs.python.org/2/library/contextlib.html>`_:
+`contextlib <https://docs.python.org/3/library/contextlib.html>`_:
 
 .. code-block:: python
 
@@ -552,8 +562,10 @@ CustomOpen 首先被实例化，然后调用它的`__enter__``方法，而且 ``
 由于这两种方法都是一样的，所以我们应该遵循Python之禅来决定何时使用哪种。
 如果封装的逻辑量很大，则类的方法可能会更好。 而对于处理简单操作的情况，函数方法可能会更好。
 
+
+**************
 动态类型
---------------
+**************
 
 Python是动态类型语言，这意味着变量并没有固定的类型。实际上，Python 中的变量和其他
 语言有很大的不同，特别是静态类型语言。变量并不是计算机内存中被写入的某个值，它们
@@ -605,8 +617,9 @@ Python 的动态类型常被认为是它的缺点，的确这个特性会导致
 可变与不可变类型的概念。
 
 
+***************************
 可变和不可变类型
----------------------------
+***************************
 
 Python提供两种内置或用户定义的类型。可变类型允许内容的内部修改。典型的动态类型
 包括列表与字典：列表都有可变方法，如 :py:meth:`list.append` 和 :py:meth:`list.pop`，
@@ -617,7 +630,7 @@ Python提供两种内置或用户定义的类型。可变类型允许内容的
 
     my_list = [1, 2, 3]
     my_list[0] = 4
-    print my_list  # [4, 2, 3] <- 原列表改变了
+    print(my_list)  # [4, 2, 3] <- 原列表改变了
 
     x = 6
     x = x + 1  # x 变量是一个新的变量
@@ -625,12 +638,13 @@ Python提供两种内置或用户定义的类型。可变类型允许内容的
 
 这种差异导致的一个后果就是，可变类型是不 '稳定 '的，因而不能作为字典的键使用。合理地
 使用可变类型与不可变类型有助于阐明代码的意图。例如与列表相似的不可变类型是元组，
-创建方式为 ``(1, 2)``。元组是不可修改的，并能作为字典的键使用。
-
+创建方式为 ``(1, 2)``。元组本身是不可修改的，若里面所有元素都是不可变类型，则能作为字典的键使用。
 
-Python 中一个可能会让初学者惊讶的特性是：字符串是不可变类型。这意味着当需要组合一个
-字符串时，将每一部分放到一个可变列表里，使用字符串时再组合 ('join') 起来的做法更高效。
-值得注意的是，使用列表推导的构造方式比在循环中调用 ``append()`` 来构造列表更好也更快。
+Python 中一个可能会让初学者惊讶的特性是：字符串是不可变类型。这意味着, 
+在从字符串的各个部分构造字符串时, 将每个部分追加到字符串上是效率低下的,
+因为在每次追加时都会复制字符串的全部内容。
+反之，将每一部分放到一个可变列表里，需要使用字符串时再粘合 (``join``) 起来的做法更高效。
+列表推导通常是最快且最地道的方式来完成此目的。
 
 
 **差**
@@ -641,9 +655,9 @@ Python 中一个可能会让初学者惊讶的特性是：字符串是不可变
     nums = ""
     for n in range(20):
         nums += str(n)   # 慢且低效
-    print nums
+    print(nums)
 
-**好**
+**更好**
 
 .. code-block:: python
 
@@ -651,23 +665,15 @@ Python 中一个可能会让初学者惊讶的特性是：字符串是不可变
     nums = []
     for n in range(20):
         nums.append(str(n))
-    print "".join(nums)  # 更高效
+    print("".join(nums))  # 更高效
 
-**更好**
+**最好**
 
 .. code-block:: python
 
     # 创建将0到19连接起来的字符串 (例 "012..1819")
     nums = [str(n) for n in range(20)]
-    print "".join(nums)
-
-**最好Best**
-
-.. code-block:: python
-
-    # 创建将0到19连接起来的字符串 (例 "012..1819")
-    nums = map(str, range(20))
-    print "".join(nums) 
+    print("".join(nums))
 
 
 最后关于字符串的说明的一点是，使用 ``join()`` 并不总是最好的选择。比如当用预先
@@ -700,16 +706,19 @@ Python 中一个可能会让初学者惊讶的特性是：字符串是不可变
     foobar = '{foo}{bar}'.format(foo=foo, bar=bar) # 最好
 
 
+************************
 提供依赖关系
-------------------------
+************************
 
 
+*******
 Runners
--------
+*******
 
 
+***************
 更多阅读
----------------
+***************
 
-- http://docs.python.org/2/library/
-- http://www.diveintopython.net/toc/index.html
+- http://docs.python.org/3/library/
+- https://diveintopython3.net/
diff --git a/docs/writing/style.rst b/docs/writing/style.rst
index 7bdfe90..4eec944 100644
--- a/docs/writing/style.rst
+++ b/docs/writing/style.rst
@@ -1,7 +1,9 @@
 .. _code_style:
 
+
+##########
 代码风格
-==========
+##########
 
 .. image:: https://farm5.staticflickr.com/4223/33907150054_5ee79e8940_k_d.jpg
 
@@ -19,8 +21,10 @@ Python代码具有高可读性的其中一个原因是它的相对完整的代
 在某些边缘情况下，Python代码中并没有大家都认同的表达意图的最佳方式，但这些情况
 都很少见。
 
+
+****************
 一般概念
-----------------
+****************
 
 明确的代码
 ~~~~~~~~~~~~~
@@ -56,9 +60,9 @@ Python代码具有高可读性的其中一个原因是它的相对完整的代
 
 .. code-block:: python
 
-    print 'one'; print 'two'
+    print('one'); print('two')
 
-    if x == 1: print 'one'
+    if x == 1: print('one')
 
     if <complex comparison> and <other complex comparison>:
         # do something
@@ -67,11 +71,11 @@ Python代码具有高可读性的其中一个原因是它的相对完整的代
 
 .. code-block:: python
 
-    print 'one'
-    print 'two'
+    print('one')
+    print('two')
 
     if x == 1:
-        print 'one'
+        print('one')
 
     cond1 = <complex comparison>
     cond2 = <other complex comparison>
@@ -213,8 +217,10 @@ pyflakes，将无法解析这种“魔法”代码。
            # 一些关于x的计算的Plan-B
        return x  # 返回值x只有一个出口点有利于维护代码
 
+
+******************
 习语（Idiom）
-------------------
+******************
 
 编程习语，说得简单些，就是写代码的 *方式*。编程习语的概念在 `c2 <http://c2.
 com/cgi/wiki?ProgrammingIdiom>`_ 和 `Stack Overflow <http://stackoverflow.
@@ -297,9 +303,7 @@ com/questions/302459/what-is-a-programming-idiom>`_ 上有充足的讨论。
 
 .. code-block:: python
 
-    four_lists = [[] for __ in xrange(4)]
-
-注意：在 Python 3 中使用 range() 而不是 xrange()
+    four_lists = [[] for __ in range(4)]
 
 根据列表来创建字符串
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -336,7 +340,7 @@ com/questions/302459/what-is-a-programming-idiom>`_ 上有充足的讨论。
 每个项直到它找到匹配的项。这是耗时的，尤其是对长列表而言。另一方面，在集合中，
 项的哈希值将会告诉Python在集合的哪里去查找匹配的项。结果是，即使集合很大，查询
 的速度也很快。在字典中查询也是同样的原理。想了解更多内容，请见
-`StackOverflow <http://stackoverflow.com/questions/513882/python-list-vs-dict-for-look-up-table>`_ 。想了解在每种数据结构上的多种常见操作的花费时间的详细内容，
+`StackOverflow <https://stackoverflow.com/questions/513882/python-list-vs-dict-for-look-up-table>`_ 。想了解在每种数据结构上的多种常见操作的花费时间的详细内容，
 请见 `此页面 <https://wiki.python.org/moin/TimeComplexity?>`_。
 
 因为这些性能上的差异，在下列场合在使用集合或者字典而不是列表，通常会是个好主意：
@@ -351,8 +355,9 @@ com/questions/302459/what-is-a-programming-idiom>`_ 上有充足的讨论。
 开销经常会大过改进搜索速度所节省的时间。
 
 
+*************
 Python之禅
--------------
+*************
 
 又名 :pep:`20`, Python设计的指导原则。
 
@@ -400,16 +405,18 @@ Python之禅
     命名空间是一种绝妙的理念，我们应当多加利用（倡导与号召）
 
 想要了解一些Python优雅风格的例子，请见 `这些来自于Python用户的幻灯片 
-<http://artifex.org/~hblanks/talks/2011/pep20_by_example.pdf>`_.
+<https://github.com/hblanks/zen-of-python-by-example>`_.
+
 
+
+*****
 PEP 8
------
+*****
 
 :pep:`8` 是Python事实上的代码风格指南，我们可以在 `pep8.org <http://pep8.org/>`_
-上获得高质量的、一度的PEP 8版本。
+上获得高质量的、易读的PEP 8版本。
 
-强烈推荐阅读这部分。整个Python社区都尽力遵循本文档中规定的准则。一些项目可能受其影响，
-而其他项目可能 `修改其建议 <http://docs.python-equests.org/en/master/dev/contributing/kenneth-reitz-s-code-style>`_。
+强烈推荐阅读这部分。整个Python社区都尽力遵循本文档中规定的准则。一些项目可能受其影响，而其他项目可能修改其建议。
 
 也就是说，让您的 Python 代码遵循 PEP 8 通常是个好主意，这也有助于在与其他开发人员
 一起工作时使代码更加具有可持续性。命令行程序 pycodestyle `<https://github.com/PyCQA/pycodestyle>`_ 
@@ -433,24 +440,67 @@ PEP 8
     optparse.py:472:29: E221 multiple spaces before operator
     optparse.py:544:21: W601 .has_key() is deprecated, use 'in'
 
-程序 `autopep8 <https://pypi.python.org/pypi/autopep8/>`_ 能自动将代码格式化
-成 PEP 8 风格。用以下指令安装此程序：
+自动格式化
+~~~~~~~~~~~~~~~~~~
+
+有许多满足PEP 8规范的自动格式化代码工具。
+
+**autopep8**
+
+`autopep8 <https://pypi.org/project/autopep8/>`_ 程序能自动将代码格式化
+成 PEP 8 风格。用以下命令安装此程序：
 
 .. code-block:: console
 
     $ pip install autopep8
 
-用以下指令格式化一个文件：
+用以下命令格式化一个文件：
 
 .. code-block:: console
 
     $ autopep8 --in-place optparse.py
 
-不包含 ``--in-place`` 标志将会使得程序直接将更改的代码输出到控制台，以供审查。
+不包含 ``--in-place`` 选项将会使得程序直接将更改的代码输出到控制台，以供审查。
 ``--aggressive`` 标志则会执行更多实质性的变化，而且可以多次使用以达到更佳的效果。
 
+**yapf**
+
+autopep8专注于解决PEP 8的合规性，而 `yapf <https://github.com/google/yapf>`_ 除了满足PEP 8规范，还能够优化代码格式。
+它旨在提供编写PEP 8兼容代码的同时还能保持美观。用以下命令安装此程序:
+
+.. code-block:: console
+
+    $ pip install yapf
+
+用以下命令格式化一个文件:
+
+.. code-block:: console
+
+    $ yapf --in-place optparse.py
+
+与 autopep8 类似，运行不带 ``--in-place`` 选项的命令将输出差异以供审查，而不会应用格式化结果。
+
+**black**
+
+自动格式化程序 `black <https://github.com/psf/black>`_ 对代码库进行确定的格式化。
+它专注于提供统一的代码风格，而无需用户进行配置。因此，black 的用户可以完全忘记格式化。
+此外，得益于确定的实现，可以保证git diff时只有最小化的改动。用以下命令安装此程序:
+
+.. code-block:: console
+
+    $ pip install black
+
+用以下命令格式化一个文件:
+
+.. code-block:: console
+
+    $ black optparse.py
+
+添加 ``--diff`` 选项的命令将输出差异以供审查，而不会应用格式化结果。
+
+***********
 约定
-----------------
+***********
 
 这里有一些您应该遵循的约定，以让您的代码更加易读。
 
@@ -466,10 +516,10 @@ PEP 8
 .. code-block:: python
 
     if attr == True:
-        print 'True!'
+        print('True!')
 
     if attr == None:
-        print 'attr is None!'
+        print('attr is None!')
 
 **优雅**:
 
@@ -477,15 +527,15 @@ PEP 8
 
     # 检查值
     if attr:
-        print 'attr is truthy!'
+        print('attr is truthy!')
 
     # 或者做相反的检查
     if not attr:
-        print 'attr is falsey!'
+        print('attr is falsey!')
 
     # or, since None is considered false, explicitly check for it
     if attr is None:
-        print 'attr is None!'
+        print('attr is None!')
 
 访问字典元素
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -499,9 +549,9 @@ PEP 8
 
     d = {'hello': 'world'}
     if d.has_key('hello'):
-        print d['hello']    # 打印 'world'
+        print(d['hello'])    # 打印 'world'
     else:
-        print 'default_value'
+        print('default_value')
 
 **优雅**:
 
@@ -509,59 +559,147 @@ PEP 8
 
     d = {'hello': 'world'}
 
-    print d.get('hello', 'default_value') # 打印 'world'
-    print d.get('thingy', 'default_value') # 打印 'default_value'
+    print(d.get('hello', 'default_value')) # 打印 'world'
+    print(d.get('thingy', 'default_value')) # 打印 'default_value'
 
     # Or:
     if 'hello' in d:
-        print d['hello']
+        print(d['hello'])
 
 维护列表的捷径
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 `列表推导
 <http://docs.python.org/tutorial/datastructures.html#list-comprehensions>`_
-提供了一个强大的而又简洁的方式来处理列表。而且， :py:func:`map` 和 
-:py:func:`filter` 函数用用一种不同且更简洁的语法处理列表。
+提供了一个强大的而又简洁的方式来处理列表。
 
+`生成器表达式
+<http://docs.python.org/tutorial/classes.html#generator-expressions>`_
+遵循和列表推导几乎相同的语法，但是返回生成器而非列表。
+
+创建一个新的列表需要更多的工作，也需要使用更多的内存。如果你只是遍历这个列表，更好地方式是使用迭代器。
 
 **糟糕**:
 
+.. code-block:: python
+
+    # 不必要地在内存中分配了包含所有对象（gpa, name）的列表
+    valedictorian = max([(student.gpa, student.name) for student in graduates])
+
+**优雅**:
+
+.. code-block:: python
+
+    valedictorian = max((student.gpa, student.name) for student in graduates)
+
+当你确实想要创建新的列表时，比如要多次使用结果，那么就使用列表推导。
+
+如果你的逻辑太过复杂，无法用简短的列表推导或者生成器来简洁地表达，请考虑使用生成器函数而非返回一个列表。
+
+**Good**:
+
+.. code-block:: python
+
+    def make_batches(items, batch_size):
+        """
+        >>> list(make_batches([1, 2, 3, 4, 5], batch_size=3))
+        [[1, 2, 3], [4, 5]]
+        """
+        current_batch = []
+        for item in items:
+            current_batch.append(item)
+            if len(current_batch) == batch_size:
+                yield current_batch
+                current_batch = []
+        yield current_batch
+
+永远不要为了列表推导的副作用而使用它。
+
+**糟糕**:
+
+.. code-block:: python
+
+    [print(x) for x in sequence]
+
+**优雅**:
+
+.. code-block:: python
+
+    for x in sequence:
+        print(x) 
+
+
+过滤列表
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**糟糕**:
+
+在迭代列表的过程中，永远不要从列表中移除元素。
+
 .. code-block:: python
 
     # 过滤大于 4 的元素
     a = [3, 4, 5]
-    b = []
     for i in a:
         if i > 4:
-            b.append(i)
+            a.remove(i)
+
+不要在列表中多次遍历。
+
+.. code-block:: python
+
+    while i in a:
+        a.remove(i)
 
 **优雅**:
 
+使用列表推导，或生成器表达式。
+
 .. code-block:: python
 
-    a = [3, 4, 5]
-    b = [i for i in a if i > 4]
-    # Or:
-    b = filter(lambda x: x > 4, a)
+    # 推导创建了一个新的列表对象
+    filtered_values = [value for value in sequence if value != x]
+
+    # 生成器不会创建新的列表
+    filtered_values = (value for value in sequence if value != x)
+
+修改原始列表可能产生的副作用
+::::::::::::::::::::::::::::::::::::::::::::::::::::
+
+如果有其他变量引用原始列表，则修改它可能会有风险。但如果你真的想这样做，你可以使用 *切片赋值（slice assignment）* 。
+
+.. code-block:: python
+
+    # 修改原始列表的内容
+    sequence[::] = [value for value in sequence if value != x]
+
+在列表中修改值
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **糟糕**:
 
+请记住，赋值永远不会创建新对象。如果两个或多个变量引用相同的列表，则修改其中一个变量意味着将修改所有变量。
+
 .. code-block:: python
 
     # 所有的列表成员都加 3
     a = [3, 4, 5]
+    b = a                     # a 和 b 都指向一个列表独享
+    
     for i in range(len(a)):
-        a[i] += 3
+        a[i] += 3             # b[i] 也改变了
 
 **优雅**:
 
+创建一个新的列表对象并保留原始列表对象会更安全。
+
 .. code-block:: python
 
     a = [3, 4, 5]
+    b = a
+    
+    # 给变量 "a" 赋值新的列表，而不改变 "b"
     a = [i + 3 for i in a]
-    # Or:
-    a = map(lambda i: i + 3, a)
 
 使用 :py:func:`enumerate` 获得列表中的当前位置的计数。
 
@@ -569,7 +707,7 @@ PEP 8
 
     a = [3, 4, 5]
     for i, item in enumerate(a):
-        print i, item
+        print(i, item)
     # 打印
     # 0 3
     # 1 4
@@ -589,7 +727,7 @@ PEP 8
 
     f = open('file.txt')
     a = f.read()
-    print a
+    print(a)
     f.close()
 
 **优雅**:
@@ -598,7 +736,7 @@ PEP 8
 
     with open('file.txt') as f:
         for line in f:
-            print line
+            print(line)
 
 ``with`` 语句会更好，因为它能确保您总是关闭文件，即使是在 ``with`` 的区块中
 抛出一个异常。
diff --git a/docs/writing/tests.rst b/docs/writing/tests.rst
index c5f5a72..50e42be 100644
--- a/docs/writing/tests.rst
+++ b/docs/writing/tests.rst
@@ -1,5 +1,7 @@
+
+#################
 测试您的代码
-=================
+#################
 
 .. image:: https://farm5.staticflickr.com/4166/34435687940_8f73fc1fa6_k_d.jpg
 
@@ -13,21 +15,21 @@
 - 测试单元应该集中于小部分的功能，并且证明它是对的。
 
 - 每个测试单元必须完全独立。他们都能够单独运行，也可以在测试套件中运行，而不用考虑被调用的顺序。
-  要想实现这个规则，测试单元应该加载最新的数据集，之后再做一些清理。
-  这通常用方法 :meth:`setUp()` 和 :meth:`tearDown()` 处理。 
+  这个规则意味着每次测试应该加载全新的数据集，测试后再做一些清理。
+  这通常由 :meth:`setUp()` 和 :meth:`tearDown()` 方法处理。 
 
 - 尽量使测试单元快速运行。如果一个单独的测试单元需要较长的时间去运行，开发进度将会延迟，
-  测试单元将不能如期常态性运行。有时候，因为测试单元需要复杂的数据结构，
-  并且当它运行时每次都要加载，所以其运行时间较长。把运行吃力的测试单元放在单独的测试组件中，
+  测试将无法按照需要的频率运行。有时候，因为测试单元需要复杂的数据结构，
+  并且当它运行时每次都要加载，所以其运行时间较长。把运行吃力的测试单元放在单独的测试组件中由调度任务运行，
   并且按照需要运行其它测试单元。
 
 - 学习使用工具，学习如何运行一个单独的测试用例。然后，当在一个模块中开发了一个功能时，
   经常运行这个功能的测试用例，理想情况下，一切都将自动。
 
-- 在编码会话前后，要常常运行完整的测试组件。只有这样，您才会坚信剩余的代码不会中断。
+- 在编码环节前后，要常常运行完整的测试组件。只有这样，您才会坚信没有破坏其他代码的功能。
 
-- 实现钩子（hook）是一个非常好的主意。因为一旦把代码放入分享仓库中，
-  这个钩子可以运行所有的测试单元。
+- 通过钩子（hook）实现一旦把代码放入分享仓库中，
+  立刻运行所有的测试单元，这是个好办法。
 
 - 如果您在开发期间不得不打断自己的工作，写一个被打断的单元测试，它关于下一步要开发的东西。
   当回到工作时，您将更快地回到原先被打断的地方，并且步入正轨。
@@ -38,7 +40,7 @@
 - 测试函数使用长且描述性的名字。这边的样式指导与运行代码有点不一样，运行代码更倾向于使用短的名字，
   而测试函数不会直接被调用。在运行代码中，square()或者甚至sqr()这样的命名都是可以的，
   但是在测试代码中，您应该这样取名test_square_of_number_2()，test_square_negative_number()。
-  当测试单元失败时，函数名应该显示，而且尽可能具有描述性。
+  函数名在测试单元失败时会显示，应该尽可能具有描述性。
 
 - 当发生了一些问题，或者不得不改变时，如果代码中有一套不错的测试单元，
   维护将很大一部分依靠测试组件解决问题，或者修改确定的行为。因此测试代码应该尽可能多读，
@@ -48,14 +50,16 @@
   运行并且阅读相关的测试代码是最好的做法。他们会或者应该发现大多数困难出现的热点，以及边界的情况。
   如果他们必须添加一些功能，第一步应该是添加一个测试，以确保新的功能不是一个尚未插入到界面的工作路径。
 
+
+**********
 基本
-::::::::::
+**********
 
 
 单元测试
 --------
 
-:mod:`unittest` 包括Python标准库中的测试模型。任何一个使用过Junit，nUnit,或CppUnit工具的人对它的API都会比较熟悉。
+:mod:`unittest` 包括Python标准库中自带的测试模块。任何一个使用过Junit，nUnit,或CppUnit工具的人对它的API都会比较熟悉。
 
 创建测试用例通过继承 :class:`unittest.TestCase` 来实现.
 
@@ -70,7 +74,7 @@
         def test(self):
             self.assertEqual(fun(3), 4)
 
-因为Python 2.7单元测试也包括自己的发现机制。
+截至Python 2.7，单元测试也包括自己的发现机制。
 
     `在标准库文档中单元测试 <http://docs.python.org/library/unittest.html>`_
 
@@ -78,7 +82,7 @@
 文档测试
 --------------
 
- :mod:`doctest` 模块查找零碎文本，就像在Python中docstrings内的交互式会话，执行那些会话以证实工作正常。
+ :mod:`doctest` 模块查找docstrings中看起来像交互式Python会话的零碎文本，执行那些会话以证实工作正常。
 
 doctest模块的用例相比之前的单元测试有所不同：它们通常不是很详细，并且不会用特别的用例或者处理模糊的回归bug。作为模块和其部件主要用例的表述性文档，doctest模块非常有用。
 
@@ -103,8 +107,10 @@ doctest模块的用例相比之前的单元测试有所不同：它们通常不
 
 当使用 ``python module.py`` 这样的命令行运行这个模块时，doctest将会运行，并会在结果不和文档字符串的描述一致时报错。
 
+
+*****
 工具
-:::::
+*****
 
 
 py.test
@@ -198,30 +204,6 @@ tox允许通过简单的初始化样式配置文件，配置复杂的多参数
 
     `tox <https://tox.readthedocs.io/en/latest/>`_
 
-Unittest2
----------
-
-Unittest2是Python2.7中unittest模型的补丁，它的API有所改善，并且对Python之前版本中已有的内容有了更好的说明。
-
-如果使用Python2.6版本或者以下，需要使用pip安装unittest2。
-
-.. code-block:: console
-
-    $ pip install unittest2
-
-将来您可能想要以unittest之名导入模块，目的是更容易地把代码移植到新的版本中。
-
-.. code-block:: python
-
-    import unittest2 as unittest
-
-    class MyTest(unittest.TestCase):
-        ...
-
-如果切换到新的Python版本，并且不再需要unittest2模块，您只需要在测试模块中改变import内容，而不必改变其它代码。
-
-    `unittest2 <http://pypi.python.org/pypi/unittest2>`_
-
 
 mock
 ----
@@ -229,7 +211,7 @@ mock
 :mod:`unittest.mock` 是Python中用于测试的一个库。在Python3.3版本中，标准库中就有。
 `标准库 <https://docs.python.org/dev/library/unittest.mock>`_.
 
-对于Python相对早的版本，如下操作：
+对于Python早期版本，如下操作：
 
 .. code-block:: console
 
@@ -238,7 +220,7 @@ mock
 在测试环境下，使用mock对象能够替换部分系统，并且对它们如何被使用做了声明。
 例如，您可以对一个方法打猴子补丁：
 
-例如，您可以对一个方法打猴子补丁：
+
 
 .. code-block:: python
 
diff --git a/pyproject.toml b/pyproject.toml
new file mode 100644
index 0000000..a2ee97b
--- /dev/null
+++ b/pyproject.toml
@@ -0,0 +1,14 @@
+[project]
+name = "python-guide-cn"
+version = "0.0.0"
+description = "Chinese translation of The Hitchhiker's Guide to Python"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "sphinx>=7.4,<8",
+    "sphinx-sitemap>=2.9,<3",
+    "sphinxcontrib-websupport>=2,<3",
+]
+
+[tool.uv]
+package = false
diff --git a/requirements-to-freeze.txt b/requirements-to-freeze.txt
deleted file mode 100644
index 1b3a6e8..0000000
--- a/requirements-to-freeze.txt
+++ /dev/null
@@ -1 +0,0 @@
-sphinx
\ No newline at end of file
diff --git a/requirements.txt b/requirements.txt
deleted file mode 100644
index dcff488..0000000
--- a/requirements.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-alabaster==0.7.7
-Babel==2.2.0
-docutils==0.12
-Jinja2==2.8
-MarkupSafe==0.23
-Pygments==2.1.1
-pytz==2015.7
-six==1.10.0
-snowballstemmer==1.2.1
-Sphinx==1.3.5
-sphinx-rtd-theme==0.1.9
-wheel==0.29.0
\ No newline at end of file
diff --git a/uv.lock b/uv.lock
new file mode 100644
index 0000000..e6ad409
--- /dev/null
+++ b/uv.lock
@@ -0,0 +1,401 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "alabaster"
+version = "0.7.16"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/3e/13dd8e5ed9094e734ac430b5d0eb4f2bb001708a8b7856cbf8e084e001ba/alabaster-0.7.16.tar.gz", hash = "sha256:75a8b99c28a5dad50dd7f8ccdd447a121ddb3892da9e53d1ca5cca3106d58d65", size = 23776, upload-time = "2024-01-10T00:56:10.189Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/32/34/d4e1c02d3bee589efb5dfa17f88ea08bdb3e3eac12bc475462aec52ed223/alabaster-0.7.16-py3-none-any.whl", hash = "sha256:b46733c07dce03ae4e150330b975c75737fa60f0a7c591b6c8bf4928a28e2c92", size = 13511, upload-time = "2024-01-10T00:56:08.388Z" },
+]
+
+[[package]]
+name = "babel"
+version = "2.18.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/b2/51899539b6ceeeb420d40ed3cd4b7a40519404f9baf3d4ac99dc413a834b/babel-2.18.0.tar.gz", hash = "sha256:b80b99a14bd085fcacfa15c9165f651fbb3406e66cc603abf11c5750937c992d", size = 9959554, upload-time = "2026-02-01T12:30:56.078Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/77/f5/21d2de20e8b8b0408f0681956ca2c69f1320a3848ac50e6e7f39c6159675/babel-2.18.0-py3-none-any.whl", hash = "sha256:e2b422b277c2b9a9630c1d7903c2a00d0830c409c59ac8cae9081c92f1aeba35", size = 10196845, upload-time = "2026-02-01T12:30:53.445Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.5.20"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f3/ce/ee2ecad540810a79593028e88299baeae54d346cc7a0d94b6199988b89b1/certifi-2026.5.20.tar.gz", hash = "sha256:69dea482ab64caa7b9f6aba1c6bf48bb6a5448d1c0f1b17ab42ad8c763a5344d", size = 135422, upload-time = "2026-05-20T11:46:50.073Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/59/8c/57e832b7af6d7c5abe66eb3fbe3a3a32f4d11ea23a1aa7131371035be991/certifi-2026.5.20-py3-none-any.whl", hash = "sha256:3c52e209ba0a4ad7aebe60436a4ab349c39e1e602e8c134221e546902ad25897", size = 134134, upload-time = "2026-05-20T11:46:48.578Z" },
+]
+
+[[package]]
+name = "charset-normalizer"
+version = "3.4.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e7/a1/67fe25fac3c7642725500a3f6cfe5821ad557c3abb11c9d20d12c7008d3e/charset_normalizer-3.4.7.tar.gz", hash = "sha256:ae89db9e5f98a11a4bf50407d4363e7b09b31e55bc117b4f7d80aab97ba009e5", size = 144271, upload-time = "2026-04-02T09:28:39.342Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/eb/4fc8d0a7110eb5fc9cc161723a34a8a6c200ce3b4fbf681bc86feee22308/charset_normalizer-3.4.7-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:eca9705049ad3c7345d574e3510665cb2cf844c2f2dcfe675332677f081cbd46", size = 311328, upload-time = "2026-04-02T09:26:24.331Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/e3/0fadc706008ac9d7b9b5be6dc767c05f9d3e5df51744ce4cc9605de7b9f4/charset_normalizer-3.4.7-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6178f72c5508bfc5fd446a5905e698c6212932f25bcdd4b47a757a50605a90e2", size = 208061, upload-time = "2026-04-02T09:26:25.568Z" },
+    { url = "https://files.pythonhosted.org/packages/42/f0/3dd1045c47f4a4604df85ec18ad093912ae1344ac706993aff91d38773a2/charset_normalizer-3.4.7-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e1421b502d83040e6d7fb2fb18dff63957f720da3d77b2fbd3187ceb63755d7b", size = 229031, upload-time = "2026-04-02T09:26:26.865Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/67/675a46eb016118a2fbde5a277a5d15f4f69d5f3f5f338e5ee2f8948fcf43/charset_normalizer-3.4.7-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:edac0f1ab77644605be2cbba52e6b7f630731fc42b34cb0f634be1a6eface56a", size = 225239, upload-time = "2026-04-02T09:26:28.044Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/f8/d0118a2f5f23b02cd166fa385c60f9b0d4f9194f574e2b31cef350ad7223/charset_normalizer-3.4.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5649fd1c7bade02f320a462fdefd0b4bd3ce036065836d4f42e0de958038e116", size = 216589, upload-time = "2026-04-02T09:26:29.239Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/f1/6d2b0b261b6c4ceef0fcb0d17a01cc5bc53586c2d4796fa04b5c540bc13d/charset_normalizer-3.4.7-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:203104ed3e428044fd943bc4bf45fa73c0730391f9621e37fe39ecf477b128cb", size = 202733, upload-time = "2026-04-02T09:26:30.5Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/c0/7b1f943f7e87cc3db9626ba17807d042c38645f0a1d4415c7a14afb5591f/charset_normalizer-3.4.7-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:298930cec56029e05497a76988377cbd7457ba864beeea92ad7e844fe74cd1f1", size = 212652, upload-time = "2026-04-02T09:26:31.709Z" },
+    { url = "https://files.pythonhosted.org/packages/38/dd/5a9ab159fe45c6e72079398f277b7d2b523e7f716acc489726115a910097/charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:708838739abf24b2ceb208d0e22403dd018faeef86ddac04319a62ae884c4f15", size = 211229, upload-time = "2026-04-02T09:26:33.282Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/ff/531a1cad5ca855d1c1a8b69cb71abfd6d85c0291580146fda7c82857caa1/charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:0f7eb884681e3938906ed0434f20c63046eacd0111c4ba96f27b76084cd679f5", size = 203552, upload-time = "2026-04-02T09:26:34.845Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/4c/a5fb52d528a8ca41f7598cb619409ece30a169fbdf9cdce592e53b46c3a6/charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:4dc1e73c36828f982bfe79fadf5919923f8a6f4df2860804db9a98c48824ce8d", size = 230806, upload-time = "2026-04-02T09:26:36.152Z" },
+    { url = "https://files.pythonhosted.org/packages/59/7a/071feed8124111a32b316b33ae4de83d36923039ef8cf48120266844285b/charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:aed52fea0513bac0ccde438c188c8a471c4e0f457c2dd20cdbf6ea7a450046c7", size = 212316, upload-time = "2026-04-02T09:26:37.672Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/35/f7dba3994312d7ba508e041eaac39a36b120f32d4c8662b8814dab876431/charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:fea24543955a6a729c45a73fe90e08c743f0b3334bbf3201e6c4bc1b0c7fa464", size = 227274, upload-time = "2026-04-02T09:26:38.93Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/2d/a572df5c9204ab7688ec1edc895a73ebded3b023bb07364710b05dd1c9be/charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:bb6d88045545b26da47aa879dd4a89a71d1dce0f0e549b1abcb31dfe4a8eac49", size = 218468, upload-time = "2026-04-02T09:26:40.17Z" },
+    { url = "https://files.pythonhosted.org/packages/86/eb/890922a8b03a568ca2f336c36585a4713c55d4d67bf0f0c78924be6315ca/charset_normalizer-3.4.7-cp312-cp312-win32.whl", hash = "sha256:2257141f39fe65a3fdf38aeccae4b953e5f3b3324f4ff0daf9f15b8518666a2c", size = 148460, upload-time = "2026-04-02T09:26:41.416Z" },
+    { url = "https://files.pythonhosted.org/packages/35/d9/0e7dffa06c5ab081f75b1b786f0aefc88365825dfcd0ac544bdb7b2b6853/charset_normalizer-3.4.7-cp312-cp312-win_amd64.whl", hash = "sha256:5ed6ab538499c8644b8a3e18debabcd7ce684f3fa91cf867521a7a0279cab2d6", size = 159330, upload-time = "2026-04-02T09:26:42.554Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/5d/481bcc2a7c88ea6b0878c299547843b2521ccbc40980cb406267088bc701/charset_normalizer-3.4.7-cp312-cp312-win_arm64.whl", hash = "sha256:56be790f86bfb2c98fb742ce566dfb4816e5a83384616ab59c49e0604d49c51d", size = 147828, upload-time = "2026-04-02T09:26:44.075Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/3b/66777e39d3ae1ddc77ee606be4ec6d8cbd4c801f65e5a1b6f2b11b8346dd/charset_normalizer-3.4.7-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:f496c9c3cc02230093d8330875c4c3cdfc3b73612a5fd921c65d39cbcef08063", size = 309627, upload-time = "2026-04-02T09:26:45.198Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/4e/b7f84e617b4854ade48a1b7915c8ccfadeba444d2a18c291f696e37f0d3b/charset_normalizer-3.4.7-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ea948db76d31190bf08bd371623927ee1339d5f2a0b4b1b4a4439a65298703c", size = 207008, upload-time = "2026-04-02T09:26:46.824Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/bb/ec73c0257c9e11b268f018f068f5d00aa0ef8c8b09f7753ebd5f2880e248/charset_normalizer-3.4.7-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a277ab8928b9f299723bc1a2dabb1265911b1a76341f90a510368ca44ad9ab66", size = 228303, upload-time = "2026-04-02T09:26:48.397Z" },
+    { url = "https://files.pythonhosted.org/packages/85/fb/32d1f5033484494619f701e719429c69b766bfc4dbc61aa9e9c8c166528b/charset_normalizer-3.4.7-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:3bec022aec2c514d9cf199522a802bd007cd588ab17ab2525f20f9c34d067c18", size = 224282, upload-time = "2026-04-02T09:26:49.684Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/07/330e3a0dda4c404d6da83b327270906e9654a24f6c546dc886a0eb0ffb23/charset_normalizer-3.4.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e044c39e41b92c845bc815e5ae4230804e8e7bc29e399b0437d64222d92809dd", size = 215595, upload-time = "2026-04-02T09:26:50.915Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/7c/fc890655786e423f02556e0216d4b8c6bcb6bdfa890160dc66bf52dee468/charset_normalizer-3.4.7-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:f495a1652cf3fbab2eb0639776dad966c2fb874d79d87ca07f9d5f059b8bd215", size = 201986, upload-time = "2026-04-02T09:26:52.197Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/97/bfb18b3db2aed3b90cf54dc292ad79fdd5ad65c4eae454099475cbeadd0d/charset_normalizer-3.4.7-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e712b419df8ba5e42b226c510472b37bd57b38e897d3eca5e8cfd410a29fa859", size = 211711, upload-time = "2026-04-02T09:26:53.49Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/a5/a581c13798546a7fd557c82614a5c65a13df2157e9ad6373166d2a3e645d/charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:7804338df6fcc08105c7745f1502ba68d900f45fd770d5bdd5288ddccb8a42d8", size = 210036, upload-time = "2026-04-02T09:26:54.975Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/bf/b3ab5bcb478e4193d517644b0fb2bf5497fbceeaa7a1bc0f4d5b50953861/charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:481551899c856c704d58119b5025793fa6730adda3571971af568f66d2424bb5", size = 202998, upload-time = "2026-04-02T09:26:56.303Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/4e/23efd79b65d314fa320ec6017b4b5834d5c12a58ba4610aa353af2e2f577/charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:f59099f9b66f0d7145115e6f80dd8b1d847176df89b234a5a6b3f00437aa0832", size = 230056, upload-time = "2026-04-02T09:26:57.554Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/9f/1e1941bc3f0e01df116e68dc37a55c4d249df5e6fa77f008841aef68264f/charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:f59ad4c0e8f6bba240a9bb85504faa1ab438237199d4cce5f622761507b8f6a6", size = 211537, upload-time = "2026-04-02T09:26:58.843Z" },
+    { url = "https://files.pythonhosted.org/packages/80/0f/088cbb3020d44428964a6c97fe1edfb1b9550396bf6d278330281e8b709c/charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:3dedcc22d73ec993f42055eff4fcfed9318d1eeb9a6606c55892a26964964e48", size = 226176, upload-time = "2026-04-02T09:27:00.437Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/9f/130394f9bbe06f4f63e22641d32fc9b202b7e251c9aef4db044324dac493/charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:64f02c6841d7d83f832cd97ccf8eb8a906d06eb95d5276069175c696b024b60a", size = 217723, upload-time = "2026-04-02T09:27:02.021Z" },
+    { url = "https://files.pythonhosted.org/packages/73/55/c469897448a06e49f8fa03f6caae97074fde823f432a98f979cc42b90e69/charset_normalizer-3.4.7-cp313-cp313-win32.whl", hash = "sha256:4042d5c8f957e15221d423ba781e85d553722fc4113f523f2feb7b188cc34c5e", size = 148085, upload-time = "2026-04-02T09:27:03.192Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/78/1b74c5bbb3f99b77a1715c91b3e0b5bdb6fe302d95ace4f5b1bec37b0167/charset_normalizer-3.4.7-cp313-cp313-win_amd64.whl", hash = "sha256:3946fa46a0cf3e4c8cb1cc52f56bb536310d34f25f01ca9b6c16afa767dab110", size = 158819, upload-time = "2026-04-02T09:27:04.454Z" },
+    { url = "https://files.pythonhosted.org/packages/68/86/46bd42279d323deb8687c4a5a811fd548cb7d1de10cf6535d099877a9a9f/charset_normalizer-3.4.7-cp313-cp313-win_arm64.whl", hash = "sha256:80d04837f55fc81da168b98de4f4b797ef007fc8a79ab71c6ec9bc4dd662b15b", size = 147915, upload-time = "2026-04-02T09:27:05.971Z" },
+    { url = "https://files.pythonhosted.org/packages/97/c8/c67cb8c70e19ef1960b97b22ed2a1567711de46c4ddf19799923adc836c2/charset_normalizer-3.4.7-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:c36c333c39be2dbca264d7803333c896ab8fa7d4d6f0ab7edb7dfd7aea6e98c0", size = 309234, upload-time = "2026-04-02T09:27:07.194Z" },
+    { url = "https://files.pythonhosted.org/packages/99/85/c091fdee33f20de70d6c8b522743b6f831a2f1cd3ff86de4c6a827c48a76/charset_normalizer-3.4.7-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1c2aed2e5e41f24ea8ef1590b8e848a79b56f3a5564a65ceec43c9d692dc7d8a", size = 208042, upload-time = "2026-04-02T09:27:08.749Z" },
+    { url = "https://files.pythonhosted.org/packages/87/1c/ab2ce611b984d2fd5d86a5a8a19c1ae26acac6bad967da4967562c75114d/charset_normalizer-3.4.7-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:54523e136b8948060c0fa0bc7b1b50c32c186f2fceee897a495406bb6e311d2b", size = 228706, upload-time = "2026-04-02T09:27:09.951Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/29/2b1d2cb00bf085f59d29eb773ce58ec2d325430f8c216804a0a5cd83cbca/charset_normalizer-3.4.7-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:715479b9a2802ecac752a3b0efa2b0b60285cf962ee38414211abdfccc233b41", size = 224727, upload-time = "2026-04-02T09:27:11.175Z" },
+    { url = "https://files.pythonhosted.org/packages/47/5c/032c2d5a07fe4d4855fea851209cca2b6f03ebeb6d4e3afdb3358386a684/charset_normalizer-3.4.7-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bd6c2a1c7573c64738d716488d2cdd3c00e340e4835707d8fdb8dc1a66ef164e", size = 215882, upload-time = "2026-04-02T09:27:12.446Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/c2/356065d5a8b78ed04499cae5f339f091946a6a74f91e03476c33f0ab7100/charset_normalizer-3.4.7-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:c45e9440fb78f8ddabcf714b68f936737a121355bf59f3907f4e17721b9d1aae", size = 200860, upload-time = "2026-04-02T09:27:13.721Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/cd/a32a84217ced5039f53b29f460962abb2d4420def55afabe45b1c3c7483d/charset_normalizer-3.4.7-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3534e7dcbdcf757da6b85a0bbf5b6868786d5982dd959b065e65481644817a18", size = 211564, upload-time = "2026-04-02T09:27:15.272Z" },
+    { url = "https://files.pythonhosted.org/packages/44/86/58e6f13ce26cc3b8f4a36b94a0f22ae2f00a72534520f4ae6857c4b81f89/charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:e8ac484bf18ce6975760921bb6148041faa8fef0547200386ea0b52b5d27bf7b", size = 211276, upload-time = "2026-04-02T09:27:16.834Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/fe/d17c32dc72e17e155e06883efa84514ca375f8a528ba2546bee73fc4df81/charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:a5fe03b42827c13cdccd08e6c0247b6a6d4b5e3cdc53fd1749f5896adcdc2356", size = 201238, upload-time = "2026-04-02T09:27:18.229Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/29/f33daa50b06525a237451cdb6c69da366c381a3dadcd833fa5676bc468b3/charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:2d6eb928e13016cea4f1f21d1e10c1cebd5a421bc57ddf5b1142ae3f86824fab", size = 230189, upload-time = "2026-04-02T09:27:19.445Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/6e/52c84015394a6a0bdcd435210a7e944c5f94ea1055f5cc5d56c5fe368e7b/charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e74327fb75de8986940def6e8dee4f127cc9752bee7355bb323cc5b2659b6d46", size = 211352, upload-time = "2026-04-02T09:27:20.79Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/d7/4353be581b373033fb9198bf1da3cf8f09c1082561e8e922aa7b39bf9fe8/charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:d6038d37043bced98a66e68d3aa2b6a35505dc01328cd65217cefe82f25def44", size = 227024, upload-time = "2026-04-02T09:27:22.063Z" },
+    { url = "https://files.pythonhosted.org/packages/30/45/99d18aa925bd1740098ccd3060e238e21115fffbfdcb8f3ece837d0ace6c/charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:7579e913a5339fb8fa133f6bbcfd8e6749696206cf05acdbdca71a1b436d8e72", size = 217869, upload-time = "2026-04-02T09:27:23.486Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/05/5ee478aa53f4bb7996482153d4bfe1b89e0f087f0ab6b294fcf92d595873/charset_normalizer-3.4.7-cp314-cp314-win32.whl", hash = "sha256:5b77459df20e08151cd6f8b9ef8ef1f961ef73d85c21a555c7eed5b79410ec10", size = 148541, upload-time = "2026-04-02T09:27:25.146Z" },
+    { url = "https://files.pythonhosted.org/packages/48/77/72dcb0921b2ce86420b2d79d454c7022bf5be40202a2a07906b9f2a35c97/charset_normalizer-3.4.7-cp314-cp314-win_amd64.whl", hash = "sha256:92a0a01ead5e668468e952e4238cccd7c537364eb7d851ab144ab6627dbbe12f", size = 159634, upload-time = "2026-04-02T09:27:26.642Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/a3/c2369911cd72f02386e4e340770f6e158c7980267da16af8f668217abaa0/charset_normalizer-3.4.7-cp314-cp314-win_arm64.whl", hash = "sha256:67f6279d125ca0046a7fd386d01b311c6363844deac3e5b069b514ba3e63c246", size = 148384, upload-time = "2026-04-02T09:27:28.271Z" },
+    { url = "https://files.pythonhosted.org/packages/94/09/7e8a7f73d24dba1f0035fbbf014d2c36828fc1bf9c88f84093e57d315935/charset_normalizer-3.4.7-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:effc3f449787117233702311a1b7d8f59cba9ced946ba727bdc329ec69028e24", size = 330133, upload-time = "2026-04-02T09:27:29.474Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/da/96975ddb11f8e977f706f45cddd8540fd8242f71ecdb5d18a80723dcf62c/charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fbccdc05410c9ee21bbf16a35f4c1d16123dcdeb8a1d38f33654fa21d0234f79", size = 216257, upload-time = "2026-04-02T09:27:30.793Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/e8/1d63bf8ef2d388e95c64b2098f45f84758f6d102a087552da1485912637b/charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:733784b6d6def852c814bce5f318d25da2ee65dd4839a0718641c696e09a2960", size = 234851, upload-time = "2026-04-02T09:27:32.44Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/40/e5ff04233e70da2681fa43969ad6f66ca5611d7e669be0246c4c7aaf6dc8/charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a89c23ef8d2c6b27fd200a42aa4ac72786e7c60d40efdc76e6011260b6e949c4", size = 233393, upload-time = "2026-04-02T09:27:34.03Z" },
+    { url = "https://files.pythonhosted.org/packages/be/c1/06c6c49d5a5450f76899992f1ee40b41d076aee9279b49cf9974d2f313d5/charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6c114670c45346afedc0d947faf3c7f701051d2518b943679c8ff88befe14f8e", size = 223251, upload-time = "2026-04-02T09:27:35.369Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/9f/f2ff16fb050946169e3e1f82134d107e5d4ae72647ec8a1b1446c148480f/charset_normalizer-3.4.7-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:a180c5e59792af262bf263b21a3c49353f25945d8d9f70628e73de370d55e1e1", size = 206609, upload-time = "2026-04-02T09:27:36.661Z" },
+    { url = "https://files.pythonhosted.org/packages/69/d5/a527c0cd8d64d2eab7459784fb4169a0ac76e5a6fc5237337982fd61347e/charset_normalizer-3.4.7-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3c9a494bc5ec77d43cea229c4f6db1e4d8fe7e1bbffa8b6f0f0032430ff8ab44", size = 220014, upload-time = "2026-04-02T09:27:38.019Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/80/8a7b8104a3e203074dc9aa2c613d4b726c0e136bad1cc734594b02867972/charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8d828b6667a32a728a1ad1d93957cdf37489c57b97ae6c4de2860fa749b8fc1e", size = 218979, upload-time = "2026-04-02T09:27:39.37Z" },
+    { url = "https://files.pythonhosted.org/packages/02/9a/b759b503d507f375b2b5c153e4d2ee0a75aa215b7f2489cf314f4541f2c0/charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:cf1493cd8607bec4d8a7b9b004e699fcf8f9103a9284cc94962cb73d20f9d4a3", size = 209238, upload-time = "2026-04-02T09:27:40.722Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/4e/0f3f5d47b86bdb79256e7290b26ac847a2832d9a4033f7eb2cd4bcf4bb5b/charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:0c96c3b819b5c3e9e165495db84d41914d6894d55181d2d108cc1a69bfc9cce0", size = 236110, upload-time = "2026-04-02T09:27:42.33Z" },
+    { url = "https://files.pythonhosted.org/packages/96/23/bce28734eb3ed2c91dcf93abeb8a5cf393a7b2749725030bb630e554fdd8/charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:752a45dc4a6934060b3b0dab47e04edc3326575f82be64bc4fc293914566503e", size = 219824, upload-time = "2026-04-02T09:27:43.924Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/6f/6e897c6984cc4d41af319b077f2f600fc8214eb2fe2d6bcb79141b882400/charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:8778f0c7a52e56f75d12dae53ae320fae900a8b9b4164b981b9c5ce059cd1fcb", size = 233103, upload-time = "2026-04-02T09:27:45.348Z" },
+    { url = "https://files.pythonhosted.org/packages/76/22/ef7bd0fe480a0ae9b656189ec00744b60933f68b4f42a7bb06589f6f576a/charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:ce3412fbe1e31eb81ea42f4169ed94861c56e643189e1e75f0041f3fe7020abe", size = 225194, upload-time = "2026-04-02T09:27:46.706Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/a7/0e0ab3e0b5bc1219bd80a6a0d4d72ca74d9250cb2382b7c699c147e06017/charset_normalizer-3.4.7-cp314-cp314t-win32.whl", hash = "sha256:c03a41a8784091e67a39648f70c5f97b5b6a37f216896d44d2cdcb82615339a0", size = 159827, upload-time = "2026-04-02T09:27:48.053Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/1d/29d32e0fb40864b1f878c7f5a0b343ae676c6e2b271a2d55cc3a152391da/charset_normalizer-3.4.7-cp314-cp314t-win_amd64.whl", hash = "sha256:03853ed82eeebbce3c2abfdbc98c96dc205f32a79627688ac9a27370ea61a49c", size = 174168, upload-time = "2026-04-02T09:27:49.795Z" },
+    { url = "https://files.pythonhosted.org/packages/de/32/d92444ad05c7a6e41fb2036749777c163baf7a0301a040cb672d6b2b1ae9/charset_normalizer-3.4.7-cp314-cp314t-win_arm64.whl", hash = "sha256:c35abb8bfff0185efac5878da64c45dafd2b37fb0383add1be155a763c1f083d", size = 153018, upload-time = "2026-04-02T09:27:51.116Z" },
+    { url = "https://files.pythonhosted.org/packages/db/8f/61959034484a4a7c527811f4721e75d02d653a35afb0b6054474d8185d4c/charset_normalizer-3.4.7-py3-none-any.whl", hash = "sha256:3dce51d0f5e7951f8bb4900c257dad282f49190fdbebecd4ba99bcc41fef404d", size = 61958, upload-time = "2026-04-02T09:28:37.794Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "docutils"
+version = "0.21.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ae/ed/aefcc8cd0ba62a0560c3c18c33925362d46c6075480bfa4df87b28e169a9/docutils-0.21.2.tar.gz", hash = "sha256:3a6b18732edf182daa3cd12775bbb338cf5691468f91eeeb109deff6ebfa986f", size = 2204444, upload-time = "2024-04-23T18:57:18.24Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8f/d7/9322c609343d929e75e7e5e6255e614fcc67572cfd083959cdef3b7aad79/docutils-0.21.2-py3-none-any.whl", hash = "sha256:dafca5b9e384f0e419294eb4d2ff9fa826435bf15f15b7bd45723e8ad76811b2", size = 587408, upload-time = "2024-04-23T18:57:14.835Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.18"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/63/9496c57188a2ee585e0f1db071d75089a11e98aa86eb99d9d7618fc1edce/idna-3.18.tar.gz", hash = "sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848", size = 196711, upload-time = "2026-06-02T14:34:07.794Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/5e/d4e9f1a599fb8e573b7b87160658329fbf28d19eac2718f51fc3def3aa5a/idna-3.18-py3-none-any.whl", hash = "sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2", size = 65455, upload-time = "2026-06-02T14:34:06.319Z" },
+]
+
+[[package]]
+name = "imagesize"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6c/e6/7bf14eeb8f8b7251141944835abd42eb20a658d89084b7e1f3e5fe394090/imagesize-2.0.0.tar.gz", hash = "sha256:8e8358c4a05c304f1fccf7ff96f036e7243a189e9e42e90851993c558cfe9ee3", size = 1773045, upload-time = "2026-03-03T14:18:29.941Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5f/53/fb7122b71361a0d121b669dcf3d31244ef75badbbb724af388948de543e2/imagesize-2.0.0-py2.py3-none-any.whl", hash = "sha256:5667c5bbb57ab3f1fa4bc366f4fbc971db3d5ed011fd2715fd8001f782718d96", size = 9441, upload-time = "2026-03-03T14:18:27.892Z" },
+]
+
+[[package]]
+name = "jinja2"
+version = "3.1.6"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markupsafe" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115, upload-time = "2025-03-05T20:05:02.478Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" },
+]
+
+[[package]]
+name = "markupsafe"
+version = "3.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313, upload-time = "2025-09-27T18:37:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/72/147da192e38635ada20e0a2e1a51cf8823d2119ce8883f7053879c2199b5/markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e", size = 11615, upload-time = "2025-09-27T18:36:30.854Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/81/7e4e08678a1f98521201c3079f77db69fb552acd56067661f8c2f534a718/markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce", size = 12020, upload-time = "2025-09-27T18:36:31.971Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/2c/799f4742efc39633a1b54a92eec4082e4f815314869865d876824c257c1e/markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d", size = 24332, upload-time = "2025-09-27T18:36:32.813Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/2e/8d0c2ab90a8c1d9a24f0399058ab8519a3279d1bd4289511d74e909f060e/markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d", size = 22947, upload-time = "2025-09-27T18:36:33.86Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/54/887f3092a85238093a0b2154bd629c89444f395618842e8b0c41783898ea/markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a", size = 21962, upload-time = "2025-09-27T18:36:35.099Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/2f/336b8c7b6f4a4d95e91119dc8521402461b74a485558d8f238a68312f11c/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b", size = 23760, upload-time = "2025-09-27T18:36:36.001Z" },
+    { url = "https://files.pythonhosted.org/packages/32/43/67935f2b7e4982ffb50a4d169b724d74b62a3964bc1a9a527f5ac4f1ee2b/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f", size = 21529, upload-time = "2025-09-27T18:36:36.906Z" },
+    { url = "https://files.pythonhosted.org/packages/89/e0/4486f11e51bbba8b0c041098859e869e304d1c261e59244baa3d295d47b7/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b", size = 23015, upload-time = "2025-09-27T18:36:37.868Z" },
+    { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540, upload-time = "2025-09-27T18:36:38.761Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105, upload-time = "2025-09-27T18:36:39.701Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906, upload-time = "2025-09-27T18:36:40.689Z" },
+    { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" },
+    { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" },
+    { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" },
+    { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" },
+    { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" },
+    { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" },
+    { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" },
+    { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" },
+    { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" },
+    { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619, upload-time = "2025-09-27T18:37:06.342Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029, upload-time = "2025-09-27T18:37:07.213Z" },
+    { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408, upload-time = "2025-09-27T18:37:09.572Z" },
+    { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005, upload-time = "2025-09-27T18:37:10.58Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048, upload-time = "2025-09-27T18:37:11.547Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821, upload-time = "2025-09-27T18:37:12.48Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606, upload-time = "2025-09-27T18:37:13.485Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043, upload-time = "2025-09-27T18:37:14.408Z" },
+    { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747, upload-time = "2025-09-27T18:37:15.36Z" },
+    { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341, upload-time = "2025-09-27T18:37:16.496Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073, upload-time = "2025-09-27T18:37:17.476Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661, upload-time = "2025-09-27T18:37:18.453Z" },
+    { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069, upload-time = "2025-09-27T18:37:19.332Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670, upload-time = "2025-09-27T18:37:20.245Z" },
+    { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598, upload-time = "2025-09-27T18:37:21.177Z" },
+    { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261, upload-time = "2025-09-27T18:37:22.167Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835, upload-time = "2025-09-27T18:37:23.296Z" },
+    { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733, upload-time = "2025-09-27T18:37:24.237Z" },
+    { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672, upload-time = "2025-09-27T18:37:25.271Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819, upload-time = "2025-09-27T18:37:26.285Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426, upload-time = "2025-09-27T18:37:27.316Z" },
+    { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146, upload-time = "2025-09-27T18:37:28.327Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz", hash = "sha256:ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661", size = 228134, upload-time = "2026-04-24T20:15:23.917Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/b2/87e62e8c3e2f4b32e5fe99e0b86d576da1312593b39f47d8ceef365e95ed/packaging-26.2-py3-none-any.whl", hash = "sha256:5fc45236b9446107ff2415ce77c807cee2862cb6fac22b8a73826d0693b0980e", size = 100195, upload-time = "2026-04-24T20:15:22.081Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "python-guide-cn"
+version = "0.0.0"
+source = { virtual = "." }
+dependencies = [
+    { name = "sphinx" },
+    { name = "sphinx-sitemap" },
+    { name = "sphinxcontrib-websupport" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "sphinx", specifier = ">=7.4,<8" },
+    { name = "sphinx-sitemap", specifier = ">=2.9,<3" },
+    { name = "sphinxcontrib-websupport", specifier = ">=2,<3" },
+]
+
+[[package]]
+name = "requests"
+version = "2.34.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "charset-normalizer" },
+    { name = "idna" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/ac/c3/e2a2b89f2d3e2179abd6d00ebd70bff6273f37fb3e0cc209f48b39d00cbf/requests-2.34.2.tar.gz", hash = "sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed", size = 142856, upload-time = "2026-05-14T19:25:27.735Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/f4/c67b0b3f1b9245e8d266f0f112c500d50e5b4e83cb6f3b71b6528104182a/requests-2.34.2-py3-none-any.whl", hash = "sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0", size = 73075, upload-time = "2026-05-14T19:25:26.443Z" },
+]
+
+[[package]]
+name = "snowballstemmer"
+version = "3.1.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/f8/0a71edf031f03c40db17503cb8ca78a69a171254e568e7db241b0ab57ea1/snowballstemmer-3.1.1.tar.gz", hash = "sha256:e07bbc54a0d798fe6010a12398422e62a8bfbba95c394fd0956ef58cb4d3e260", size = 123314, upload-time = "2026-06-03T00:56:40.194Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4c/07/2ebca9b11fb9be7340a818d8d6f63feaebb146be2c4afbd6061701d6df6e/snowballstemmer-3.1.1-py3-none-any.whl", hash = "sha256:7e207fa178741da09cdee59d3ecec3827ad5f92b1fc5c9ff3755b639f71f5752", size = 104164, upload-time = "2026-06-03T00:56:38.614Z" },
+]
+
+[[package]]
+name = "sphinx"
+version = "7.4.7"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "alabaster" },
+    { name = "babel" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "docutils" },
+    { name = "imagesize" },
+    { name = "jinja2" },
+    { name = "packaging" },
+    { name = "pygments" },
+    { name = "requests" },
+    { name = "snowballstemmer" },
+    { name = "sphinxcontrib-applehelp" },
+    { name = "sphinxcontrib-devhelp" },
+    { name = "sphinxcontrib-htmlhelp" },
+    { name = "sphinxcontrib-jsmath" },
+    { name = "sphinxcontrib-qthelp" },
+    { name = "sphinxcontrib-serializinghtml" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/5b/be/50e50cb4f2eff47df05673d361095cafd95521d2a22521b920c67a372dcb/sphinx-7.4.7.tar.gz", hash = "sha256:242f92a7ea7e6c5b406fdc2615413890ba9f699114a9c09192d7dfead2ee9cfe", size = 8067911, upload-time = "2024-07-20T14:46:56.059Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0d/ef/153f6803c5d5f8917dbb7f7fcf6d34a871ede3296fa89c2c703f5f8a6c8e/sphinx-7.4.7-py3-none-any.whl", hash = "sha256:c2419e2135d11f1951cd994d6eb18a1835bd8fdd8429f9ca375dc1f3281bd239", size = 3401624, upload-time = "2024-07-20T14:46:52.142Z" },
+]
+
+[[package]]
+name = "sphinx-last-updated-by-git"
+version = "0.3.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "sphinx" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/03/fd/de1685b6dab173dff31da24e0d3b29f02873fc24a1cdbb7678721ddc8581/sphinx_last_updated_by_git-0.3.8.tar.gz", hash = "sha256:c145011f4609d841805b69a9300099fc02fed8f5bb9e5bcef77d97aea97b7761", size = 10785, upload-time = "2024-08-11T07:15:54.601Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e1/fb/e496f16fa11fbe2dbdd0b5e306ede153dfed050aae4766fc89d500720dc7/sphinx_last_updated_by_git-0.3.8-py3-none-any.whl", hash = "sha256:6382c8285ac1f222483a58569b78c0371af5e55f7fbf9c01e5e8a72d6fdfa499", size = 8580, upload-time = "2024-08-11T07:15:53.244Z" },
+]
+
+[[package]]
+name = "sphinx-sitemap"
+version = "2.9.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "sphinx-last-updated-by-git" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/61/17/56fe0f65e3567f829b2b4153a622be1d4b222b781e0d90d7db5a7738f30f/sphinx_sitemap-2.9.0.tar.gz", hash = "sha256:70f97bcdf444e3d68e118355cf82a1f54c4d3c03d651cd17fe87398b26e25e21", size = 6978, upload-time = "2025-10-06T00:24:00.036Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e4/94/3c57e8b1985e755c48972e2ecd59526d4bf0b52a1fe805bc52a8e98cb92d/sphinx_sitemap-2.9.0-py3-none-any.whl", hash = "sha256:f1f1d3a9ad012ba17a7ef0b560d303bff2d0db26647567d6e810bcc754466664", size = 6218, upload-time = "2025-10-06T00:23:58.778Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-applehelp"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ba/6e/b837e84a1a704953c62ef8776d45c3e8d759876b4a84fe14eba2859106fe/sphinxcontrib_applehelp-2.0.0.tar.gz", hash = "sha256:2f29ef331735ce958efa4734873f084941970894c6090408b079c61b2e1c06d1", size = 20053, upload-time = "2024-07-29T01:09:00.465Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5d/85/9ebeae2f76e9e77b952f4b274c27238156eae7979c5421fba91a28f4970d/sphinxcontrib_applehelp-2.0.0-py3-none-any.whl", hash = "sha256:4cd3f0ec4ac5dd9c17ec65e9ab272c9b867ea77425228e68ecf08d6b28ddbdb5", size = 119300, upload-time = "2024-07-29T01:08:58.99Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-devhelp"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/d2/5beee64d3e4e747f316bae86b55943f51e82bb86ecd325883ef65741e7da/sphinxcontrib_devhelp-2.0.0.tar.gz", hash = "sha256:411f5d96d445d1d73bb5d52133377b4248ec79db5c793ce7dbe59e074b4dd1ad", size = 12967, upload-time = "2024-07-29T01:09:23.417Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/35/7a/987e583882f985fe4d7323774889ec58049171828b58c2217e7f79cdf44e/sphinxcontrib_devhelp-2.0.0-py3-none-any.whl", hash = "sha256:aefb8b83854e4b0998877524d1029fd3e6879210422ee3780459e28a1f03a8a2", size = 82530, upload-time = "2024-07-29T01:09:21.945Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-htmlhelp"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/43/93/983afd9aa001e5201eab16b5a444ed5b9b0a7a010541e0ddfbbfd0b2470c/sphinxcontrib_htmlhelp-2.1.0.tar.gz", hash = "sha256:c9e2916ace8aad64cc13a0d233ee22317f2b9025b9cf3295249fa985cc7082e9", size = 22617, upload-time = "2024-07-29T01:09:37.889Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0a/7b/18a8c0bcec9182c05a0b3ec2a776bba4ead82750a55ff798e8d406dae604/sphinxcontrib_htmlhelp-2.1.0-py3-none-any.whl", hash = "sha256:166759820b47002d22914d64a075ce08f4c46818e17cfc9470a9786b759b19f8", size = 98705, upload-time = "2024-07-29T01:09:36.407Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-jsmath"
+version = "1.0.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b2/e8/9ed3830aeed71f17c026a07a5097edcf44b692850ef215b161b8ad875729/sphinxcontrib-jsmath-1.0.1.tar.gz", hash = "sha256:a9925e4a4587247ed2191a22df5f6970656cb8ca2bd6284309578f2153e0c4b8", size = 5787, upload-time = "2019-01-21T16:10:16.347Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c2/42/4c8646762ee83602e3fb3fbe774c2fac12f317deb0b5dbeeedd2d3ba4b77/sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl", hash = "sha256:2ec2eaebfb78f3f2078e73666b1415417a116cc848b72e5172e596c871103178", size = 5071, upload-time = "2019-01-21T16:10:14.333Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-qthelp"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/68/bc/9104308fc285eb3e0b31b67688235db556cd5b0ef31d96f30e45f2e51cae/sphinxcontrib_qthelp-2.0.0.tar.gz", hash = "sha256:4fe7d0ac8fc171045be623aba3e2a8f613f8682731f9153bb2e40ece16b9bbab", size = 17165, upload-time = "2024-07-29T01:09:56.435Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/83/859ecdd180cacc13b1f7e857abf8582a64552ea7a061057a6c716e790fce/sphinxcontrib_qthelp-2.0.0-py3-none-any.whl", hash = "sha256:b18a828cdba941ccd6ee8445dbe72ffa3ef8cbe7505d8cd1fa0d42d3f2d5f3eb", size = 88743, upload-time = "2024-07-29T01:09:54.885Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-serializinghtml"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/3b/44/6716b257b0aa6bfd51a1b31665d1c205fb12cb5ad56de752dfa15657de2f/sphinxcontrib_serializinghtml-2.0.0.tar.gz", hash = "sha256:e9d912827f872c029017a53f0ef2180b327c3f7fd23c87229f7a8e8b70031d4d", size = 16080, upload-time = "2024-07-29T01:10:09.332Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/52/a7/d2782e4e3f77c8450f727ba74a8f12756d5ba823d81b941f1b04da9d033a/sphinxcontrib_serializinghtml-2.0.0-py3-none-any.whl", hash = "sha256:6e2cb0eef194e10c27ec0023bfeb25badbbb5868244cf5bc5bdc04e4464bf331", size = 92072, upload-time = "2024-07-29T01:10:08.203Z" },
+]
+
+[[package]]
+name = "sphinxcontrib-websupport"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "jinja2" },
+    { name = "sphinx" },
+    { name = "sphinxcontrib-serializinghtml" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/87/ed/11167ae7c3eb80e7c67823bceea24207bb7b886aefde6c367b4a571c05de/sphinxcontrib_websupport-2.0.0.tar.gz", hash = "sha256:0b7367d3bac6454b1f97e42aa8c4d4d4a1b756d525fc726ebbe5571e033e79cd", size = 600125, upload-time = "2024-07-29T01:10:23.095Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1a/c9/b9ce2eaacaf75d94a5ee5b809bb2be351f1c9cda5c14316cc53b1aea0650/sphinxcontrib_websupport-2.0.0-py3-none-any.whl", hash = "sha256:365b4da67e03cc163dc4752ed44b3c4bc334172c8198102135a7eb7945111229", size = 37069, upload-time = "2024-07-29T01:10:21.538Z" },
+]
+
+[[package]]
+name = "urllib3"
+version = "2.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/53/0c/06f8b233b8fd13b9e5ee11424ef85419ba0d8ba0b3138bf360be2ff56953/urllib3-2.7.0.tar.gz", hash = "sha256:231e0ec3b63ceb14667c67be60f2f2c40a518cb38b03af60abc813da26505f4c", size = 433602, upload-time = "2026-05-07T16:13:18.596Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7f/3e/5db95bcf282c52709639744ca2a8b149baccf648e39c8cc87553df9eae0c/urllib3-2.7.0-py3-none-any.whl", hash = "sha256:9fb4c81ebbb1ce9531cce37674bbc6f1360472bc18ca9a553ede278ef7276897", size = 131087, upload-time = "2026-05-07T16:13:17.151Z" },
+]