利用GitHub Pages和Hexo搭建博客

很早以前就有搭建自己博客的想法，现在终于实现。在搭建过程中，遇到过一些问题，已经通过官方文档和博客文章解决了。关于搭建博客的文章网上有很多，我写这篇主要是将自己遇到的一些问题记录下来，对自己的学习进行总结。
　　github是项目托管网站，有一个pages功能，可以自定义主页。我们把用Hexo搭建的博客静态资源上传到github中以后，就可以通过访问github自定义主页的地址，来实现访问自己的博客。

一、使用Github创建仓库，并开启Github Pages

参考:https://pages.github.com/

1.注册github帐号(已拥有的请忽略)

进入github,然后进行注册(请自行阅读github注册教程)。
　　注册完成后，就可以创建自己的代码仓库了。

2.创建代码仓库

在github个人主页Repositories找到New按钮，或点击这里进行创建新仓库。

3.在仓库settings中开启github pages

①首先进入仓库，点击settings设置

②然后向下滚动找到github pages这一部分内容,点击choose a theme

③选择一款自己喜欢的主题

　　
　　④设置完成后，就可以通过用户名.github.io访问自己的博客了

二、Hexo博客框架的使用

接下来，就该搭建Hexo了,需要安装Nodejs和git。
　　下载Node.js;下载git
　　参考:安装Node.js

1.安装Hexo

在你需要安装Hexo的目录下(新建一个文件夹)右键选择 Git Bash，执行以下命令。

npm install -g hexo-cli                全局安装hexo
hexo init [folder]                     初始化网站(若没有设置folder,默认在当前文件夹建立网站)
npm install               
hexo generate                          生成静态文件
hexo server                            启动本地服务器(默认端口4000)

常用简写及命令

hexo g == hexo generate                      生成静态文件
hexo s == hexo server                        启动本地服务器
hexo d == hexo deploy                        部署网站
hexo n "文章名" == hexo new "文章名"          新建文章
hexo new page "页面名"                        新建页面
hexo clean                          清除缓存文件和已生成的静态文件(更换主题后，不生效可以运行该命令)

详细命令参考Hexo官方文档

2.部署到github

①首先在根目录下_config.yml文件,改成如下配置

deploy: 　　　　type: git 　　　　repo: git@github.com:用户名/用户名.github.io.git 　这里的网址填你自己的 　　　　branch: master

　　②安装扩展包 　　npm install hexo-deployer-git --save

③检查SSH keys的设置

cd ~/.ssh 　　ls 　　#此时会显示一些文件 　　mkdir key_backup 　　cp id_rsa* key_backup 　　rm id_rsa* 　　#以上三步为备份和移除原来的SSH key设置 　　ssh-keygen -t rsa -C "邮件地址@youremail.com" 　　#生成新的key文件,邮箱地址填你的Github地址 一直回车就可以

④添加SSH Key到Github　
　　首先到github首页，点击setting

找到 系统当前用户目录下(开启查看隐藏文件) C:\Users\用户名\ .ssh id_rsa.pub文件以文本方式打开。打开之后全部复制到key中

设置你的账号信息:

git config --global user.name "你的名字"     　　　#真实名字不是github用户名
git config --global user.email "邮箱@邮箱.com"    #github邮箱

⑤部署

hexo d

这时再刷新 用户名.github.io 就可以看到你的博客了。