搭建 Hexo + Github 博客

引言

本工作的根本目的是在Github上搭建一个个人博客。其优点是免费,而且可以学习Git。因此本人从今天开始打算将博客平台转移到Github上来。

Github上可以用来搭建博客的工具大概有三个:Hexo, Jekyll, octopress等。但是经过研究发现最好的方式还是采用Github + Hexo的方式,因此这里介绍的方法正是基于该方法。

基于Github + Hexo的博客搭建方法网上有许多教程,可以参考中文的详细教程。推荐一下两个网站上的详细教程:

  1. 如何搭建一个独立博客——简明Github Pages与Hexo教程
  2. Hexo主题博客
  3. 使用GitHub和Hexo搭建免费静态Blog

博客的搭建

参考上述的内容1, 2, 3

  1. 安装Github for Windows
  2. 安装node并设置环境变量:;C:\Program Files\nodejs\node_modules\npm
  3. 安装Hexo:配置好GitHub目录后,在Github目录下新建一个文件 hexo,双击桌面上的Git Shell,输入npm命令即可安装。更多的帮助文件可以参考:http://hexo.io/zh-cn/docs/

    cd hexo
    npm install -g hexo-cli
    npm install hexo --save
    
  1. 部署Hexo:在Git shell 中输入hexo init
  2. 安装Hexo 插件:非必要步骤

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    npm install hexo-generator-index --save
    npm install hexo-generator-archive --save
    npm install hexo-generator-category --save
    npm install hexo-generator-tag --save
    npm install hexo-server --save
    npm install hexo-deployer-git --save
    npm install hexo-deployer-heroku --save
    npm install hexo-deployer-rsync --save
    npm install hexo-deployer-openshift --save
    npm install hexo-renderer-marked@0.2 --save
    npm install hexo-renderer-stylus@0.2 --save
    npm install hexo-generator-feed@1 --save
    npm install hexo-generator-sitemap@1 --save

  3. 测试本地效果:采用命令: hexo d -g,或hexo generate, hexo server,成功后可登录localhost:4000查看效果。

  4. 新建仓库。在Github上新建一个Github Pages,即建立一个仓库New Repository,命名为jianghao.github.io,注意这里必须命名为io,而不是com。因为Github Pages的Repository名字是特定的,比如我Github账号是jianghao,那么我Github Pages Repository名字就是jianghao.github.io。
  5. 用Hexo克隆主题。首先克隆你想要的主题。一个完整的主题列表可见:https://github.com/hexojs/hexo/wiki/themes 。个人倾向的主题为:
  6. 修改与调试
    启动本地服务:hexo serve
    部署到Github前需要配置_config.yml文件
1
2
3
4
deploy:
type: git
repository: git@github.com:jianghao/jianghao.github.com.git
branch: master

如果是为了项目制作网站,需要将branch设置为gh-pages,如果需要绑定域名,需要制作一个cname文件。因为每次deploy的时候hexo都会重新生成文件,所以直接加在github是不好使的,这个文件需要放在 hexo folder/source文件夹根目录下。

执行完,开始部署,即先hexo generate,然后hexo deploy。也可以一部到位:hexo d -g

  1. 将独立域名与GitHub Pages的空间域名绑定
    • Githubpage 设置:在Repository的根目录下面,新建一个名为CNAME的文本文件,里面写入你要绑定的域名,如jianghao.wang
    • DNS设置:注册DNSpod,添加域名,不是必要的步骤,但是据说可以提高解析效率。本人没有测试。
    • 在域名服务商,如net.cn中修改增加两条A记录,指向github pages 提供的 ip
      • 192.30.252.153
      • 192.30.252.154

Hexo 设置

主要参考:hexo博客的配置、使用

设置_config.yml

参考上述文章的内容。hexo博客的配置、使用

设置主题配置文件

coney主题参考:coney主题介绍

Next主题参考:Next 主题
个人对该主题进行了一些修改,修改后的内容备份在Github 的Gist上:https://gist.github.com/Jianghao/9197abdb7482c6bf9df7

内容如下: