终于有了自己的github博客了。记录下搭建Github.io博客的过程以及当中所遇到的坑。

Hexo是什么

Hexo是一个基于nodejs快速、简洁且高效的博客框架。可以方便的生成静态网页文件托管到github pages。具有超快渲染速度、支持GitHub Flavored Markdown语法、一键部署等优点,同时还拥有强大的插件系统,方便用户进行定制化开发。

Hexo 安装

本教程只针对windows用户。

安装前提

在安装Hexo之前,请先安装

  • Node.js
  • Git

安装 Git

下载msysgit进行安装即可。

安装 Nodejs

在windows下安装nodejs非常简单,直接去官网下载进行安装即可。

安装 Hexo

Hexo安装也很简单。在Git和Node.js都安装后,直接使用npm进行安装即可

1
npm install -g hexo-cli

创建Hexo文件夹

在你喜爱的文件夹下,如(D:\hexo),右键选择git bash,执行以下命令。便会自动新建所有的文件

1
hexo init

安装所依赖的包

1
npm install

本地查看

到这一步,你已经在本地安装了Hexo博客。你可以通过以下的命令在本地查看博客。

生成静态文件

1
hexo generate

运行服务

1
hexo server

此时在浏览器中输入localhost:4000,便可以看到博客了。至此,本地博客已经搭建好了。但是此时博客还只是在本地,别人是无法访问的。

Github部署

注册Github账号

有账号的人跳过,没有的话注册下也很简单。

创建 repository

在个人github主页右下角点击 New repository,创建一个新的repository。
新的repository的名字应该跟你github账号的名字一样。比如我的github账号是superman66
那么新的repository的名字就应该为superman66.github.io

部署

进入博客所在的文件夹(如D:\hexo),找到_config.yml文件,修改以下的配置,将下面的superman66都换成你自己的账户名。

1
2
3
4
deploy:
type: git
repository: https://github.com/superman66/superman66.github.io.git
branch: master

注意:hexo 3.0以下,type要写成 github
这个参数是用来配置网站一键部署的。让你只需要一条命令就可以将网站部署到服务器上。
配置文件修改之后,执行一下命令便可以完成部署了。

1
2
hexo generate
hexo deploy

hexo常用命令

  • hexo new "post_name"用于生成新的文章;
  • hexo generate用于生成静态文件;
  • hexo server 用于启动本地服务;
  • hexo deploy用于将生成的静态文件部署到repository上。

同时这四个命令还支持简写
hexo g === hexo generate
hexo s === hexo server
hexo d === hexo deploy
hexo n === hexo new
至此,你已经将本地的博客部署到github上。你可以通过username.github.io(username换成你自己的账户名)来访问你的博客了

问题记录

在部署过程中,执行hexo d进行部署的时候,出现以下的错误
hexo bash: /dev/tty: No such device or address

解决办法:

安装github for Window,点击这里进行下载,使用git shell再执行hexo d命令进行部署即可。
ps:由于github for windows 在国内安装很容易失败,自己尝试了很久也都没装上。不过网上已经有人提供了github for windows离线版,有兴趣的人可以前往下载

问题的原因:

google找到的说法是,由于window安装的git版本问题导致的。