How to build the doc locally

在本地端建立 Python 中文說明文件

Python 環境準備

使用 Python 3.5 即可。

下載 Python 原始碼（含翻譯）

目前專案在 GitHub 上，使用 Git 版本控制。

$ git clone https://github.com/python-doc-tw/cpython-tw.git
$ cd cpython-tw
$ git checkout tw-3.5

專案約 1.x GB 需要一點時間 clone。完成後進入 Doc/ 安裝所需套件。

$ cd Doc
$ pip install -r requirements.txt

Build doc

將 po 檔編譯成 mo 檔並輸出 HTML 文件。

$ sphinx-build -b html -d build/doctrees -D language=zh_Hant . build/html