博客背景
博客背景
之前在搞gitbook的时候,就知道gitbook不维护了,当时耐不住gitbook简单,功能还挺强大,就整了一个.
一直种草的vuepress,最近一段时间看后,发现已经完善出来了,特别是基于vuepress的一些主题,比如vuepress-theme-hope,vuepress-theme-reco看了都很厉害.
要不,我们把博客搬过来??
博客目标
之前的博客是比较简单的,搭建在gitee的pages服务上,也不要什么维护,就nodejs编译一下,提交,发布,搞定.
人么,总是要有点追求,我对博客的要求也就以下一些
- 博客搭建在gitee上,没用自己的域名,看着就不专业
- 博客系统,能方便的发布文章就可以,美观最好自带,本人审美不及格.
- 写东西要顺手,之前的gitbook,其实还有很多不顺手的,比如警告段落,找了很长时间的插件
- 博客能不能搞个评论系统,虽然不见得有多少人看,但虚荣的东西不能少
开搞
研究了几天vuepress,觉得很厉害,当时就决定用他了.
后面碰上不少问题,这边一个一个聊
- 工具差异 和gitbook不一样,vuepress自带的功能比较少,vuepress大量的功能都是底层功能,博客系统的大量页面都是主题需要考虑的.
- 我之前选型gitbook,也试用过vuepress,太简单,导航栏,侧边栏完全不知道怎么搞. 使用上面说的2个主题后,你就会发现,功能很强大. 不能直接用vuepress,那东西比较底层,而且脸做的不好看,功能很少.
vuepress的版本问题
目前的vuepress最新版本是2.0.x,应该是刚发布不久.
::
中文路径问题
这边使用hope主题来构建博客.这边说一个坑死人的事.
在使用hope主题,本地调试页面的时候,完美的很.然后就build,发布到nginx.发上去之后发现页面访问不了,F12看看错误, 我还厚着脸皮,去github上问问题,主题作者很快就回应了,但是态度不咋地,还被认定是个人运维水平有问题,但是解决方案很好,完美解决问题.
解决方案
提示
在./vuepress/config.js中,增加themeConfig配置 chunkRename:{ pageChunkName: false }
::
接入评论
本来我是想简单点搞,评论么,用个gitee的issue做为评论发布就可以了.
现在的评论系统有以下可选
| 平台 | 说明 |
|---|---|
| github | 就不评论了,国内被墙,我账号都丢了. |
| gitee | 客户端接入,简单,使用gitee用户体系 |
| waline | 要自己搞服务器,比较麻烦 |
| valine | 简单,粗暴 |
上述平台,功能都挺强大的,只要不碰上审查,一般没问题.
我的想法,valine都要使用leanCloud的服务,从倒闭的概率上来说leanCloud好像比gitee更高一点.
所以我选择gitee 我找了大半天的插件,也发现vssue能支持gitee的评论.
按照文档,我也正常接入了. 但是,重点是后面的但是.
:::warn 在接入gitee的时候,要在gitee上配置第三方应用的回调,这个东东应该是为了安全起见,防钓鱼.
gitee的回调地址不能配置通配符,如果一般的有后台的系统,配置一个地址转发就可以了,但是对于静态生成的博客系统来说,每个页面都是不一样的地址,也就是说,如果要使用gitee的评论,有多少篇文章,就要配置多少个回调,否则gitee的回调就无法使用.
这边想问一下gitee,你们的回调是授权给站点的还是授权给页面的??? :::
不得不放弃....
再看waline,需要搭建一个后台服务,理论上没啥问题,但是,但是,我的服务器是手机上运行chroot容器跑的centos,不支持docker运行....
虽然waline官网上有直接运行的说明,我这边更新依赖失败.(看到waline官网,发现waline官网的维护和vuepress-theme-hope的作者是一个人....)
问题调试
vuepress使用会使用webpack进行编译,页面都是静态发布.
如果在写文章的时候,文章中出现一个图片,没有提交,在gitbook中,文章内应该出现一个图片无法加载,而使用vuepress,整个页面都会无法打开,调试的时候没有出现侧边栏的菜单,或者点上去没反应,通过F12才能看vue执行报错,有点小不便利.
严重问题
使用vuepress-theme-hope发布的内容,浏览器会使用所有的缓存,包括侧边栏,这就导致我新增的博客内容在没有刷新浏览器的情况下,不会被看见.
部署
那个中文问题,困扰了我很久.当然,所有人都不知道,我的服务器,尽然只是一部手机...一部手机.... 这个问题,下次再说. # 感谢 再次感谢vue,vuepress (opens new window)和vuepress-theme-hope (opens new window)的作者,我的博客才能顺利迁移过来...
