banner

Gitment 解决 Validation Failed 问题

尝试使用gitment评论系统过程中,配置完成后初始化评论出现验证失败问题(Error: Validation Failed)。

问题出现

第一次配置 gitment 时,按照官方文档进行如下设置:

const gitment = new Gitment({
  id: 'Your page ID', // optional
  owner: 'Your GitHub ID',
  repo: 'The repo to store comments',
  oauth: {
    client_id: 'Your client ID',
    client_secret: 'Your client secret',
  },
  // ...
  // For more available options, check out the documentation below
})

gitment.render('comments')

由于 id 这一项,默认为 window.location.pathname ,于是便删除了这一条。随后 push 到 github,初始化评论(Initialize Comments)时,浏览器边弹窗报错:

Error: Validation Failed

问题解决

经过一番摸索,疑似是因为 gitment 配置中 id 过长引起的。因为 gitment 是其作者基于 gitHub 的 issue 开发的,每一条 issue 会有两个 label,label 的最大长度限制为50个字符。这个问题多数人都遇到过,关于这个问题的讨论与建议在 gitment 的 issues 上出现过:Validation Failed ID长度问题建议,印证了前面的想法。问题找到了,那么我们设置一个长度较短的 id 就可以了。

起初想用 page.title 来作为 id,然而操作并不顺利,因为我的标题大部分是中文,而且长度也都不短,再通过 utf 转码会有一堆 % 占空间,长度必定更长。

最后决定使用 page.path 作为 id,因为我的 permalink 的配置有所更改,所以 page.path 的长度相对较短,重新设置后初始化成功,Initialize Comments 按钮变成了文字 No Comment Yet 。

关于我的 permalink 设置(在博客根目录的 config.yml 中),只保留了 year 和 title:

xxx
permalink: :year/:title/
xxx

最后

由于我的 page.path 长度在50个字符以内,所以上述的设置能够成功。但这并不适合所有情况,具体情况具体分析,只要保证 id 在50个字符以内即可。

归档 分类 标签 关于