使用hexo搭建github.io博客(一)

使用github.io可以搭建一个自己的博客,把静态文件项目托管到github上,可以写博客,可以使用markdown语法,也可以展示作品.灵活性高.但是有较大的难度.

node,git版本变化日新月异,每段时间都会有不同,而这个小不同可能直接导致搭建失败.这里把我搭建的过程记录下来.如果将来搭建失败,可以参考,下载对应的版本尝试.

我使用的版本(win7系统下:):

node: v0.10.22

git: Git-1.9.5-preview20141217  

搭建步骤:

1.安装好node和git,注册好github账号. 注意:用户名一定不能有大写.

想下载最新的git可以尝试这个地址: http://msysgit.github.io/

想下载我使用的版本,移步我的网盘: http://pan.baidu.com/s/1qWt5u36

2.安装hexo:

执行: npm install -g hexo

这里常常安装了一半就卡住装不下去了,fq后就ok了...

3.创建hexo文件夹:

自己找一个喜欢的路径,创建hexo文件夹,我的是安装在 E:hexo 下的. 

cmd窗口切换到对应的目录下,然后执行: hexo init 

也可以在 E:hexo 下右键,选择git bash,在窗口中执行 hexo init

它就自动安装了需要的文件.

4.安装依赖:

继续执行: npm install

安装好了所有的依赖

5.完成本地安装:

继续在 E:hexo 下执行:  hexo generate

继续执行: hexo server

然后在打开浏览器 localhost:4000 ,就可以看到,本地已经安装好了.

6.在github上创建博客仓库:

　　6.1新建仓库.

　　右上角的加号点击一下,选择New repository

　　

      跳转的后如下填写:(其中Repository name的格式是 '用户名'.github.io  ),然后点创建仓库

      

　　

　　6.2 生成测试页面

　　进入刚才创建的仓库,点击右边菜单中的Settings按钮，在跳转到的页面 Update your site 对应处点击“Automatic page generator”按钮，这样就有了一个github自动生成的页面用来测试的时候使用。之后点击继续。

　　

　　

　　6.3选择主题,点击'Publish page'发布:

　　

　　

　　6.4发布成功

　　再次回到仓库,点击6.2里的Settings按钮:

　　点击链接就可以看到测试地址页面.

　　

7.创建SSH keys

　　7.1 监测是否有已经存在的SSH keys:

　　打开 git bash 终端(可以在  E:hexo 下右键打开,也可以直接在开始菜单里打开)

　　执行:  $ ls -al ~/.ssh 

       如果有SSH keys: 就会看到如下文件 id_rsa    id_rsa.pub

　　

　　(除了我自己生成的这种,官方教程里说,SSH keys也有可能是以下几种文件:

• id_dsa.pub
• id_ecdsa.pub
• id_ed25519.pub

       )

　　

　　7.2 如果没有的话,就生成一个SSH keys: 粉色部分写自己的邮箱

　　$ ssh-keygen -t rsa -C "your_email@example.com" 

　　然后会出现:

　　Generating public/private rsa key pair.

　　Enter file in which to save the key (/Users/you/.ssh/id_rsa): 

　　就是让你输入SSH keys要保存在哪里,一般不用改,就直接回车就好了.

　　然后会出现:

　　粉色部分输入一个密码,这个密码后面会用到,所以要记住咯~

　   Enter passphrase (empty for no passphrase): [Type a passphrase] 　

　　# Enter same passphrase again: [Type passphrase again] 

　  

　　7.3 保存SSH keys:

　　创建成功后,他会提示你SSH keys保存在哪里:

　　Your identification has been saved in /Users/you/.ssh/id_rsa.

　　# Your public key has been saved in /Users/you/.ssh/id_rsa.pub.

　　# The key fingerprint is:

　　# 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

 

　　7.4 找到SSH keys:

　　根据上一步里告诉你的路径,找到保存SSH keys的地方,我的是在 C:Users2000104591.ssh

　　其中 id_rsa.pub 就是SSH keys 如果为了防止以后找不到,可以把他们自己另存到其它地方

8. 为github仓库添加SSH keys

SSH keys创建好了,我们还要把它添加到仓库里去

打开6.1创建的仓库,点击6.2时点击的右侧的'Settings',再左侧的'Deploy keys':

   

点击'Add deploy key':

然后把7创建的id_rsa.pub里的内容复制到Key里去,Title部分随便填. 点击'Add key'

添加的过程中,还要再输入一次github的密码

　　

 

9. 测试连接

回到git bash

执行: 

$ ssh -T git@github.com

它可能会出现一些乱七八糟的提示,最后是问你yes/no,就输入yes.

如果是这样子叫你输入密码.那这个密码就是在7.2里面设置的那个密码,就输入一下就好了

Enter passphrase for key '/c/Users/2000104591/.ssh/id_rsa':

最后它提示你:

Hi, 用户名/用户名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.

这样就算ok了~~~

10.配置_config.yml文件并发布:

在 E:hexo 下,有一个文件叫 _config.yml ,打开它,拉到最底下,做如下修改:　

deploy:
  type: github      //改成github
  repository: https://github.com/jinyanhuan/jinyanhuan.github.io    //改成自己的用户名
  branch: master    

配置完以后还是在E:hexo下执行:

hexo generate

hexo deploy

执行完以后,如果报错 Error: Deployer not found : github,则执行如下命令:

npm install hexo-deployer-git --save

同时修改 _config.yml :

deploy:
  type: git      //改成github   

然后再执行:

hexo generate

hexo deploy

然后访问: http://jinyanhuan.github.io/ (用户名改成自己的),就可以看到了.

注意,每次修改本地文件后，需要  hexo generate  才能保存。每次使用命令时，都要在 E:hexo 目录下 

好了,虽然搞了这么多,但这只是一个开始~~~  慢点继续搭建~~~

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------

2015 - 02 - 16 补充:

一. 如果需要在多台电脑上安装hexo:

1.执行步骤1-5

2.复制一个原来就有的ssh key到新的电脑.或者在新电脑上生成一个新的ssh key,添加到对应的github博客仓库里.

3.把原来的hexo目录下东西复制到新的电脑里.

二. hexo可能更新过了,所以老的hexo可能会报错:

{ [Error: Cannot find module './build/Release/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
{ [Error: Cannot find module './build/default/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
{ [Error: Cannot find module './build/Debug/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }

解决办法,执行:

npm install hexo --no-optional

以上搭建过程共参考以下文章:

搭建过程:

http://zipperary.com/2013/05/28/hexo-guide-2/

http://jingyan.baidu.com/article/ed2a5d1f3732cb09f7be1745.html

SSH keys:

https://help.github.com/articles/generating-ssh-keys/

http://blog.sina.com.cn/s/blog_698b9e160100nwna.html

http://blog.csdn.net/keyboardota/article/details/7603630

http://www.freehao123.com/hexo-node-js/

Error:Deployer not found:github

https://github.com/hexojs/hexo/issues/1040

后续操作全部转到本人的github.io博客: http://jinyanhuan.github.io/