使用github和hexo搭建静态博客

获得更多资料欢迎进入我的网站或者 csdn或者博客园

终于写这篇文章了，这是我使用github和hexo搭建博客的一些心得，希望能给大家一点帮助。少走点弯路。刚接触github，只是用来存项目的版本，后来突然发现可以使用这个搭建静态网页博客。哇，卧槽，还可以这样装逼，果断搞起。由于什么都不懂，一搞就是。一周。主要是网上找了一堆的教程，搞得到处时bug。现在主要讲讲我的经历，我也相信如果你跟着这篇文章，你也可以搭建成功；

先关文章请点击：

使用github和hexo搭建静态博客

hexo的jacman主题配置

hexo博客的相关配置

github注册以及建立创库

注册github

1进入github主页点击右上角完成注册链接

2验证邮箱这步很重要按如下图所示：

创建仓库（repository）

1点击右上角加号创建仓库，如下图所示：



2按下图建立仓库。这是需要特别注意的就是Repository name，必须为username.github.io。不然不能被github解析；

基本环境的安装

windows下环境的安装

我的配套软件下载地址：软件下载

可以用我的版本

1安装node

到node.js官网下载windows平台的最新版本一路安装即可

2安装GIT

git的客户端我用的是msysgit 下载地址

安装步骤可参考安装经验

ubuntu下环境的安装

1安装node.js

hexo官方推荐的安装方法是使用nvm

安装nvm可以使用下面两个命令中的任何一个：

$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

或者Wget:

$  wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

当nvm安装完成后。运行一下命令安装node.js

$ nvm install 0.10

我这里安装的node.js版本是0.10.39可用使用nvm ls命令查看 至此本地环境安装完成

注意如果当输入命令nvm ls时没有版本信息，通过下面语句启动nvm
nvm use 0.10.39
#ubuntu下可能在关机后还会显示没启动nvm，你可以每次使用hexo前执行这条语句启动nvm

2git的安装

ubuntu安装git直接apt-get就可以了

$ sudo apt-get install git-core

hexo的安装

windows下启动git bash终端。ubuntu下直接启动终端。之后不在做说明统一使用ubuntu下的终端。windows下的终端是一样的；

在终端输入以下命令安装：

npm install -g hexo

建立hexo初始化的目录，我将博客放在了~/hexo 目录下；使用以下命令 hexo init 你的目录

hexo init ~/hexo
npm install

现在本地版本的hexo已经配置完成了，可以使用以下命令来生成静态文件

1
$ hexo generate
或者
1
$ hexo g
使用以下命令启动本地服务器进行预览
1
$ hexo server
或者
1
$ hexo s

然后通过http://localhost:4000/进行访问，如果页面正常打开，那么恭喜你，你的本地博客已经搭建完成，还差一点点就可以进行发布了。

添加添加SSH-Key

首先设置你的用户名密码：注意使用你自己的邮箱和名字

git config --global user.email "wpeace1212@gmail.com"
git config --global user.name "wpeace"
生成密钥：

ssh-keygen -t rsa -C "wpeace1212@gmail.com"
  按3个回车，密码为空这里一般不使用密钥。

最后得到了两个文件：id_rsa和id_rsa.pub根据提示找到文件所在地；

用文本编辑器打开id_rsa.pub复制其内容添加到github的sshkey按下图方法添加：

注意ssh keys在设置里面

第一步：

第二步：

最后可以通过下面的命令测试是否成功：

ssh -T git@github.com

主题安装

1在博客主目录下输入以下命令：

这个主题比较小清新是wuchong创作：

git clone https://github.com/wuchong/jacman.git themes/jacman

2启用jacman

修改Hexo目录下的config.yml配置文件中的theme属性，将其设置为jacman。

#注意：后有空格

theme:  jacman

#通过下面的命令可以本体观看

hexo g

hexo s

配置git并发布：

1、首先编辑你的hexo安装目录下的_cofig.yml文件，下找到如下图并修改成你的：

deploy:
  type: git
  repository: git@github.com:wpeace1212/wpeace1212.github.io.git
  branch: master

2、通过使用下面命令即可完成部署，并可以通过wpeace1212.github.io访问你的博客：

hexo clean

hexo g

hexo d

我的显示如下：也可以点击观看我的网站点击观看

文章编写：

hexo使用的是markdown语法；

1、执行new命令，生成指定名称的文章至hexo\source_posts\postName.md。、

hexo new "postName"

2打开postName.md 文件。可以添加categories:并在正文处编写

title: postName #文章页面上的显示名称，可以任意修改，不会出现在URL中

date: 2013-12-02 15:30:16 #文章生成时间，一般不改，当然也可以任意修改

categories: #文章分类目录，可以为空，注意:后面有个空格

tags: #文章标签，可空，多标签请用格式[tag1,tag2,tag3]，注意:后面有个空格

----
正文

3使用下面的命令发布并观看

hexo g
hexo d