分享：在Dash中查看Tornado文档

这几天开始学习Tornado，非常喜欢它对代码和模板的自动reload。之前用web.py在这方面遇到了点挫折…
Tornado的几个中文镜像只翻译了Overview部分，新加内容并无翻译。而英文文档的网速比较慢。所以想在Dash中看文档，不过里面并没有Tornado。

给作者写信，得到的反馈是：
I've recorded your vote towards a Tornado docset. Currently, Tornado has 1 vote. Please note that I don't generate docsets unless more people ask for them.

好吧，自己动手，丰衣足食。
以下是生成的效果：


下载地址：
http://s.yunio.com/23THti

以下是生成流程，理论上所有sphinx源码都可以很方便地转成docset

到Tornado的github下载了文档sphinx源码（位于website目录）
sphinx-build -b html sphinx documentation
(Mac下可能会遇到ValueError: unknown locale: UTF-8的报错，只要export LANG=en.UTF-8就可以了)

然后 sudo easy_install doc2dash
doc2dash -n tornado documentation/
目录下就生成了 tornado.docset
按照指南把icon.png放到docset根目录就有了图标。