Instructions

.gitignore

@@ -10,4 +10,19 @@ __pycache__/
 .Python
 
 tmp/
+
+
+# tex related files
+*.fdb_latexmk
+*.fls
+*.idx
+*.ilg
+*.ind
+*.log
+*.out
+*.toc
+*.aux
+*.synctex.gz
+
 build/
+

Dockerfile

@@ -0,0 +1,31 @@
+FROM python:3.3
+ENV PYTHONUNBUFFERED 1
+RUN mkdir /doc
+ADD . /doc
+WORKDIR /doc
+
+RUN apt-get update
+RUN apt-get install -y texlive
+RUN apt-get install -y texlive-xetex
+RUN apt-get install -y texlive-lang-cjk
+RUN apt-get install -y texlive-latex-recommended
+RUN apt-get install -y texlive-latex-extra
+RUN apt-get install -y texlive-fonts-recommended
+RUN apt-get install -y texlive-base
+RUN apt-get install -y fonts-wqy-zenhei
+RUN apt-get remove -y \
+        texlive-fonts-recommended-doc \
+        texlive-latex-base-doc \
+        texlive-latex-extra-doc \
+        texlive-latex-recommended-doc \
+        texlive-pictures-doc \
+        texlive-pstricks-doc \
+    && apt-get clean
+
+RUN pip install \
+    sphinx \
+    sphinx_rtd_theme \
+    sphinx_bootstrap_theme \
+    alabaster
+
+ENTRYPOINT ["/bin/bash"]

README.md

@@ -1,99 +1,44 @@
 # 《Think Python 2ed》最新版中文翻译
 
-## 贡献者
+本书中文翻译已经完结，感谢各位贡献者的参与和大家的关注及支持。
 
-希望参与翻译的朋友，请提PR，直接在下面的表格中对应的章节（还未注明译者的章节）处加上自己的名字及Github主页链接。
+贡献者名单如下：
 
-| 章节 | 译者 |
-|------|------|
-| [前言](./source/00-preface.rst) | [@bingjin](https://github.com/bingjin) |
-| [第一章](./source/01-the-way-of-the-program.rst)     | [@bingjin](https://github.com/bingjin)  |
-| [第二章](./source/02-variables-expressions-and-statements.rst)     | [@bingjin](https://github.com/bingjin)  |
-| [第三章](./source/03-functions.rst)     | [@bingjin](https://github.com/bingjin)  |
-| [第四章](./source/04-case-study-interface-design.rst)     | [@bingjin](https://github.com/bingjin)  |
-| [第五章](./source/05-conditionals-and-recursion.rst)     | [@ipyher](https://github.com/iphyer)    |
-| [第六章](./source/06-fruitful-functions.rst)     |   [@theJian](https://github.com/thejian)   |
-| [第七章](./source/07-iterations.rst)     | [@F-Karl](https://github.com/F-Karl)    |
-| [第八章](./source/08-strings.rst)     | [@xpgeng](https://github.com/xpgeng)    |
-| [第九章](./source/09-case-study-word-play.rst)     | [@ipyher](https://github.com/iphyer)    |
-| [第十章](./source/10-lists.rst)     | [@obserthinker](https://github.com/obserthinker)     |
-| 第十一章     |      |
-| 第十二章     | [@SeikaScarlet](https://github.com/SeikaScarlet)     |
-| 第十三章     |      |
-| 第十四章     |      |
-| 第十五章     |      |
-| 第十六章     |      |
-| 第十七章     |      |
-| 第十八章     |      |
-| 第十九章     |      |
-| 第二十章     |      |
-| 第二十一章     |      |
+- [@bingjin](https://github.com/bingjin)
+  全书校对，完成第1-4、17-21章的翻译。
+- [@ipyher](https://github.com/iphyer)
+  完成第5、9、13、15章的翻译。
+- [@theJian](https://github.com/thejian)
+  完成第6、11章的翻译。
+- [@lroolle](https://github.com/lroolle)
+  完成第7章的翻译。
+- [@xpgeng](https://github.com/xpgeng)
+  完成第8章的翻译。
+- [@obserthinker](https://github.com/obserthinker)
+  完成第10、14章的翻译。
+- [@SeikaScarlet](https://github.com/SeikaScarlet)
+  完成第12章的翻译，独自完成全书TEX版的制作和校对。
+- [@cxyfreedom](https://github.com/cxyfreedom)
+  完成第16章的翻译。
 
-最终校对将由我自己完成。
+本书目前托管在[编程派网站](https://codingpy.com/books/thinkpython2/)。
 
-本书翻译完成后，我会将最终的文档托管在[编程派网站](http://codingpy.com)，并提供PDF等其他格式的分享链接。
+使用 Sphinx 制作的 PDF、EPUB 等电子版的分享链接为：http://pan.baidu.com/s/1eRZOrHC。 提取码: n24y。
 
-## 编程派站长的自我介绍
+TEX 精校版 PDF 的分享链接为：https://pan.baidu.com/s/1pLiwSAn。
 
-我是一名自学Python的编程爱好者。之所以说是爱好者，是因为我不是计算机专业毕业的。我的第一个单位是一家媒体，因为工作关系对当时新闻界流行的数据视觉化十分感兴趣，从《鲜活的数据》一书中了解到Python编程语言。而我使用的第一本教材，就是Allen Downey的《Think Python》，副标题叫“如何像计算机科学家一样思考”。
+如果你觉得这本书对你有帮助，可以考虑扫描下面的二维码，打赏我一杯咖啡。
 
-后来，我到了一家互联网公司，接触运营工作。我也利用业余时间开发出了自己的网站——[编程派](http://codingpy.com)，而网站的定位就是专注Python编程，这也是网站名称和网站域名的由来：“编程派”中的“派”字，取自Python前两个字母的发音；codingpy，则是coding python的缩略。了解Python的朋友都知道，Python脚本的默认文件名后缀就是`.py`。
-
-搭建“编程派”网站（后来还开通了“编程派”微信订阅号和今日头条号）的目的，就是为了能够让更多的人了解Python语言，更快地获取国外的Python教程和资源，一起交流、学习Python。因为我相信，[每个人都值得学习一点编程知识](http://codingpy.com/article/10-reasons-all-us-normal-people-should-learn-code/)，而在我看来，最好的入门语言就是Python。
-
-## 为什么想要翻译一本书？
-
-呃，其实我是语言类专业出身的，所以难免会有想要翻译一本书的冲动，可惜还没有出版社请我去翻书。所以只有自己上啦。
-
-另外，这四个多月来通过网站和微信号，已经和大家分享了近百篇原创编译的Python教程，很多都得到了各大技术网站的转载。虽然大家在阅读文章的时候，可能并不太会注意“编程派”这个名字，但能够帮助到更多的人，还是不错的。但是这些原创编译的教程存在一个问题，就是各自是不关联的，而且也有一定的难度，对于完全零基础的人来说，根本没有什么卵用。
-
-所以，我想成系列地与大家分享文章，而我最想帮助的人，就是那些零编程基础的朋友。因此，最适合的系列文章莫过于一本Python入门教材啦。
-
-## 为什么选择《Think Python》
-
-选择《Think Python》，一是因为它是我自己入门使用的第一本教材；二是，它确实非常浅显易懂，把很多概念用非常朴实的话进行了解释。至少，当时零基础的我，看这本书时没有大的障碍。
-
-这和作者在设计、编写此书时的出发点密不可分。你可以在本书的“序言”部分（今天微信推送的另一篇文章），看到更加详细的解释。
-
-## 为什么翻译Python 3版？
-
-此书已经有了Python 2版，为什么还要更新到Python 3呢？
-
-（本书最新版与此前版本的区别，请看“序言”部分。）
-
-这是因为Python 3才是Python的未来。Python之父Guido van Rossum早就坚决指出，不会再延长Python 2的支持协议。更具体一点说，就是到2020年时，Python核心开发团队就会停止对Python 2.7的开发、维护工作。而且，他们也早就不再往2.7版中添加新特性了。
-
-虽然现在很多公司还在使用2.7，从Python 2迁移到Python 3的过程也非常的艰难，但是可以肯定的是，Python 3才是Python的未来！
-
-所以，我们需要Python 3版的《Think Python》。
-
-（另外一个原因，当然是因为Python 2版的已经有中译本，而且已经出版啦。。。本书在翻译过程中，会参考[车万翔老师组织翻译的Python 2版](https://github.com/carfly/thinkpython-cn)。）
-
-## 微信放送计划
-
-本书最新版一共21章，我目前的计划是一周放送两章（视章节长短和翻译进度进行调整），尽量不将时间拖得太长。所有译文将在微信公众号首发。
-
-微信放送安排如下：
-
-- 周三早10点放送一个章节
-- 周六早10点再放送下一章
-
-中间会穿插一些其他的Python教程和资源推送。如果大家希望能在微信群交流学习心得 ，可以加我的个人微信号，说明希望加群交流。
-
-## 支持本书的翻译计划
-
-如果你也喜欢这本书，喜欢Python编程，希望你能够支持本书最新版的翻译工作。
-
-支持的方式有很多种，你可以将本书的翻译计划告诉想学编程的朋友，并推荐本书。你也可以关注“编程派”的微信订阅号，将最新的译文分享给更多的人。甚至，你还可以联系我，加入到这本书的翻译工作中来。
+![赞助编程派的翻译计划](http://ww1.sinaimg.cn/mw690/006faQNTgw1f1g1gf903aj308w0ai74q.jpg)
 
-当然，如果你愿意的话，你还可以扫描下面的二维码，让我能够一边翻书一边喝咖啡的。O(∩_∩)O~
+同时也欢迎大家关注我的微信公众号：编程派（ID：codingpy），现在基本是每天定期更新，分享 Python 精彩教程和资源。
 
-![赞助编程派的翻译计划](http://ww1.sinaimg.cn/mw690/006faQNTgw1f1g1gf903aj308w0ai74q.jpg)
+***
 
-## 声明
+该中译版以知识共享协议（[Creative Commons Attribution-NonCommercial 3.0 Unported License](https://creativecommons.org/licenses/by-nc/3.0/us/)）发布，你可以自由分享、修改、复制该中译版，但请不要用于商业用途。
 
-本书的原作是一本自由书籍（Free Book），以知识共享协议（[Creative Commons Attribution-NonCommercial 3.0 Unported License](https://creativecommons.org/licenses/by-nc/3.0/us/)）发布。因此，该中译版将以同样的协议发布，不会用于商业用途。你可以自由分享、修改、复制该中译版，但请不要用于商业用途。
+本书原著版权归[Allen Downey](http://greenteapress.com/wp/think-python-2e/)所有，原作链接如下：[https://github.com/AllenDowney/ThinkPython2](https://github.com/AllenDowney/ThinkPython2)。
 
-此书原著版权归[Allen Downey](http://greenteapress.com/wp/think-python-2e/)所有，原作链接如下：[https://github.com/AllenDowney/ThinkPython2](https://github.com/AllenDowney/ThinkPython2)。
+该中译版在翻译过程中，参考了车万翔老师组织翻译的 Python 2 版：[https://github.com/carfly/thinkpython-cn](https://github.com/carfly/thinkpython-cn)，在此表示感谢。
 
-该中译版在翻译过程中，将参考车万翔老师组织翻译的Python 2版：[https://github.com/carfly/thinkpython-cn](https://github.com/carfly/thinkpython-cn)。
+本书中如仍存在细微错误，会不定期更新，也希望大家指正。

book/Makefile

@@ -0,0 +1,96 @@
+LATEX = latex
+
+DVIPS = dvips
+
+PDFFLAGS = -dCompatibilityLevel=1.4 -dPDFSETTINGS=/prepress \
+           -dCompressPages=true -dUseFlateCompression=true  \
+           -dEmbedAllFonts=true -dSubsetFonts=true -dMaxSubsetPct=100
+
+
+%.dvi: %.tex
+	$(LATEX) $<
+
+%.ps: %.dvi
+	$(DVIPS) -o $@ $<
+
+%.pdf: %.ps
+	ps2pdf $(PDFFLAGS) $<
+
+all:	book.tex
+	makeindex book.idx
+	pdflatex book
+	mv book.pdf thinkpython2.pdf
+	evince thinkpython2.pdf
+
+hevea:	book.tex header.html footer.html
+	# replace the pdfs with eps
+	sed s/.pdf/.eps/g book.tex > thinkpython2.tex
+	latex thinkpython2
+	rm -rf html
+	mkdir html
+	hevea -fix -O -e latexonly htmlonly thinkpython2
+# the following greps are a kludge to prevent imagen from seeing
+# the definitions in latexonly, and to avoid headers on the images
+	grep -v latexonly thinkpython2.image.tex > a; mv a thinkpython2.image.tex
+	grep -v fancyhdr thinkpython2.image.tex > a; mv a thinkpython2.image.tex
+	imagen -png thinkpython2
+	hacha thinkpython2.html
+	cp up.png next.png back.png html
+	mv index.html thinkpython2.css thinkpython2*.html thinkpython2*.png *motif.gif html
+
+DEST = /home/downey/public_html/greent/thinkpython2
+
+epub:
+	cd html; ebook-convert index.html thinkpython2.epub
+
+distrib:
+	rm -rf dist
+	mkdir dist dist/tex dist/tex/figs
+	rsync -a thinkpython2.pdf html dist
+	rsync -a Makefile book.tex latexonly htmlonly dist/tex
+	rsync -a figs/*.fig figs/*.pdf dist/tex/figs
+	cd dist; zip -r thinkpython2.tex.zip tex
+	cd dist; zip -r thinkpython2.html.zip html
+	rsync -a dist/* $(DEST)
+	chmod -R o+r $(DEST)/*
+	cd $(DEST)/..; sh back
+
+# UPDATE THE PATHS BELOW BEFORE RUNNING PLASTEX
+
+plastex:
+	# Before running plastex, we need the current directory in PYTHONPATH
+	# export PYTHONPATH=$PYTHONPATH:.
+	python Filist.py book.tex > book.plastex
+	rm -rf /home/downey/thinkpython2/trunk/book
+	plastex --renderer=DocBook --theme=book --image-resolution=300 --filename=book.xml book.plastex
+	rm -rf /home/downey/thinkpython2/trunk/book/.svn
+
+plastest:
+	# Before running plastex, we need the current directory in PYTHONPATH
+	# export PYTHONPATH=$PYTHONPATH:.
+	python Filist.py test.tex > test.plastex
+	rm -rf /home/downey/thinkpython2/trunk/test
+	plastex --renderer=DocBook --theme=test --filename=test.xml test.plastex
+	rm -rf /home/downey/thinkpython2/trunk/test/.svn
+
+xxe:
+	xmlcopyeditor ~/ThinkDSP/book/book/book.xml &
+
+lint:
+	xmllint -noout book/book.xml
+
+OREILLY = atlas
+
+oreilly:
+	rsync -a book.tex $(OREILLY)
+	rsync -a book/ $(OREILLY)
+	rsync -a figs/* $(OREILLY)/figs
+	cd $(OREILLY); git add .
+	cd $(OREILLY); git commit -m "Automated check in."
+	cd $(OREILLY); git push
+
+clean:
+	rm -f *~ *.aux *.log *.dvi *.idx *.ilg *.ind *.toc
+
+
+