文档管理

为什么要用新的文档创作平台

​ 通常,我们最开始学习和使用的办公软件就是 Word、Excel 和 PowerPoint。这里不是说它们已经过时了,不是说 GitBook 能够替代它们。相反,Microsoft 的办公软件很优秀并且经受了时间的考验,但是正因为它功能丰富,导致稍显臃肿(二八定律:80%的时间里我们只会只用20%的功能)。

​ 所以,如果你和我一样,不满足于传统的写作方式,正在寻找一种令人愉悦的写作方式,那么可以尝试以下几种文档创作方式!

一、gitbook与hexo的比较

gitbook hexo+GithubPage
网址 gitbook官网 hexo官网
常用于 书籍文档类 博客文档类
参考案例 腾讯移动分析 美团技术团队博客 只是猜测
个人实践 https://devbook.site https://dvlproad.github.io
定制型 相对固定 根据设置的不同hexo主题,显示不同排版效果
优点 以书籍形态,层次顺序明确;
非常适合知识架构的分类整理及递进。
虽不是书籍类,但也有层次;
定制型更强。
缺点 官网非翻墙使用不了
所以需要申请域名来映射使用
访问限制 暂未了解,目前都是无差别访问 暂未了解,目前都是无差别访问
文档存放 GitHub GitHub、Gitlab、SVN等都可以
文档编写 Markdown本地编写 Markdown本地编写
本地预览 执行gitbook seve即可预览 执行hexo seve即可预览
远程生效 更新GitHub就可以 执行hexo d进行发布即可

附:几个类似GitBook的在线文档创作平台

参考:几个类似GitBook的在线文档创作平台

在线文档创作平台 为免费用户提供 官网地址 文档示例
GitBook(首推)
img
① 一个公共空间
②一个私有空间(支持两个用户的团队)
③ 支持自定义域名
https://www.gitbook.com/ https://amazing-apps.gitbooks.io/windows-apps-that-amaze-us/zh-CN/
看云(国内最靠谱的选择)
img
①不限量公开文档
②0个私有文档
③完整文档功能
https://www.kancloud.cn/ https://www.kancloud.cn/manual/thinkphp/1678
北半球
img
感觉规模并不大,所幸这是一个开源项目,你可以自行搭建属于自己的北半球 https://www.beibq.cn/ https://www.beibq.cn/book/beibq_guide

总结:

如果希望托管在平台,请根据项目数量选择使用GitBook或者看云;

如果自建,则只有GitBook和北半球提供了源代码,供用户自行搭建。


点击此处,进入本章第1节的正式学习 >