使用Hexo在GitHub上搭建私人博客

前言

  一般故事的开始，都要有好多准备工作，在使用Hexo之前，你要做好如下准备：

1. 注册GitHub账号
2. 电脑安装node.js、npm或cnpm
3. 电脑安装git

利用好GitHub Pages，让你免费光速搭建私人博客，点击查看效果预览

GitHub上的操作

创建博客仓库

1. 新建仓库username.github.io，其中username必须是你的github用户名
2. 在仓库Settings页面找到GitHub Pages页面，Choose a theme并保存
3. 此时访问username.github.io，就可以看到你的博客页面了

绑定域名

1. 还是在仓库Settings页面找到GitHub Pages页面，Custom domain输入框内输入你的域名
2. 为自己的域名添加DNS解析，一般有两种类型
   • CNAME：将你自己的域名指向另一个域名，也就是username.github.io
   • A：将你自己的域名指向一个ip（可以ping username.github.io的ip）

配置SSH

1. 在git bash窗口中输入命令cd ~/.ssh
2. 如果提示No such file or directory，则执行命令h-keygen -t rsa -C "your github email"
3. 连续按三次回车
4. 在C盘本用户目录文件夹下打开.ssh\id_rsa.pub文件，复制所有内容
5. 打开GitHub，点击右上角头像，选择Settings
6. 选择SSH and GPG keys，点击New SSH key
7. 链贴刚才复制的内容，并取一个名字(随意)

测试SSH

ssh -T [email protected] # 注意邮箱地址不用改

  如果提示Are you sure you want to continue connecting (yes/no)?，输入yes，然后会看到：Hi XXX! You've successfully authenticated, but GitHub does not provide shell access.

  看到这个信息说明SSH已配置成功！此时你还需要配置：

git config --global user.name "youusername"// 你的github用户名，非昵称
git config --global user.email  "[email protected]"// 填写你的github注册邮箱

使用Hexo

安装Hexo

1. 新建你博客的本地文件夹
2. 在文件夹根目录内右键打开git bash窗口
3. 按顺序执行以下三条命令（可用cnpm代替npm可以加速）

npm install hexo-cli -g

hexo init

npm install

  新建完成后，指定文件夹的目录如下：

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

  此时按顺序执行以下两条命令，其中第一条用来生成静态文件，第二条用来启动本地服务器。在浏览器访问http://localhost:4000/，可以预览当前博客的效果。

hexo g

hexo s

上传到github

  配置站点配置文件_config.yml中有关deploy的部分，其中username改为自己的github用户名。

deploy:
  type: git
  repository: [email protected]:username/username.github.io.git
  branch: master

  在博客本地文件夹的source子文件夹内，新建CNAME文件，注意不要后缀名，文件内容填写你自己绑定github.io的那个域名。

  按顺序执行以下命令：

npm install hexo-deployer-git --save
hexo g -d

查看博客

  现在在浏览器打开你自己的域名，就可以看到Hexo为你渲染的博客啦。

自定义主题配置，可参考其他教程，也可以download我的github仓库查看（注意在hexo-blog分支下）。点击访问

常用hexo命令

hexo g -d #一键生成并部署，最常用
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo g #生成静态页面至public目录
hexo s #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo d #部署到GitHub
hexo clean #清理旧文件

注意新建的博客markdown文件都在source文件夹下的_posts子文件夹中