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

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

  •  
  •   xjqkilling · 263 天前 · 3242 次点击
    这是一个创建于 263 天前的主题,其中的信息可能已经有所发展或是发生改变。
    相信有很多人都会将文档作为代码托管在 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   263 天前 via Android
    推广 seafile 就直接打发 我就用 nextcloud
    xjqkilling
        2
    xjqkilling   263 天前
    @chinesestudio NextCloud 也没有这里提到的功能,可能对你个人来说没用,不妨碍对其他人有用
    moocean
        3
    moocean   263 天前
    我用的 vuePress
    xjqkilling
        4
    xjqkilling   263 天前
    @moocean 这个也不错 :-) 只是如果是编辑一些使用手册之类的文档,让不懂编程的人来写就不太方便。Seafile 可以支持所见即所得编辑,不懂编程的也能用。
    hing
        5
    hing   263 天前
    不懂为什么 Windows 的新版服务端不更新了
    xjqkilling
        6
    xjqkilling   263 天前
    @hing Win 上系统限制比较多,支持得不太好,所以只好不维护了
    ruoxie
        7
    ruoxie   263 天前 via Android
    我用 docsify
    nnnToTnnn
        8
    nnnToTnnn   262 天前
    相对与 Confluence 以及 gitlab 的 wiki 有什么优点???
    xjqkilling
        9
    xjqkilling   260 天前
    @nnnToTnnn Confluence 做不到无缝兼容 Markdown,gitlab 的 wiki 没有所见即所得编辑器。
    googlefans
        10
    googlefans   260 天前 via iPad
    推广水平不错
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   3056 人在线   最高记录 5168   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 19ms · UTC 12:46 · PVG 20:46 · LAX 05:46 · JFK 08:46
    ♥ Do have faith in what you're doing.