Hexo安装遇坑笔记

什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页.

安装

安装完后Hexo s 运行报错

1.提示你执行 npm install hexo –save
执行后会报warning
npm WARN engine hexo@3.7.1: wanted: {“node”:”>=6.9.0”} (current: {“node”:”4.8.7”,”npm”:”2.15.11”})
这个时候需要更新下node版本
2.升级方法

1
2
3

$ sudo npm cache clean -f
  sudo npm install -g n
  sudo n stable

重启终端后查看版本

$ node -v

Hexo s运行 *.yml脚本报错

编辑yml文件后，运行报某行的值不能为空的错，这里要吐槽下hexo的脚本解析能力真是太弱了。

常用命令

hexo s  #启动服务器 本地调试使用
hexo clean #清除缓存 网页正常情况下可以忽略此条命令
hexo g #生成静态网页
hexo d #开始部署

常见错误：

1.key:后面没有空格
2.缩进问题

$ deploy: 
    type: git
    repo: https://github.com/JackWchen2015/JackWchen2015.github.io.git
  branch: master

Hexo 报TypeError: Cannot read property ‘utcOffset’ of null

解决方法：编辑yml文件

1.timezone: Asia/Shanghai

部署后大小写更改造成的路径问题

有时候经常会出现文章部署后又修改了Tag或Categories，而恰好修改的内容涉及到英文字母大写改小写或小写改大写，譬如news改为News，字母N修改后确发现部署到Github上无法生效，而此时你若在本地预览确一切正常

由于在发布的文章中出现的Tag或Categories会对应在tag或categories页面中显示，因此当点击对应的Tag或Categories时会出现路径无法找到从而跳转到404页面。

原因：
由于git命令默认的配置中忽略了文件名的大小写

解决：

进入.deploy_git文件夹
打开.git目录下的config文件并修改ignorecase = true 为 ignorecase = false
删除 .deploy_git文件夹内的所有文件，并push到Github仓库

1
2
3

git rm -rf *
git commit -m ‘clean all file’
git push

重新生成文件并部署到Github上

1
2
3

hexo clean
hexo g -d

部署失败

hexo g -d 突然部署失败 ChildProcess. hexo/node_modules/hexo-util/lib/spawn.js:37:17

repo 仓库的地址访问失败导致的部署失败

学计算机的那个