hexo常见问题汇总

hexo官方文档

注意事项

编辑好 md 文档先在hexo server 运行一下在提交 github

Markdown 使用时（） { } 都需要转义 否者会报错

每次提交 github 自动构建前，要重启一下 hexo server 然后看看没有报错 ，再进行提交

next 主题注意事项

canvas_ribbon 和 tree 需要配合在 CDN 中添加 git 默认不上传 lib 下的文件

关于报错

没有任何提示 哪个文件，挨个改动回退试试，原来是因为_config.yml这里直接写中文是不行的，中文需要引号包裹

social:
  # 微博: http://weibo.com/your-user-name  这里不能使用中文  确使用方式如下  地址后是图标
  "微博": http://weibo.com/your-user-name || fab fa-weibo
  "知乎": http://www.zhihu.com/people/your-user-name || fab fa-zhihu

Next 主题文章老是自动滚到底部评论区的问题

原因 :
设置了 utterances

utterances:
  enable: true

解决：
取消 utterances

utterances:
  enable: false

hexo 4.2.1 升级至 6.2.0 Next 7.8.0 升级至 8.12.1

hexo 升级

npm i -g npm-check # 检查之前安装的插件，都有哪些是可以升级的 

# cd hexo 目录
npm-check         # 检查那些依赖能够升级 并把 package.json 版本号升级到最新
npm update        # 安装升级

Next 升级

升级官方文档

安装

# cd hexo 目录
npm i hexo-theme-next

修改配置文件位置

将themes/next/_config.yml 复制到 hexo目录/_config.next.yml

备份原主题

将 themes/next 改为 themes/next-old

运行

运行hexo clean并hexo s检查站点是否正常工作