如何在github上创建个人博客-hexo篇

date: 2016-01-05 22:58:23

本文记录了我今天在win7环境下搭建hexo博客的一些简单步骤，和遇到的一些坑，希望对遇到困难的朋友有所帮助。

1. 环境准备

win7环境
安装git
安装node.js 下载地址：http://nodejs.org/dist/v0.10.22/node-v0.10.22-x86.msi

2.github配置

第一步：创建一个名为【your_user_name.github.io】的仓库，例如我的github名为kexun， 因此我建立的仓库名为【kexun.github.io】。 创建的时候创建一个默认空的仓库即可，如图：
点击create repository 创建完成

第二步：需要在客户端配置ssh

3. 安装hexo

在git-bash中执行如下命令：

1
$ npm install -g hexo

4. 简单创建

  1. 创建blog
    在电脑中创建一个文件夹 文件夹名字即为blog名 我创建的为blog-test
    然后输入如下命令，看到此结果，表示创建成功
    1
    2
    3
    4
    kexun@kexun-PC MINGW64 /d/Git/blog/blog-test
    $ hexo init
    INFO  Copying data to D:\Git\blog\blog-test
    INFO  You are almost done! Don't forget to run 'npm install' before you start blogging with Hexo!

创建成功后，在blog-test目录下会出现几个文件，如下图：
/images/22.png

source文件夹后面要用到，创建的文章都会放到该目录下。
themes文件夹主要放与主题相关的文件
_config.yml文件后面配置会用到

然后运行：

1
npm install

  1. 启动服务
1
hexo server

我一开始启动服务的时候遇到了两个问题，第一次是发现没有安装server模块，于是执行以下命令进行安装：

1
npm install hexo-server --save

安装成功以后，再次执行即可启动服务，出现下面信息表示成功：

1
2
$ hexo server
INFO  Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

但是当我访问http://localhost:4000 的时候发现,网站无法访问，具体原因我要不知道，后面的解决方法是换一个端口：

1
2
$ hexo server -p 5000
INFO  Hexo is running at http://0.0.0.0:5000/. Press Ctrl+C to stop.

然后就可以访问博客了。你可以看到hexo生成的一篇hello word

5.创建文章

在blog-test目录下执行以下命令：

1
2
$ hexo new "第一篇文章"
INFO  Created: D:\Git\blog\blog-test\source\_posts\第一篇文章.md

然后你可以通过markdown的编辑器，编辑source目录的下的 第一篇文章.md

6.部署到github

  1. 编辑_config.yml文件
    首先找到以下内容：
    1
    2
    3
    4
    # Deployment
    ## Docs: http://hexo.io/docs/deployment.html
    deploy:
      type:

替换成

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: git@github.com:kexun/kexun.github.io.git
  branch: master

注意，新版hexo 将type中的github改成了git, repository就是之前创建的仓库的ssh的url。

  1. 执行以下命令：
    1
    $ hexo generate

生成静态文件,然后执行以下命令：

1
$ hexo d

如果执行这步出问题了，不要急，首先判断是否安装了deploy模块，如果没有，就执行安装命令：

1
npm install hexo-deployer-git --save

安装成功以后再次部署，然后就能在http://kexun.github.io/ 上访问我的博客了。

  1. 后续
    以后如果要新增文章的话，基本上是这样一个流程
    1
    2
    3
    4
    hexo new "title"
     hexo clean
     hexo generate
     hexo d