V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
la0wei
V2EX  ›  分享发现

准备翻译 docs.openstack.org/juno/,求文档生成工具

  •  
  •   la0wei · 2015-01-29 14:53:31 +08:00 · 2442 次点击
    这是一个创建于 3378 天前的主题,其中的信息可能已经有所发展或是发生改变。

    有能生成这样如下链接中文档的开源工具吗?
    http://docs.openstack.org/juno/install-guide/install/apt-debian/content/
    想翻译了以备查看,但是觉得水平不够,不敢放官网上,想问问有没有这样的工具能较好的生成带目录文档,最好傻瓜化的,像http://wikiwebhelp.org/#2-en 这样的。
    不需要生成pdf什么的,直接放网上。
    我之前倒是想用wikiwebhelp做个人知识库的,但是其节点下的文章都会显示,资料一多就显得很臃肿,仅仅需要像wordpress的分类一样,显示有多少文章就行,不需要具体到最终的文章,这样能保持目录整洁。

    6 条回复    2015-01-29 19:49:38 +08:00
    laoyan
        1
    laoyan  
       2015-01-29 15:38:15 +08:00   ❤️ 1
    用sphinx吧,直接生成html
    zhouzm
        2
    zhouzm  
       2015-01-29 16:01:23 +08:00   ❤️ 1
    在使用 sphinx 的基础上,使用 readthedocs( https://readthedocs.org
    xgfan
        3
    xgfan  
       2015-01-29 16:02:38 +08:00   ❤️ 1
    我觉得gitbook蛮适合。
    jeansfish
        4
    jeansfish  
       2015-01-29 16:08:52 +08:00   ❤️ 1
    我是用github+目录的
    la0wei
        5
    la0wei  
    OP
       2015-01-29 16:16:29 +08:00
    @laoyan @zhouzm 感觉稍复杂

    @xgfan @jeansfish git貌似可以,但是不想依赖外部服务,最好能独立搭建在自己vps上
    itfanr
        6
    itfanr  
       2015-01-29 19:49:38 +08:00
    同求文档生成工具
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5306 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 09:30 · PVG 17:30 · LAX 02:30 · JFK 05:30
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.