行云与流水

我们可爱的 henning 同学创造了一个很 cool 的 snippet 用来把 django 的 doc 文档联接起来生成一个漂亮的 pdf 文档。我来借花献佛，说说它的用法。
运行这个脚本之前，你需要 htmldoc，rst2html，Python Imaging Libraray，BeautifulSoup 和 spoon。htmldoc 和 rst2html 可以 apt-get 来安装，PIL 的安装可以看这一篇，BeautifulSoup 和 spoon 都只有一个文件，下载就行。
1sudo apt-get install python-docutils htmldoc
然后把 make_pdf_from_django_doc.py 和 BeautifulSoup，spoon 一起放到你的 django/docs 目录下，运行之，一会儿就能看到漂亮的 Django 文档了。

下载 Imaging-1.1.6 解压并进入目录后，运行
1python setup.py build_ext -i
会有类似这样的输出
123456789101112——————————————————————–
PIL 1.1.6 BUILD SUMMARY
——————————————————————–
version       1.1.6
platform      linux2 2.4.3 (#2, Oct  6 2006, 07:52:30)
[GCC 4.0.3 (Ubuntu 4.0.3-1ubuntu5)]
——————————————————————–
*** TKINTER support not available
— JPEG support ok
— ZLIB (PNG/ZIP) support ok
— FREETYPE2 support ok
——————————————————————–
不过很有可能，显示 JPEG 和 FREETYPE2 不被支持，这是由于缺少必要的开发库导致，根据它的建议，我们安装下面这些库。

支持 JPEG 的：libjpeg62，libjpeg62-dev
支持 FREETYPE1 的：libttf2，libttf-dev
支持 FREETYPE2 的：libfreetype6，libfreetype6-dev

1sudo apt-get install libjpeg62 libjpeg62-dev libttf2 libttf-dev [...]