分享：在Dash中查看Tornado文档

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

Tornado Documentation

› http://www.v2ex.com/tornado/

Tornado on GitHub

› https://github.com/facebook/tornado/

Tornado Gists

› http://tornadogists.org/

这是一个创建于 4352 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

第 1 条附言 · 2013-06-21 17:19:22 +08:00

Tornado 已经升级到 3.1，文档也做了下打包更新。
https://dl.dropboxusercontent.com/u/793510/tornado.docset.zip

Tornado

sphinx

docset

11 条回复 • 1970-01-01 08:00:00 +08:00