记录第一次使用vuepress搭建文档网站-THsInk

两年前刚用gitbook后发现访问很慢，且反代也有些问题。但我是写完之后才发现的。。就懒得再换了，一直用了两年。期间也专门查过类似产品，但都不尽人意。

当时找到了以下方案

方案	优点	缺点
gitbook	方便	访问慢
国内一些文档平台	方便，访问快	内容、访问等限制多，不能自己托管，ui一般
一个文档样式的wordpress主题	方便，可以自己选择线路	基于wordpress，不够轻量
vuepress	ui好，轻量，可以自托管	markdown编辑相对麻烦，学习成本高，当时看不懂
mkdocs	ui好，轻量，可以自托管	markdown编辑相对麻烦，学习成本高，当时看不懂
docsify	轻量，可以自托管，很多国内用户都用这个	和上面两种相比，更适合内容较少的文档，且不如上面两个好看，不如上面两个扩展性强

这次选择的时候只是在vuepress和mkdocs中选择。因为我都见过成品案例，很好看。最后还是选择了vuepress，因为中文支持更多，也更符合我的审美。

这两种都有主题，我选择了mr.hope的主题。大佬的教程对我来说还是不够小白。我摸索了大半天，解决各种杂乱问题花了一天，转移文档内容和部署花了一天，总计花了三天左右?很累，很折磨。但一回生二回熟，下次就简单了。

文档就不公开了，有几个插件比较推荐：

vuepress-plugin-auto-catalog: VuePress2 的目录自动生成插件
vuepress-plugin-copyright2: 在用户复制时追加版权信息，或禁用站点的复制与选择
vuepress-plugin-md-enhance: 提供更多 Markdown 语法
vuepress-plugin-reading-time2: 阅读时间与字数统计
vuepress-plugin-seo2: SEO 增强插件
vuepress-plugin-sitemap2: Sitemap 插件