配置Hexo主题时遇到的各种坑

0x01 文件验证–html文件被编译

在配置网站被搜索引擎收录时，使用文件验证的方法进行验证，但是下载的googlexxx.html经过hexo g编译后，会改变html里面的内容，需要加上,防止被渲染:

1
2
3

---
layout: false
---

其次就是github禁止了百度爬虫的访问，因此百度收录配置较麻烦

0x02 npm版本问题

搭建hexo博客时，或是想换下主题，建议还是新建一个文件夹，重新部署最新版本npm，以及各种包，防止配置的主题没用效果

0x03 algolia配置识别

登录algolia后,新建index，并在API Keys界面修改配置



在hexo根目录的_config.yml最下面新增：

algolia:
  appId: 
  apiKey: 
  adminApiKey: 
  chunkSize: 5000
  indexName: "my-hexo-blog"
  fields:
    - content:strip:truncate,0,500
    - excerpt:strip
    - gallery
    - permalink
    - photos
    - slug
    - tags
    - title

之后就是设置环境变量

1
2

export(windows 为 set) (Powershell 用 $env:) HEXO_ALGOLIA_INDEXING_KEY=你的Search-Only API key
set (Mac和git bash 为 export) (Powershell 用 $env:) HEXO_ALGOLIA_INDEXING_KEY     #查看是否设置成功如果没有值就设置失败

最后使用hexo algolia生成所以，可以在indices界面可以看到

0x04 gitment出现Error: Validation Failed

issue的标签label有50个字符的长度限制，需要修改主题配置下source文件夹下gitment.swig文件
中

1
2
3

id: '<%= page.title %>'
#改成
id: '<%= page.date %>'