博客搭建

目前网络上有两种主流的搭建方法,一个是jekyll+github,另一个是hexo+github,这两种框架均是利用静态网页编辑器将生成的静态网页上传到github上,从而实现网页展示,跳转等功能.

本网站是采用hexo+github的方法搭建的,过程很简单,哪怕是完全不懂java,js的小白也可以轻松搭建出来.网络上有很多关于利用hexo搭建博客的文章,譬如:搭建GitHub免费个人网站（详细教程）,有需要的朋友自行百度下就好了.

不过,虽然搭建过程很简单,但是里面的小坑是真不少,接下来我会简单说一下搭建过程中遇到的问题.

1. 有很多hexo主题的导航页并没有完全设置好,像是标签(tag),分类(catagories)这些属性的设立有可能是缺失的,这个时候就需要我们手动设置一下.具体过程可以参考这篇文章:hexo博客添加标签、分类、归档、关于等页面.

2. 由于我们的博客是利用markdown编辑器生成,然后上传到github的,所以如果文档中涉及到图片插入的话,在网页展示中是需要设立正确的图片路径来去引用图片的.但如果每张图片都去设立引用路径的话是很麻烦的,而且一旦设立错误就会让本该展示图片的地方变成空白,即无法引用图片.这个问题的解决方法就是通过typora(markdown编辑器)来去自动复制并生成图片引用路径,具体方法可以参考这篇文章:hexo 图片显示问题及使用typora设置图片路径.

3. 如果algolia搜索功能出现问题的话,可以参考为Hexo增加algolia搜索功能.

   除此之外,还要注意两点:

   第一点:每次编写完新文章,并且重新部署之后,需要输入hexo algolia指令,来去更新algolia网站的新文章索引.

   第二点:修改blog根目录下config_yml文件里面的默认url选项,要修改成项目所在的url网址(如

   https://yb705.github.io).

4. 评论插件valine本身如果并没有什么问题,但是评论框没有显示的话,那么有可能是api和key设置错了,具体参数设置可以参考官方文档:https://valine.js.org/configuration.html

   PS:刚开始使用valine插件的时候,不显示评论框,博主调整了好久都没有成功,但是在leadcloud上新建了一个app之后,莫名其妙地就有了… ㄟ( ▔, ▔ )ㄏ

5. 在博客搭建过程中,我们修改最多的就是blog根目录和theme目录下的config_yml文件.这个文件是遵从yml语言格式的,所以当我们在做属性修改的时候,一定要注意冒号后面加一个空格, 不然在网页部署的时候就会报错.这里建议用sumlime代码编辑器来去编辑,因为yml里面的属性会被不同的颜色标记出来,这样方便大家及时发现错误.当然我们也可以记事本来编辑,只是如果出现错误,会很难发现是哪里出现的问题.

其实博客搭建的本质就是用markdown编辑器编写完文章之后,将文章上传托管到github的博客项目上,并自动生成url链接网址与gitpage,然后通过点击特定组合的url网址来去跳转各种不同的静态网页.只要了解了这个流程,以后再遇到什么问题便都有个大概的思考方向,通过检查网页源码便能解决大部分问题,而不会两眼一抹黑,或者是到网上硬搜答案,有时甚至还什么都没搜出来┑(￣Д ￣)┍.