Fork me on GitHub

Hexo中讲hexo

Hexo教程

立志打造史上最全的hexo搭建博客教程。。。。。

早期的时候接触并捣鼓了hexo框架搭建博客,并成功搭建博客,也整理了文档,由于后来没有管理,删掉了博客仓库,然而,如今想重新捡起的时候,发现当初整理的文档唤起不了我的记忆,倒腾了半天才知道怎么搭建。所以今天就想写一篇比较全的流程,可以避免初学者不停地google和百度,耗时耗力。

##安装hexo

首先要具备Node环境,git命令工具。
安装hexo

1
$ npm install -g hexo

初始化hexo

1
2
3
$ hexo init [NewFileName]
$ cd [NewFileName]
$ npm install

初始化git

1
2
3
4
5
6
$ git init
$ git add .
$ git commit -m 'init'
#远程github上新建仓库
$ git remote add origin git@...
$ git push -u origin master

注:
如果github项目名称为[username].github.io,则master分支作为Pages静态页,其它名字的项目新建gh-pages分支作为Pages静态页。什么意思呢,作为吃过这个亏得我,得重点说一说,其实还是概念混乱的问题。。。。

什么是静态页面,就是无需经过服务器的编译,直接加载到客户浏览器上显示出来。静态页面需要占一定的服务器空间,且不能自主管理发布更新的页面,也就是说github只会将静态页分支部署上去,不会动你其他的分支,所以我们就往往会新建一个分支用来更新和开发代码。

所以假设我们的项目名称为[username].github.io,那么我们就在master分支上面生成静态页面,而在其他你自己新建的分支上面进行代码的开发,也就是说push和发布都是在其他分支上进行的(一句话,永远不要切换到master分支就可以了)。懂了吧(可能只有我不懂T^T)

配置文件

项目根目录下得配置文件_config.yml,可以参考hexo中文文档来进行配置,注意别忘了在_config.yml中配置deploy。

1
2
3
4
deploy:
type: git
repo: git@github.com:[username]/[username].github.io.git
branch: master // 静态文件分支,如果不是[username].github.io.git形式的,就写gh-pages

其他的网站基本配置我这里就不多说了,如果想要更换默认主题,可以去搜索好看的喜欢的主题,只需要将该主题clone到themes下面新建的文件夹里就可以拥有该主题了。比如较优秀的next主题

1
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

主题的使用可以参考官方的文档。戳这里
还有一些细节不容忽视。戳这里

github绑定域名

首先你得有个域名,然后在dnspod或者其他域名管理网站上进行域名解析,还记得刚刚新建的仓库吗?[username].github.io,只需要将[username].github.io作为记录值,记录类型为CNAME,就可以根据你自己的需求进行一级二级域名的解析。

hexo绑定域名

github

在项目根目录下新建CNAME文件,写入你刚刚配置的域名。同时千万记得将该文件复制到source文件夹里面。不然没有用哦(我也吃过这亏,主要还是粗心加没有记笔记。。T^T)

coding.net

在coding.net项目主页的pages服务选项里面绑定域名,同时会提供给你一个CNAME记录的指向

hexo博客同时部署至github和Coding

这有个很好的教程http://blog.csdn.net/u011303443/article/details/51509351

发布

当你在本地进行各种开发修改和调试以后,那么激动人心的时刻来了,可以开始部署啦。

首先安装hexo-deployer-git

1
$ npm install hexo-deployer-git --save

在当前分支上提交代码,然后切换到静态页master分支上发布

1
$ hexo d -g

done!

-------------本文结束感谢您的阅读-------------
如果您觉得受益了,欢迎打赏鼓励。