从gitbook到vuepress

郑重声明: 本文首发于人工博客

1、导读

博主是一个喜欢一个折腾的人，虽然有自己的个人博客，但是语雀、gitbook、简书、githtb page啥的都喜欢去一眼一下，这不之前习惯了gitbook，当看到了很多开源博主喜欢用一种新的markdown来展示自己的技术文档的时候，不免好奇，因为的确看起来比gitbook好看一些，一番百度之后，知道了这个是采用最新的vuepress。知道了就立马行动，这个也是我个性。一般折腾，心里体会蛮多的。故记录一番。最重要的心得就是新东西体验下就好了，真正选择的还是得那些经过岁月洗礼的东西。

2、vuepress的优势

• GitBook 最大的问题在于当文件很多时，每次编辑后的重新加载时间长得令人无法忍受。它的默认主题导航结构也比较有限制性，并且，主题系统也不是 Vue 驱动的。GitBook 背后的团队如今也更专注于将其打造为一个商业产品而不是开源工具。
• 基于vue开发，界面美观

3、不好的地方

对博主来说，我有大量的markdown，希望有个工具，我不需要了解它的细节。你告诉我采用拿几个步骤，然后就能转换成一个静态页目录，然后我把它部署到服务器就完事了。gitbook能够很好的完成这一项工作。这也是我为什么用了它很久的原因之一。尝鲜了vuepress，我发现了他存在以下几个不足，可能还是它比较年轻吧

• 文档中带有特殊字符的，无法完成转化。至于那些是特殊字符也没有一个明确的说明，就算有，难道我还去把上千份的文档重新编辑下？
• 目录不能自动生成，手动编写太痛苦。网上有一些用js去实现了，还有一些插件，但是都有其他的硬指标，重新修改文档，这个是我不愿去做的事情
• 遇到了问题，因为我不是vue的开发者，不了解，去百度查询，基本是无脑的一顿转载。解决问题的，有自己主见的没几个。我甚至怀疑那篇文章的作者用过vuepress没。
• 文档不够细致，可能不是面向不懂vue的人吧。起码得有有个demo,常见问题faq，重要配置解释

4、感悟

术业有专攻，工具还是顺手的好，不要老是去跟所谓的潮流。浪费自己的时间。重要的内容。所以我觉得还是gitbook好点。还是那句那些经历了岁月的洗礼仍经久不衰的东西才是好东西，不是说vuepress不好，只是可能不适合我这样的vue小白吧

版权声明：本文为人工博客的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
本文链接：https://www.gzcx.net/article/1754