用hexo极速搭建博客

hexo是一个非常轻量且快速的博客生成框架,可以使用markdown便捷的生成文章。
本文主要介绍windows下如何搭建hexo3.0+环境并发布至github。默认读者具有命令行使用经验和一定的web编程基础。

作者:Icarus
原文链接:用hexo极速搭建博客

hexo搭建完成后只需要三步就可以完成博文的更新。

1
2
3
hexo n #新建
hexo g #生成
hexo d #发布

下面介绍windows下如何搭建hexo3.1.1环境并发布至github

环境准备

安装node.js

node.js官网下载node.js并安装。我使用的是win8.1 x64下的4.2.4版本。

安装Git

git客户端很多,我使用的是git官方提供的工具,下载速度可能较慢。

安装sublime(非必须)

作为一个小前端,sublime作为编辑器实在是不能再好用,不过这个只是作为文本编辑器使用,大家可以根据喜好自由选择工具,切记不要使用windows自带的记事本。

Github

我们使用Github官方提供的Github Pages这一服务来作为静态博客的服务器。申请Github账户和与git通过ssh建立连接网上有很多详细的教程,此处不再赘述。
GitHub Help - Generating SSH Keys

安装

node.js和git安装好后,建议使用git提供的命令行窗口进行操作。
windows自带的cmd会报错。
执行如下命令可安装hexo:

1
npm install -g hexo

初始化

执行init命令初始化hexo到你指定的目录。

1
hexo init <folder> #folder为你指定的目录

或者cd至指定目录,执行hexo init

至此,hexo的安装工作已经完成。

hexo必备插件

1
2
3
4
5
6
7
8
$ npm install hexo-generator-index --save #索引生成器
$ npm install hexo-generator-archive --save #归档生成器
$ npm install hexo-generator-category --save #分类生成器
$ npm install hexo-generator-tag --save #标签生成器
$ npm install hexo-server --save #本地服务
$ npm install hexo-deployer-git --save #hexo通过git发布(必装)
$ npm install hexo-renderer-marked@0.2.7--save #渲染器
$ npm install hexo-renderer-stylus@0.3.0 --save #渲染器

生成静态页面

cd至之前初始化的目录,执行如下命令,即可生成静态页面至public目录

1
hexo g

本地启动

执行如下命令,启动本地服务,进行预览。
必须安装hexo-server,不然无法启动本地服务器

1
hexo s

浏览器输入 localhost:4000即可访问默认的hexo博客效果。
注意hosts文件中localhost是否被占用以及4000端口可能被福昕阅读器占用

发布

编辑hexo根目录下的_config.yml文件,找到最下面的deploy
hexo2和hexo3此处配置不一样,我使用的是hexo3.1.1为如下格式。

1
2
3
4
deploy:
type: git
repo:https://github.com/xdlrt/xdlrt.github.io.git #你的GitHub Pages的https链接
branch:master

保存配置文件后,执行如下命令:

1
hexo d

注意yml格式文件冒号后面必须加一个空格
执行完毕后访问xdlrt.github.io即可看到部署在github上的默认博客。第一次发布可能会有10分钟的延迟。

至此,hexo已经成功帮我们生成了一个博客,非常的方便

附录

常用命令:

1
2
3
4
5
6
7
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

简写:

1
2
3
4
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

坑:
1.有时会出现首页只有一篇文章的情况,这个时候需要hexo g渲染两次,原因不明。
2.标题中不能含有[]否则无法编译

参考资料:

hexo你的博客|不如
最新版Hexo配置
hexo静态博客使用指南
用hexo3搭建博客
如何查看某个端口被谁占用
NexT-an elegant theme for hexo