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/
shiny
V2EX  ›  Tornado

分享:在Dash中查看Tornado文档

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