前言

一直想搭建一个个人博客，用过wordpress感觉还是不够轻量，因此一直搁置，偶然了解到Hexo这个轻量的博客框架，安装过程见hexo史上最全搭建教程,搭建完成后选择合适自己的主题，再学习下如何使用Hexo创建文章。现在万事具备，还差个评论系统，都使用Hexo框架了，不就是为了高效么，总不可能自己去写一个后端，因此可以添加gitment。

1.安装Hexo时遇到的问题

• 使用Hexo命令生成文件和部署时会报错说缺少某些库，百度如何添加就能解决。
• 还有要注意.config.yml里的格式:键+冒号+空格+值，例如:

  theme: next
  

不正确的话，生成时会报错。

2.添加gitment遇到Not Found问题

注意自己的id和secret字段不要写错，还有repo和owner正确填写，确保repo的那个仓库是属于owner,repo不要.git后缀和前面部分，只写你仓库的名字就行。
我的设置供参考(主题的.config.yml部分)

#Gitment
gitment:
  enable: true
  owner: 413749123
  repo: 413749123.github.io
  client_id: your_client_id
  client_secret: your_secret

设置好后，重新hexo g和hexo d进行部署，刷新浏览器缓存后再打开网站。一般就不会报错not found了，如果发现评论栏不见了，那可能是你修改的配置文件有问题，浏览器按F12应该有报错，点进去就会看见哪个地方有问题，再进行改正。

注意:解决gitment部分的问题时，一定记得刷新浏览器缓存，不然可能一直not found。

3.添加gitment遇到Login一直转圈，登录不上

我找了半天答案，终于解决了，直接放链接吧
点这里

4.添加gitment遇到Comments Not Initialized

报错是评论未初始化：

• 原因1:是你没有在该页面登录github账号，登录之后如果是之前设置的owner，就可以初始化评论。

• 原因2:在注册OAuth Application这个步骤中，给Authorization callback URL指定的地址错了

5.添加gitment遇到validation failed

这个问题很简单，创建issues的标题超过限制了，因为默认是用当前页面的url去创建，当然很容易超出，因此找到theme文件夹里有的gitment.ejs或者有的是gitment.swig，在文件里增加一行
id: <%= page.date %>,记得在最后加个逗号.

我的gitment.ejs供参考:

var gitment = new Gitment({
  id: '<%= page.date %>',
  owner: '<%= theme.gitment.owner %>',
  repo: '<%= theme.gitment.repo %>',
  oauth: {
    client_id: '<%= theme.gitment.client_id %>',
    client_secret: '<%= theme.gitment.client_secret %>',
  },
})

6.gitment的汉化

我们添加的gitment默认是英文的，如果想汉化一下的话，可以使用汉化版本，将theme文件夹中的gitment.ejs文件中引入的css和js修改为:

<link rel="stylesheet" href="https://billts.site/extra_css/gitment.css">
<script src="https://billts.site/js/gitment.js"></script>

7.Hexo搭建的博客文章中使用图片不显示

解决方法点这里
主要解决路径问题，能正确引用图片后，有的图片太大，因此可能需要设置图片的大小

<img src="路径" width="宽度" height="高度" alt="解释" align=center>