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

推荐一个比 Github+Gitbook 更好用的文档发布工具

  •  
  •   xjqkilling · 2019-07-10 12:19:04 +08:00 · 6940 次点击
    这是一个创建于 1995 天前的主题,其中的信息可能已经有所发展或是发生改变。
    相信有很多人都会将文档作为代码托管在 Github 上,然后将 Markdown 文件编译成 html 再使用 Gitbook 等对外发布。这个流程有几个不便之处:编辑之后不方便从整体上预览文档的效果,降低了编辑的效率;图片等资源也需要作为文件手工 push 到 Github 上面。

    Seafile 7.0 版本开始支持公开资料库的功能,可用于对外发布基于 Markdown 编写的软件文档。通过直接将文档的原始 Markdown 文件保存在 Seafile 中,即可以所见即所得的方式来编辑维护文档,同时对外发布,图片也可以直接上传,大大简化了流程。而且由于文档都是用 MD 格式编写的,可以完全兼容现存的 Github 上的文档。

    更详细的介绍可以看官方的博客: https://www.jianshu.com/p/45c9d9d1241d
    10 条回复    2019-07-13 14:10:19 +08:00
    chinesestudio
        1
    chinesestudio  
       2019-07-10 13:15:22 +08:00 via Android
    推广 seafile 就直接打发 我就用 nextcloud
    xjqkilling
        2
    xjqkilling  
    OP
       2019-07-10 13:38:13 +08:00
    @chinesestudio NextCloud 也没有这里提到的功能,可能对你个人来说没用,不妨碍对其他人有用
    moocean
        3
    moocean  
       2019-07-10 14:09:38 +08:00
    我用的 vuePress
    xjqkilling
        4
    xjqkilling  
    OP
       2019-07-10 14:16:21 +08:00
    @moocean 这个也不错 :-) 只是如果是编辑一些使用手册之类的文档,让不懂编程的人来写就不太方便。Seafile 可以支持所见即所得编辑,不懂编程的也能用。
    hing
        5
    hing  
       2019-07-10 15:24:51 +08:00
    不懂为什么 Windows 的新版服务端不更新了
    xjqkilling
        6
    xjqkilling  
    OP
       2019-07-10 16:34:12 +08:00
    @hing Win 上系统限制比较多,支持得不太好,所以只好不维护了
    ruoxie
        7
    ruoxie  
       2019-07-10 19:37:59 +08:00 via Android
    我用 docsify
    nnnToTnnn
        8
    nnnToTnnn  
       2019-07-11 11:41:51 +08:00
    相对与 Confluence 以及 gitlab 的 wiki 有什么优点???
    xjqkilling
        9
    xjqkilling  
    OP
       2019-07-13 13:04:46 +08:00
    @nnnToTnnn Confluence 做不到无缝兼容 Markdown,gitlab 的 wiki 没有所见即所得编辑器。
    googlefans
        10
    googlefans  
       2019-07-13 14:10:19 +08:00 via iPad
    推广水平不错
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3022 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 39ms · UTC 14:02 · PVG 22:02 · LAX 06:02 · JFK 09:02
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.