已经拖了好久了，终于下定决心想把自己怎么使用hexo+github更新博客的过程记录下来

首先你得了解如下技术和技能：

  • npm
    –node package management 是node的包管理器，可以用npm命令安装各种互联网的资源如js库
  • hexo
    –这是一款用node.js开发的开源博客模板引擎，我就是用的它生成的这个博客，与之对应的还有jekyll等
  • git
    –这是由linux之父linus大神花两周时间开发出的开源分布式版本控制系统，小巧高效灵活
  • markdown
    –按我的理解就是一种文本输入方式，就是我现在更新博客的一种编辑方式，这是参考文档
  • github
    –这是广大程序员的代码分享之地（全球最大同性交友平台），可以托管/分享自己的代码也可以fork他人的代码，还可以利用它的github page功能建一个简单的github博客等等

好了现在正式叙述下过程

  1. 安装npm，在这之前必须安装node.js,去官网下载node并安装，安装完node会自动安装好npm, 可用bash node -v和npm -v查看是否正确安装

  2. 直接用npm安装hexo，并初始化
    初始化好的目录结构如下：

    1
    2
    3
    4
    5
    $ npm install hexo-cli -g		// -g是指全局安装
    $ hexo init myblog  
    $ cd blog
    $ npm install		// 安装package.json里的js包
    $ hexo server		// 这里hexo已用browsersync实现了浏览器自动刷新，不必手刷

    此时你可以打开localhost:4000，查看本地hexo博客主页有没有初始化成功。
    下图是hexo默认的博客主页：

  3. 更换hexo主题，美化博客
    去官网的theme页面寻找你喜欢的主题，然后下载下来，根据该主题的操作说明一一安装需要的包。以我用的apollo主题为例，需要先下载该主题依赖的一些包:
    npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive然后再把该主题文件clone到themes文件夹下
    同时修改 _config.yml 的 theme 配置项为 apollo。好了之后执行：

    1
    $ hexo generate

    如果报错的话，一般是这个主题所需要的包你没有安装完全。如果没报错就执行如下：

    1
    $ hexo server

    这个时候就可以继续打开localhost:4000查看新主题有没有安装成功了。
    我这博客使用的是apollo主题,比较喜欢简洁风格的。

  4. 配置github,建立关联

    1. github申请一个repository
      去个人的github页，create new repository，库的名字必须写{username}.github.io，这里的username就是你的github账号名。建好之后再激活一下github pages,这个得去repository的setting里设。此时成功之后，你就可以通过 http://username.github.io 访问你的个人页了，当然这只是github给你提供的简单的展示页面，要想做成博客就必须用到hexo等这些静态博客引擎。
    2. github添加ssh key
      可以看这个，具体也可百度。

    3. 和本地hexo建立关联
      这一步是最主要的，就是用本地hexo代码代替github个人页中username.github.io中的代码。
      再次找到_config.yml，修改如下：

      1
      2
      3
      4
      5
      deploy:
      type: git
      repo: https://github.com/MiaoJiHui/mia
      ojihui.github.io.git
      branch: master

      还有其他参数也要相应改掉，比如theme改成你当前用的主题名。
      改好之后执行命令：$ npm install hexo-deployer-git --save //下载hexo下的git工具包

  5. hexo命令

    然后再执行:

    1
    2
    $ hexo generate
    $ hexo deploy

    如果不报错的话，此时就已经部署成功了，你可以通过https://miaojihui.github.io的方式访问你的个人博客啦，第一次成功的时候还是非常兴奋的！

  • 附赠些常用命令

    hexo new “postName” #新建文章

    hexo new page “pageName” #新建页面

    hexo generate #生成静态页面至public目录

    hexo server #开启预览访问端口（默认端口4000，’ctrl + c’关闭server）

    hexo deploy #将public目录部署到GitHub

    hexo help # 查看帮助

    hexo version #查看Hexo的版本

一般来说，我都是在本地blog文件夹下执行hexo server命令，然后再用markdown更新编写博客，可以实时看到效果。编辑好了之后就用hexo generate和hexo deploy命令生成并部署到github上。总之，熟悉了markdown语法后，更新博客来说还是蛮方便的。在此感谢markdown/hexo作者和github。

参考：http://www.jianshu.com/p/465830080ea9