使用 Hexo 搭建个人博客

安装 Node.js 和 Git

安装 Hexo 之前需要安装 Node.js 和 Git

安装 Node.js

安装 Node.js 的最佳方式是使用 nvm

cURL:

1
$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

Wget:

1
$ wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

安装完成后,重启终端并执行下列命令即可安装 Node.js

1
$ nvm install stable

Windows 下通过下载安装程序来安装。

安装 Git

  • Windows:下载 Git 安装程序进行安装
  • Linux (Ubuntu, Debian):sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS):sudo yum install git-core

安装 Hexo

Nodejs 和 Git 安装完成后,即可使用 npm 安装 Hexo

1
$ npm install -g hexo-cli

建站

Hexo 安装完成后,新建一个文件夹(例如:MyBlog)作为项目的根目录,在文件夹中右键打开 git bash,执行下列命令

1
2
$ hexo init
$ npm install

配置

通过修改项目文件夹中的配置文件 _config.yml 完成相关配置

部署

部署前可先通过如下命令在本地进行预览

1
2
$ hexo g //在本地预先生成静态文件
$ hexo server //启动本地服务器

默认情况下通过 http://localhost:4000 即可预览生成的静态网站

通过如下命令将在本地生成的网站部署到服务器上

1
$ hexo d

需要注意的一些“坑”

1)如果是要部署到 Github 上,则需要在部署前通过如下命令安装 hexo-deployer-git

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

并对配置文件 _config.xml 做如下修改,以我的配置文件为例:

1
2
3
4
deploy:
type: git
repo: git@github.com:PengbinLee/pengbinlee.github.io.git
branch: master

注意:配置文件 _config.xml中每个参数冒号后都有个空格

2)如果在部署到 Github 上时出现如下错误,则需要设置 publickey

Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

首先在 git bash 中使用如下命令在本地生成 publickey

1
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

C:\Users\XXX.ssh 目录下的 id_rsa.pub 即为 publickey 文件

然后在 SSH Keys 页面添加前面生成的 publickey。Title 任意命名,Key 值为 id_rsa.pub 文件中的内容

参考文章

https://hexo.io/zh-cn/docs/index.html