Hexo-Troubleshoot
文章目录

Config Error

一般来说, 如果遇到问题的话, 会在命令行处显示出错误

有些时候修改了配置, 但是没有显示出来修改的结果.

这个时候就一定要记得先 clean 一次然后重新生成看看

Deploy Error

左侧文件列表不显示

就在最近遇到了一种情况再部署之后左边的侧边栏显示出现混乱排版

这个时候需要检查的几个地方:

  1. 是否与 cloudflare 相关
    1. 清空了 cf 缓存之后发现没有变化
  2. 是否和域名绑定相关
    1. 关闭绑定之后发现没有变化
  3. 本地 hexo g && hexo d 是否出现相同情况
    1. 本地尝试部署之后发现显示正常
  4. 手动激活 CI 后发现显示错误
    1. 初步判断是两边环境不一致导致
    2. 本地重新拉取代码 npm install 发现有个插件报错 hexo-directory-category: rule must be a function
    3. 初步调试之后发现不是配置问题
    4. 尝试使用 yarn 替代安装
    5. 解决问题

更新 Post 后部署没有变化

这时候清一下缓存就能解决

Post Error

页面中途突然截断 / 页面渲染内容不全

有很多种可能性:

  1. 如果出现 TOC 列表不连贯, 中间出现一些莫名其妙的空行

    检查前面是否出现了章节等级脱节的情况

    比如一级标题突然下方出现了三级标题

    这样就会出问题

  2. 页面中途突然截断

    看一下是否使用的 HTML 的注释.

Template render error

1
2
FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Template render error: (unknown path)

根据官方的文档有两个可能性的错误:

  1. 一个是配置文件出错了 _config.yml :

    The error one:

1
2
3
4
plugins:

+ hexo-generator-feed
+ hexo-generator-sitemap

The correct one:

1
2
3
4
plugins:

- hexo-generator-feed
- hexo-generator-sitemap
  1. 另一个可能性是最近新加的 Post 有问题
    • 很可能里面使用的一些不支持的 Markdown 语法
    • 也有可能是头文件格式出错

点击标签以及分类的时候跳转到了 yoursite.com

这个就是设置的错误, Json 插件设置不完全

到设置文件里面查看一下 URL 这个值是否已经设置

1
2
3
4
5
6
# URL

## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'

url: https://note.szhshp.org
root: /hexo

TOC 不显示

现在的逻辑:

  1. 所有文章默认显示 TOC
  2. TOC 的正文加载的时候会显示出来
  3. 如果对应的文章有密码,那么会每隔一秒钟检测一次正文是否加载。
  4. 如果正文中一级标题和二级标题的总数特别少,那么将不会显示 TOC

如果 TOC 不显示, 首先检查正文 Markdown 里面是否有一些错误, 这里有一些比较常见的错误:

  1. Table 的首尾少了一个竖线符号。
  2. 在正文其他地方出现了三个连续的 - 被当做了 yml header

Deploy 报错

1
ERROR Deployer not found: git

需要使用部署的功能需要安装一个库:

1
npm install --save hexo-deployer-git

Reference

https://hexo.io/docs/troubleshooting.html#Template-render-error