分享：在Dash中查看Tornado文档

[shiny]

这几天开始学习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根目录就有了图标。

[binux]

周末也生成了一个，建议nosidebar=True，然后调整css
效果：

[lex]

感谢楼主分享。补充一下 doc2dash 具体用法：
https://github.com/hynek/doc2dash

[shiny]

@binux 谢谢，分享出来吧 :)

[binux]

@shiny https://www.dropbox.com/s/909kxlqo8b4h4ro/tornado.docset.zip

[kenneth]

@binux @shiny @lex 是不是只有mac可以用，这个Dash软件。

[shiny]

@kenneth mac下的应用，其他平台应该没有。

[1dian01]

@binux 是否有空帮忙做个一个网站项目 http://www.v2ex.com/t/67755

[huip]

mark下，最近也在看tornado。

[PurpleSun]

mark

[agileguo]

没有最新的3.2？

[Livid]

https://coderwall.com/p/zkssjw