V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
FarBox
V2EX  ›  分享创造

基于文件夹结构的,文档自动生成器

  •  
  •   FarBox · 2014-04-17 12:41:56 +08:00 · 4147 次点击
    这是一个创建于 3892 天前的主题,其中的信息可能已经有所发展或是发生改变。
    虽然文档的生成,已经有一些现成的工具,比如 https://readthedocs.org/

    但是我们想要有更轻便的体验,这样文档维护起来就会轻松很多。所以在开发FarBox的时候,有时候也会顺带做一些额外功能,来支持我们自己的文档库 doc.farbox.com

    我们内部已经使用了比较长时间,还是比较稳定地在工作着。简单的说,就是基于Dropbox的数据同步,FarBox的API自定义模板,以及FarBox Editor导出PDF。

    至于特性,比如自动生成的菜单、TOC支持、代码高亮、全文检索、文件夹对应的landing page .etc,本身都是FarBox引擎支持的,所以,Web端出来的站点也有这些特性, 除去css外的模板代码大概60行左右。


    几副截图:

    本地的文件夹结构:




    对应的网站模板 https://doc.farbox.com :

    具体的源码与使用方法参见: https://github.com/BuildFarBox/doc.farbox.com/blob/master/readme-cn.markdown




    FarBox Editor导出的PDF文档其中的一索引页, 具体PDF可以到 https://doc.farbox.com 上下载。

    4 条回复    2014-06-23 16:16:14 +08:00
    airyland
        1
    airyland  
       2014-04-17 12:47:15 +08:00
    除了Gitbook又多了一个选择。
    sunocean
        2
    sunocean  
       2014-04-17 13:08:40 +08:00
    出书的节奏
    trimleo
        3
    trimleo  
       2014-04-20 23:55:26 +08:00
    好东西 支持
    xiaopenyou
        4
    xiaopenyou  
       2014-06-23 16:16:14 +08:00
    确实好东西,收了
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2036 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 16:12 · PVG 00:12 · LAX 08:12 · JFK 11:12
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.