Hexo+GitHub搭建免费个人博客详细教程

一、安装前提

1、你的电脑已经安装好Git,并且已经配置好了,如果没有请先移步:
小白的git使用指南(一)
小白的git使用指南(二)
2、你的电脑已经安装好了Node.js,安装镜像最好已经换成了国内的
Node.js安装教程(解决npm安装Hexo卡顿问题)

二、安装Hexo

如果你能按照上面的教程安装好所有必备的程序后(nodejs的安装源已换成国内镜像),你可以用 cnpm来安装Hexo。
打开 git bash,输入如下命令:

$ cnpm install -g hexo-cli

上面的 -g代表全局安装,hexo后的 -cli 代表命令行,也就是说再安装hexo的同时也会安装hexo的命令行。有的教程的安装命令都不带 -cli 我不知道可不可以,但官网上给出的是带的,以官方为准(嘿嘿)

三、本地搭建hexo博客

  • 在电脑上新建一个专门用来存放你的博客的文件夹,如 F:\GitHubblog
  • 在该文件夹下 右键-git bash here
  • 输入
hexo init  //在本地生成hexo模板

-完成之后,输入

hexo server 
博客页面

四、将博客托管到GitHub上

请确认自己的已经配置好了 git全局信息SSH Key,具体请参见 小白的git使用指南(二)

  • 在GitHub上创建以你的GitHub用户名(注意不是昵称)命名的项目,例如我的GitHub用户名为 qiuyeyijian 那么我就创建一个名字为:qiuyeyijian.github.io 的项目
  • 打开刚才新建的GitHubblog文件夹(存放hexo模板的),打开_config.yml配置文件(推荐sublime text 3),找到deploy,进行如下配置,完成保存。注意格式不能错,一定不能错,千万不能错(说多了都是泪)


deploy:
  type: git
  repository: https://github.com/qiuyeyijian/qiuyeyijian.github.io.git   //将地址换成自己的
  branch: master

1、冒号后面一定要有一个空格
2、type,repository,branch的首字母要对齐

  • 最后,运行下面这三个命令
运行:npm install hexo-deployer-git --save
运行:hexo g  //(本地生成静态文件)
运行:hexo d  //(将本地静态文件推送至Github)

此时,打开浏览器,访问 http://qiuyeyijian.github.io

推荐阅读更多精彩内容