利用hexo和github搭建博客(一)

在搜素文章时无意间发现一篇很漂亮的博客,一看时个人博客,自己也就想创建一个属于自己的博客,初步完成后就写下此文章便于日后查询。

本文是利用hexo在GitHub上建立的静态博客。
主要有三个步骤:

  1. 下载和安装所需软件
  2. 搭建本地静态博客
  3. 将本地博客同步到GitHub上
  4. 购买设置专属域名(可选)

搭建环境

  1. node.js
  2. git
  3. hexo

node.js 和 git 我就不多说了,自己在官网按着官方指示一步一步下载安装。我主要来说明下hexo的安装。
node.js 和 git 安装完成后,新建一个博客目录,在目录下使用 git bash here (可用命令行)执行

1
$ npm install -g hexo

根据网络情况下载,等待安装完成

搭建本地博客

cd 到本地博客路径,初始化

1
$ hexo init

安装依赖包

1
$ npm install

重启后再在博客目录下,生成必要文件和部署

1
2
$ hexo generate
$ hexo deploy

启动 hexo,在本地预览

1
$ hexo server

在浏览器输入 http://localhost:4000 预览。若正常显示,则本地博客初始化成功

同步到 GitHub

登录 GitHub,没有账号的 Sign up(注册)一个,已有账号的直接登录 Sign in(登录)
登陆后点击“+”选择“New repository”

  • Repository name:指定格式:’GitHub用户名’.github.io
  • Description:可选
  • Public:必须公开

在本地博客目录下有一个_config.yml配置文件,使用编辑器打开,修改Deployment部分:

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: github
repository: https://github.com/voidking/voidking.github.io.git
branch: master

注意:冒号后面必须跟一个空格,不然会出错
再在博客目录下执行如下命令同步到GitHub

1
2
$ hexo generate
$ hexo deploy

若报错 error deployer not found:github 可能是 hexo 更新问题
解决方案:将 github 改为 git、将 https 改为 http 后重试

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repository: http://github.com/voidking/voidking.github.io.git
branch: master

若还是报错,先执行如下指令后重试

1
$ npm install hexo-deployer-git --save

在浏览器访问https://‘GitHub用户名’.github.io,若正常显示,则博客已同步到GitHub

至此静态博客就初步搭建完成了!!!