Hexo博客安装与更新-1

个人安装Hexo的记录

安装步骤

网络上关于 Hexo博客的安装教程已经多如牛毛,我觉得自己没有必要重复造轮子。安装教程大多数基于windows环境,其实linux环境下也大同小异的。
大体步骤如下:

  1. 了解Hexo :hexo.io
  2. 安装git :GitHub Windows
  3. 安装Node.js : Node.js
  4. Hexo初始化配置 : Hexo Setup
  5. 部署静态网页到GitHub

详细步骤参考:使用GitHub和Hexo搭建免费静态Blog

问题及解决

下面主要我在建站过程中遇到的问题和解决方法,仅供参考。

yml文件忘加空格错误

安装Hexo时,在配置_config.yml文件的过程中,如果参数冒号后面忘记加空格就会报错:

FATAL can not read a block mapping entry; a multiline key may not be an implicit key at line 8, column 12

解决办法:yml文件格式问题,你自己检查一下是不是冒号后面没有写空格。

yml文件忘加空格错误

npm 警告

提示如下:

npm WARN optional dep failed, continuing fsevents@1.0.8

目前没有去解决,似乎不会影响建站。

github 讨论

缺少.git文件报错

发生环节:windows下,将本地Hexo部署到github时。
将会有以下几种错误提示:

1
2
3
4
5
spawn git ENOENT

ERROR Deployer not found: github

fatal: Not a git repository (or any of the parent directories): .git

截图如下:

spawn git ENOENT

fatal: Not a git repository

解决方案:在Hexo的安装目录下生成.git文件,然后deploy一下。
随后有可能会遇到版本不一致的问题,需要同步一下。

具体操作:

  1. 检查blog blog 目录下的 _config.yml 文件
1
2
3
4
deploy:</br>
type: git</br>
repo: git@github.com:xxx/xxx.github.io.git #不是github@</br>
branch: master
  1. 安装插件
    npm install hexo-deployer-git –save

  2. 发布页面
    hexo g #创建静态页面
    hexo d #发布:清空.deploy_git/里文件,从public/复制新生成的文件

  3. 解决fatal: Not a git repository (or any of the parent directories)错误
    使用everything搜索隐藏目录下的.git文件复制到Hexo文件的.deploy_git目录下。再次运行hexo d

  4. 如果上一步骤出现Permission denied或者提示版本不一致问题,首先cd 到.deploy_git下,然后处理版本问题。
    6.git版本冲突问题解决

1
2
3
4
5
6
7
git init #解决fatal: Not a git repository (or any of the parent directories): .git

git pull #拉到本地

git merge #测试版本一致性

git push #再次发布

我的Hexo下,.git安装路径为
E:\hexo\blog\\.deploy_git\\.git
是由于远程仓库中代码版本与本地不一致冲突导致的。

解决:
git pull
再自动merge或手动merge冲突,
再次git push,
成功解决问题。

参考:Git push 报错

无法访问github.com错误

Fatal Error : Can't resolve host github.com

我遇到的只是暂时性无法访问,多试几次就可以了。

扩展阅读

  1. Yip’s Blog
  2. 我的github主页
  3. Pro Git book
  4. Hexo文档
  5. 七牛图床
  6. Markdown 语法说明 (简体中文版)
  7. w3school
  8. Hexo常见问题解决方案

参考博客