爱意满满的作品展示区。
xjqkilling

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

  •  
  •   xjqkilling · Jul 10, 2019 · 8198 views
    This topic created in 2678 days ago, the information mentioned may be changed or developed.
    相信有很多人都会将文档作为代码托管在 Github 上,然后将 Markdown 文件编译成 html 再使用 Gitbook 等对外发布。这个流程有几个不便之处:编辑之后不方便从整体上预览文档的效果,降低了编辑的效率;图片等资源也需要作为文件手工 push 到 Github 上面。

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

    更详细的介绍可以看官方的博客: https://www.jianshu.com/p/45c9d9d1241d
    10 replies  •  2019-07-13 14:10:19 +08:00
    chinesestudio
    chinesestudio
    Jul 10, 2019 via Android
    1
    推广 seafile 就直接打发 我就用 nextcloud
    xjqkilling
    xjqkilling
    OP
    Jul 10, 2019
    2
    @chinesestudio NextCloud 也没有这里提到的功能,可能对你个人来说没用,不妨碍对其他人有用
    moocean
    moocean
    Jul 10, 2019
    3
    我用的 vuePress
    xjqkilling
    xjqkilling
    OP
    Jul 10, 2019
    4
    @moocean 这个也不错 :-) 只是如果是编辑一些使用手册之类的文档,让不懂编程的人来写就不太方便。Seafile 可以支持所见即所得编辑,不懂编程的也能用。
    hing
    hing
    Jul 10, 2019
    5
    不懂为什么 Windows 的新版服务端不更新了
    xjqkilling
    xjqkilling
    OP
    Jul 10, 2019
    6
    @hing Win 上系统限制比较多,支持得不太好,所以只好不维护了
    ruoxie
    ruoxie
    Jul 10, 2019 via Android
    7
    我用 docsify
    nnnToTnnn
    nnnToTnnn
    Jul 11, 2019
    8
    相对与 Confluence 以及 gitlab 的 wiki 有什么优点???
    xjqkilling
    xjqkilling
    OP
    Jul 13, 2019
    9
    @nnnToTnnn Confluence 做不到无缝兼容 Markdown,gitlab 的 wiki 没有所见即所得编辑器。
    googlefans
    googlefans
    Jul 13, 2019 via iPad
    10
    推广水平不错
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1596 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 33ms · UTC 09:17 · PVG 17:17 · LAX 01:17 · JFK 04:17
    ♥ Do have faith in what you're doing.