如何在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