10分钟Hexo + Github Pages 博客搭建指南

本文简要记录使用Hexo搭建个人博客并部署在Github上的步骤，也可以作为非技术同学的搭建指南。

系统环境：macOS

第一步：安装Hexo

安装Hexo的前提是系统已经安装了Node.js、Git 和 Xcode。安装方法看这里。

安装Hexo非常简单，打开命令行（terminal）工具，执行以下命令：

1	npm install hexo-cli -g

如果提示没有权限，可使用sudo npm install -g hexo-cli来安装。

第二步：建立博客

继续在命令行执行以下命令：

cd ~/Documents/
hexo init blog
cd blog
npm install

完成后，blog文件夹里的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

打开_config.yml（以下称为站点配置文件），修改网站配置：

# Site
title: 填写你的网站名字
subtitle: 填写你的网站副标题
description: 写给搜索引擎看的内容
author: 你的名字

# Writing
new_post_name: :year-:month-:day-:title.md

第三步：安装服务器和部署模块

继续在命令行里执行以下命令：

1 2	npm install hexo-server --save npm install hexo-deployer-git --save

到这里，hexo 就安装完成了。在命令行输入hexo s启动服务器，就可以通过http://localhost:4000 在本地访问你的博客了。

第四步：更换主题(可选)

以NEXT主题为例，首先在命令行执行以下命令：

1	git clone https://github.com/theme-next/hexo-theme-next.git themes/next

然后修改站点配置文件：

1 2	language: zh-CN theme: next

关于NEXT的个性化设置看这里。更多主题可以在这里找到。

第五步：发布到Github Pages

在Github 上创建一个repo, 名称为username.github.io（username必须和你的Github账户名称相同）。创建完成后会得到一个url地址，类似于https://github.com/username/username.github.io.git。

如果还没有配置过git 的用户信息，在命令行里执行如下命令（引号里分别是你的名字和邮箱，已经配置的跳过）：
git config --global user.name "John Doe"
git config --global user.email "johndoe@example.com"

由于GitHub 不再支持命令行HTTPS 方式鉴权，所以改用SSH 方式上传站点。
首先执行以下命令生成公钥（如果已有则跳过此步骤）

1	ssh-keygen -t rsa -C “youremail”

然后一路回车到底完成配置rsa私钥。

接着打开生成的SSH key：

1	vim path/to/id_rsa.pub

复制里面的全部内容，并添加到GitHub Account - Settings - SSH and GPG keys - New SSH key。

接着打开站点配置文件，修改如下：

# Deployment
deploy:
  type: git
  repo: git@github.com:username/username.github.io.git

然后，在命令行执行如下命令（首次发布会要求输入Github的账户和密码），就可以发布到GitHub啦。

hexo g -d

最后，在GitHub repo - Settings - Pages - Build and deployment 中，选择上传的分支即可。

快打开https://username.github.io/ ，看看你的新博客吧~

Happy blogging❤️