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

2019-07-10 12:19:04 +08:00
 xjqkilling
相信有很多人都会将文档作为代码托管在 Github 上,然后将 Markdown 文件编译成 html 再使用 Gitbook 等对外发布。这个流程有几个不便之处:编辑之后不方便从整体上预览文档的效果,降低了编辑的效率;图片等资源也需要作为文件手工 push 到 Github 上面。

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

更详细的介绍可以看官方的博客: https://www.jianshu.com/p/45c9d9d1241d
6942 次点击
所在节点    分享创造
10 条回复
chinesestudio
2019-07-10 13:15:22 +08:00
推广 seafile 就直接打发 我就用 nextcloud
xjqkilling
2019-07-10 13:38:13 +08:00
@chinesestudio NextCloud 也没有这里提到的功能,可能对你个人来说没用,不妨碍对其他人有用
moocean
2019-07-10 14:09:38 +08:00
我用的 vuePress
xjqkilling
2019-07-10 14:16:21 +08:00
@moocean 这个也不错 :-) 只是如果是编辑一些使用手册之类的文档,让不懂编程的人来写就不太方便。Seafile 可以支持所见即所得编辑,不懂编程的也能用。
hing
2019-07-10 15:24:51 +08:00
不懂为什么 Windows 的新版服务端不更新了
xjqkilling
2019-07-10 16:34:12 +08:00
@hing Win 上系统限制比较多,支持得不太好,所以只好不维护了
ruoxie
2019-07-10 19:37:59 +08:00
我用 docsify
nnnToTnnn
2019-07-11 11:41:51 +08:00
相对与 Confluence 以及 gitlab 的 wiki 有什么优点???
xjqkilling
2019-07-13 13:04:46 +08:00
@nnnToTnnn Confluence 做不到无缝兼容 Markdown,gitlab 的 wiki 没有所见即所得编辑器。
googlefans
2019-07-13 14:10:19 +08:00
推广水平不错

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/581668

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX