By

文章目录
  1. 1. 安装
  2. 2. 创建blog
  3. 3. 写作工具

网络上，随便搜一下hexo、github等关键词，就能出来一大堆相当详尽的博客搭建介绍，
我也是一步步跟着做下来，本文主要记录一些自己碰到的问题。

安装

  1. 安装Node.js和git，这里不再赘述

  2. 检查npm是不是在PATH下面

    1
    $ which npm

  3. 安装hexo

    1
    $ npm install -g hexo-cli

    转圈圈运行之后，报错

    1
    2
    3
    4
    5
    6
    npm ERR! registry error parsing json
    npm ERR! Linux 2.6.32-358.el6.x86_64
    npm ERR! argv "<nodejs-dir>/bin/node" "<nodejs-dir>/bin/npm" "install" "-g" "hexo-cli"
    npm ERR! node v0.12.6
    npm ERR! npm  v2.11.2
    npm ERR! Unexpected end of input

    可能是被墙了，加一个国内的源

    1
    2
    3
    $ npm config set registry https://registry.npm.taobao.org
    // or edit ~/.npmrc, put the following line into it
    // registry = https://registry.npm.taobao.org

    现在就可以顺利安装了。

创建blog

  1. 在github上建一个名为blog的repo，然后clone到本地，在gh-pages分枝上建立
    project page的方式来存放自己的blog

    1
    2
    3
    4
    5
    6
    7
    $ git clone https://github.com/niaokedaoren/blog.git
    $ cd blog
    $ git checkout --orphan gh-pages
    $ git rm -rf .
    $ git add .
    $ git commit -m "initial commit"
    $ git push origin gh-pages

    报错：
    error: src refspec github-pages does not match any.
    error: failed to push some refs to ‘https://github.com/niaokedaoren/blog.git‘
    解决： push不能为空

    1
    2
    3
    4
    $ touch README
    $ git add .
    $ git commit -m "add dummy README"
    $ git push origin gp-pages

    上传一个rsa public key到github，可以实现无密钥登陆。

  2. hexo建立blog

    1
    2
    3
    $ hexo init blog
    $ cd blog
    $ npm install

    生成blog并启动hexo server，可以在 http://localhost:4000访问blog

    1
    2
    $ hexo g
    $ hexo s

  3. 配置_config.yml

    • deploy
      1
      2
      3
      4
      deploy:
        type: git
        repo: ssh://git@github.com/niaokedaoren/blog.git
        branch: gh-pages

    注意: 如果这里repo写成https://github.com/niaokedaoren/blog.git
    就会报错：pushing-to-git-returning-error-code-403-fatal-http-request-failed

    • url
      1
      2
      url: http://niaokedaoren.github.io/blog
      root: /blog/

    否则部署到github上会无法加载css

  4. 选择主题

    我选择的是jacman

    1
    2
    $ cd <blog-dir>
    $ git clone https://github.com/wuchong/jacman.git themes/jacman

    可以注册一个多说，在themes/jacman/_config.yml配置一下多说shortname。

  5. 常用的命令

    1
    2
    3
    4
    5
    6
    $ hexo new "post name" #写新的博客
    $ hexo new draft "draft name" #写博客草稿, scaffolds目录下可以编辑layout
    $ hexo clean #清理生成的页面
    $ hexo g
    $ hexo s
    $ hexo d

写作工具

我用的是sublime text2，具体配置参考http://www.jianshu.com/p/378338f10263

参考

  1. http://cnfeat.com/2014/05/10/2014-05-11-how-to-build-a-blog/
  2. http://www.aips.me/hexo-independent-blog-new-ways.html
文章目录
  1. 1. 安装
  2. 2. 创建blog
  3. 3. 写作工具