在 Github 上搭建 Hexo 博客

Tips：非 Mac 系统可能不一样，重点参考下思路。Windows 配置参考

思路梳理

1. 配置 Hexo 环境（node.js 和 git）
2. 指定本地文件夹，并安装 Hexo
3. 配置参数
4. 熟悉命令行，本地调试运行
5. git 配置
6. git 与 Github 服务器认证、对接
7. 测试 Github Pages 部署情况
8. 折腾主题

操作步骤

安装 Hexo 环境及 Hexo

见 Hexo 官方文档

常用命令

• 新建草稿：hexo new draft [draftname]
• 新建文章：hexo new [blogname]
• hexo generate 生成供提交的静态页面，可简写为 hexo g
• hexo deploy 将代码部署至服务器，可简写为 hexo d ，连着上一步一起可用 hexo g -d
• 检查效果 hexo server ，浏览器打开 http://localhost:4000/ 查看效果

在文件夹内安装 git

• 先确认已安装 Git
• cd hexo
• git init

将本地 git 与 Github 连接

思路：获取 key，拷贝至 Github，提交，代码行确认认证

• git publickey 认证 & publickey 拷贝至 Github
• 在 Github Repository 的 Code 内创建新的 Branch gh-pages （点击 Branch: master ，敲入 gh-pages ）

修改 _config.yml

链接最好用 https，在 Github Repository 的 Code 内点击 Clone or download -> use https -> copy 链接，填写进 _config.yml

deploy:
type: git
repo: https://github.com/[RepositoryNmae]/XXX.github.io.git
branch: gh-pages

部署代码

• npm install hexo-deployer-git --save 安装 git deploy 包
• hexo generate 生成页面
• hexo deploy 部署至 Github

更换主题

我用的主题是：maupassant-hexo

npm install hexo-renderer-sass --save

这一步如果报错，需要换为 cnpm （淘宝 NPM 镜像 ）：

npm uninstall  hexo-renderer-sass --save
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install hexo-renderer-sass --save

绑定域名

如果有自己的域名，配置 CNAME 文件（文件名 CNAME 无后缀，内容为指向的域名链接）放入 hexo 下的 source 文件夹，在 DNSPod 上配置解析（日后 favicon.ico、images 也都要放在这里），配置后记得 generate 和 deploy