使用github pages和hexo搭建博客

我是小小强，这是我的第4篇原创文章，阅读需要大约10分钟。

---

三思而行:在真正操作前，学习了网上的资料，逐步明确搭建博客的目的。

• 使用github pages 及hexo完成博客
• 分别备份博客源文件及生成的静态页面，前者的仓库应当是私有的
• 可免密推送仓库

安装及配置github sshkey

前提:本地具备git环境

• 注册github并创建仓库
  创建xx.github.io.git仓库(xx为github的用户名，如果不适用用户名创建仓库，会导致博客显示异常)，设置master为默认分支，同时本地执行：

cd .ssh
ssh-keygen -t rsa -C "xxx@163.com"

同时设置对应的key密码sdxxx，然后复制产生的id_rsa.pub内容到github上，执行如下命令测试是否成功：

ssh -T git@github.com

• 配置多用户登录
  后续会有多个帐号的sshkey切换，因此在.ssh目录创建config文件，输入：

#github
Host github
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa

如果无错误发生，则本机可免密提交代码到github上。为方便提交代码，完善git信息

git config --global user.name "xxx"//用户名
git config --global user.email "xxx@163.com"//填写自己的邮箱

• 检出仓库到本地

git clone https://github.com/xx/xx.github.io.git

注意：在github上版本库名称需要为xx.github.io的名称，克隆到本地时任意名称均可。

安装及配置hexo

• 安装nodejs

brew install node

安装成功后，可以使用npm指令，可以使用node -v查看信息。

• 配置hexo

npm install -g hexo-cli 安装hexo
cd xx.github.io.git
hexo init 初始化(这一步会覆盖掉.git目录)
npm install 安装依赖组件
npm install hexo-deployer-git --save

安装完成后，执行hexo clean;hexo -g;hexo －s可以在localhost:4000查看hexo的默认页面。

• 安装next主题

git clone https://github.com/iissnan/hexo-theme-next themes/next
cd themes/next
git pull

配置xx.github.io.git目录下的_config.yml

language: zh-Hans #网站语言
timezone: Asia/Shanghai #时区
theme: next
deploy:
type: git
repository: https://github.com/xx/xx.github.io.git
branch: master

配置上面的地址后，每次执行hexo -g;hexo -d会将生成的静态页面推送到github上的xx.github.io.git仓库。

安装及配置oschina

• 设置oschina
  在oschina上创建仓库hexo，并为oschina添加sshkey

  ssh-keygen -t rsa -C "xx@163.com" -f oschina

将oschina.pub拷贝到oschina的用户设定下。同时修改.ssh/config文件，加入：

#osOne
Host oschina
HostName git.oschina.net
User git
IdentityFile ~/.ssh/oschina

执行ssh -T git@git.oschina.net测试是否成功 。

• 配置本地xx.github.io.git映射到hexo

  cd xx.github.io.git
  rm -rf .git
  rm -rf themes/next/.git(原因下面解释)
  git init
  git remote add origin https://git.oschina.net/xx/hexo.git
  git pull origin master
  git add .
  git commit -m "add repo first"
  git push origin master

编辑 .gitignore，加入

/.deploy_git
/public

按照上面的配置完成后，本地源文件会推送到oschina的hexo.git，执行hexo d之后的静态文件会推送到github的xx.github.io.git的master分支。

日常使用

编辑博客文章

方法一：对于强迫症患者，希望将文章按照分类categories存放在不同的目录，那么就可以在_posts目录下手动建立文件夹。

• 在_posts下创建dir目录，用于存放某一categories的文章
• 执行hexo new "file"会在_posts目录下产生file.md文件，将文件拷贝到dir目录
• 编辑file.md文件

---
title: 'title'
date: 2017-06-29 21:51:07
categories: dir ＃为手动创建的目录名
tags: [tags1,tags2]
--- 

方法二：对于非强迫症患者，实际没有必要创建dir目录，只要在file.md中像上文一样指明categories就行。这个时候创建的文章在默认路径下就可以，只要不嫌乱。

提交管理

在本地对博客进行修改（添加新博文、修改样式等等）后，通过下面的流程进行管理：

• 依次执行git add .、git commit -m “…”、git push指令将改动的源文件推送到oschina
• 执行hexo clean;hexo g -d发布网站到github的master分支

恢复资料

如果想在一个新环境使用博客，按照以下流程处理：

• 使用git clone https://git.oschina.net/xxx/hexo.git 拷贝仓库
• 在hexo.git目录执行npm install -g hexo-cli、npm install、npm install hexo-deployer-git
  注意一定不要执行hexo init。

Q&A

• 执行hexo -d提示“error:deploy not found:git”，执行下面命令即可

npm install hexo-deployer-git --save

• 执行ssh -T git@git.oschina.net提示Permission denied (publickey)，是因为产生的sshkey未添加到系统生效，每次开机后执行如下命令:

ssh-add ~/.ssh/私钥名

• 如果不介意博客源文件也放在github上的话，可以先把xx.github.io.git库下到本地，然后在本地建立一个hexo分支，然后把本地的hexo分支推送到github，同时github设置hexo为默认分支。源文件推送到hexo分支，在执行hexo -d时，生成的静态文件会推送到master分支。这样就不需要oschina私有库。使用github一个库，两个分支一样达到目的。
• hexo在本地测试运行重启后页面一直空白，或者参照"恢复资料"一节部署后提示如下：

WARN No layout: 2017/05/13/hello-world/index.html
WARN No layout: archives/index.html
WARN No layout: archives/2017/index.html
WARN No layout: archives/2017/05/index.html
WARN No layout: index.html

这个原因是从oschina下载的themes目录下的next主题目录为空，因为next也是一个版本库，目录下包含.git目录，当向oschina进行push时，未push上去。目前的解决方案时将next目录下的.git改名为next_git，在此push发现还是没有提交上去。然后将next目录拷贝到库之外的目录，执行push在服务端先删除next，然后再把next拷贝回来，再次push。

• fatal: The current branch master has no upstream branch.

git push -u origin master(不要-u也可以)
或者
git add -A
git commit
git push origin master

• 执行hexo cl;hexo g -d提示下面错误:

FATAL Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

这个原因是对应的git用户的key未加入到系统中，参见前面ssh-add的Q&A.

常用命令

hexo help #查看帮助
hexo init #初始化一个目录
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成网页，可以在 public 目录查看整个网站的文件
hexo server #本地预览，'Ctrl+C'关闭
hexo deploy #部署.deploy目录
hexo clean #清除缓存，强烈建议每次执行命令前先清理缓存，每次部署前先删除 .deploy 文件夹
npm install hexo -g #安装
npm update hexo -g #升级
hexo generate --deploy
hexo deploy --generate
hexo deploy -g
hexo server -g
hexo new draft <title> 新建草稿
hexo publish draft <title> 发布草稿为post

参考资料

记录网站诞生过程-使用hexo+github pages
Github-Pages-Hexo搭建博客
使用hexo，如果换了电脑怎么更新博客？
Hexo常见问题解决方案
Hexo搭建Github-Pages博客填坑教程
hexo你的博客
GitHubPages + Hexo—详解博客搭建
Cherry's博客