GitHub+Hexo博客搭建

有幸在知乎知道了GitHub,然后逐渐尝试使用GitHub。查资料的时候偶尔看到说可以利用GitHub搭建个人博客,感觉很高大上的东西。
昨天搜了一些教程,照着把博客搭出来了,比想象中的简单,但是也遇到了一些问题,在此记录下来。
我用的Windows7,其他系统安装的情况可能会有所不同。

1. 安装

  • Git
    注:本文所使用的是Git-2.9.0-64-bit.exe版本。
  • Node.js
    注:本文所使用的是node-v4.4.7-x64.msi版本。

2. Hexo相关操作

  • 安装完Git和Node.js之后,在任意位置点击鼠标右键,选择Git Bash,输入命令:npm install -g hexo安装hexo。
  • 在Hexo文件夹下点击鼠标右键,打开Git Bash,执行hexo init,Hexo会建立网站所需的所有文件。
  • 输入npm install安装依赖包。
  • 本地Hexo博客建好了,在Hexo文件夹下打开Git Bash执行hexo s -g,然后打开浏览器输入localhost:4000查看。

3. GitHub相关操作

  • 在个人的GitHub账号下,新建一个仓库,仓库名一定形如:[username].github.io例如zz0116.github.io
    此处输入图片的描述
  • 在创建好的Repository下,找到clone URL,复制地址。
    点开Clone or download
  • 在Hexo文件夹里找到_config.yml(全局配置文件),打开后对deploy部分进行修改。此处输入图片的描述

4. 部署Hexo到GiHub

  • 打开C:\Users\xxx\.ssh,查看是否有文件,如果有的话,直接删除里面的所有文件。
  • 在Git Bash里面输入ssh -keygen -t rsa -C "xxxx@xxx.com"邮箱为注册GitHub时的邮箱,回车后会提示输入passphrase,直接回车,然后输入以下命令:此处输入图片的描述
  • C:\Users\xxx\.ssh里找到id_rsa.pub文件,打开后复制内容,然后打开你的GitHub的setting,点击New SSH key如图,此处输入图片的描述,将刚刚复制的key粘贴进去,Title可以随意取,完成SSH key的添加。
  • 在Git Bash里面输入ssh -T git@github.com命令,在询问continue connecting时输入yes
  • 最后一步,输入hexo d -g。整个GitHub+Hexo博客就搭建成功啦,打开浏览器输入http://[username].github.io例如zz0116.github.io,就可以看到搭建好的博客了!

Tips:

  1. 有些教程在对_config.yml里的deploy修改部分,设置type: github,会出现问题,看起来似乎是空格的问题,而且去掉空格就不报错,但是后面的部署没法成功。在_config.yml里进行配置的时候,冒号后面的空格是一定要的。这里把github改成git就好了。
  2. hexo clean可以对hexo g生成的文件进行清除。
  3. 从头到尾都不需要git add或者git commit命令。hexo d -g即会将本地的修改推送到GitHub上。
  4. Hexo文件夹可以随意移动。
  5. 解决Cannot GET /的办法:npm install hexo-renderer-ejs --savenpm install hexo-renderer-stylus --savenpm install hexo-renderer-marked --save然后重新输入hexo s -g即可。
  6. 解决hexo server命令没有作用的办法:install hexo-server --save
  7. (2016.07.17更新)尝试用GoogleDrive时出了点问题,导致一直是404,本地的localhost:4000能打开,而且没一点问题,也能提交到github。思来想去只有一个原因,就是该提交的.html文件没有提交上去,据此将hexo安装的步骤重复了一遍,当然提前把theme、source、public几个文件夹以及_config.yml配置文件备份了一份。重装hexo果然好了,再将几个文件夹和文件替换,完美解决!