首页   注册   登录
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/
V2EX  ›  Tornado

分享:在Dash中查看Tornado文档

  •  
  •   shiny · 2012-12-17 11:17:50 +08:00 · 5066 次点击
    这是一个创建于 2492 天前的主题,其中的信息可能已经有所发展或是发生改变。
    这几天开始学习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
    11 回复  |  直到 1970-01-01 08:00:00 +08:00
        1
    binux   2012-12-17 11:31:42 +08:00   ♥ 1
    周末也生成了一个,建议nosidebar=True,然后调整css
    效果:
        2
    lex   2012-12-17 11:32:28 +08:00   ♥ 1
    感谢楼主分享。补充一下 doc2dash 具体用法:
    https://github.com/hynek/doc2dash
        3
    shiny   2012-12-17 11:35:08 +08:00
    @binux 谢谢,分享出来吧 :)
        4
    binux   2012-12-17 12:22:01 +08:00   ♥ 2
        5
    kenneth   2012-12-18 18:06:04 +08:00
    @binux @shiny @lex 是不是只有mac可以用,这个Dash软件。
        6
    shiny   2012-12-18 18:13:51 +08:00
    @kenneth mac下的应用,其他平台应该没有。
        7
    1dian01   2013-05-05 22:51:07 +08:00
    @binux 是否有空帮忙做个一个网站项目 http://www.v2ex.com/t/67755
        8
    huip   2013-06-22 15:58:35 +08:00
    mark下,最近也在看tornado。
        9
    PurpleSun   2013-08-10 00:07:30 +08:00
    mark
        10
    agileguo   2014-03-07 15:58:20 +08:00
    没有最新的3.2?
        11
    Livid   V2EX Moderator   2014-04-09 17:09:47 +08:00
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   4142 人在线   最高记录 5043   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 23ms · UTC 03:58 · PVG 11:58 · LAX 20:58 · JFK 23:58
    ♥ Do have faith in what you're doing.