V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
爱意满满的作品展示区。
FarBox

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

  •  
  •   FarBox · Apr 17, 2014 · 4962 views
    This topic created in 4402 days ago, the information mentioned may be changed or developed.
    虽然文档的生成,已经有一些现成的工具,比如 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 replies    2014-06-23 16:16:14 +08:00
    airyland
        1
    airyland  
       Apr 17, 2014
    除了Gitbook又多了一个选择。
    sunocean
        2
    sunocean  
       Apr 17, 2014
    出书的节奏
    trimleo
        3
    trimleo  
       Apr 20, 2014
    好东西 支持
    xiaopenyou
        4
    xiaopenyou  
       Jun 23, 2014
    确实好东西,收了
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   3162 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 41ms · UTC 14:31 · PVG 22:31 · LAX 07:31 · JFK 10:31
    ♥ Do have faith in what you're doing.