为什么要用新的文档创作平台
通常,我们最开始学习和使用的办公软件就是 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(首推) |
① 一个公共空间 ②一个私有空间(支持两个用户的团队) ③ 支持自定义域名 |
https://www.gitbook.com/ | https://amazing-apps.gitbooks.io/windows-apps-that-amaze-us/zh-CN/ |
看云(国内最靠谱的选择) |
①不限量公开文档 ②0个私有文档 ③完整文档功能 |
https://www.kancloud.cn/ | https://www.kancloud.cn/manual/thinkphp/1678 |
北半球 |
感觉规模并不大,所幸这是一个开源项目,你可以自行搭建属于自己的北半球 | https://www.beibq.cn/ | https://www.beibq.cn/book/beibq_guide |
总结:
如果希望托管在平台,请根据项目数量选择使用GitBook或者看云;
如果自建,则只有GitBook和北半球提供了源代码,供用户自行搭建。