平常我们个人学习或工作的过程中会有些产出,比如技术总结等,为了能更好地管理这些产出,最好的办法是发表在技术博客里。
那对于一个公司来说,如何对外呈现公司的整体产出呢,那就要用到公司网站了。这里我们不做多展开,本次我们的目的是搭建一个公司的技术文档中心。这个技术文档中心,对外可以在线查看官方技术文档,对内可以实现文档源代码的保存和迭代版本管理等。
通过了解,我决定使用GitHub+Hugo这两个开源工具来实现目的。
了解GitHub和Hugo
1)GitHub是一个版本控制系统+代码托管系统+静态网页托管系统
所以,GitHub很好地满足了我们的所有需要。初识GitHub,我们可以把它认作为一个与SVN类似的东西,或者说高级版的SVN,
因为一开始使用它时,并不觉得它与SVN有何不同。
在廖雪峰的教程里,解释得很清楚,即GitHub是分布式版本控制系统,而SVN是集中式版本控制系统,SVN需要有一个中央服务器来存储版本库,使用时必须联网从此中央服务器下载原来的内容和上传修改后的内容,当修改的文件很大时,对于网速就会有很高的要求;而GitHub由于每个使用人本地都有一个完整的版本库,使用时不需要联网,将修改完的内容推送给对方即可。
详细的对比在这里:https://www.liaoxuefeng.com/wiki/896043488029600/896202780297248
图1 集中式版本控制系统(此图摘自廖雪峰个人网站)
图2 分布式版本控制系统(此图摘自廖雪峰个人网站)