用hexo极速搭建博客

发表于 2016-02-16 分类于学习

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

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必备插件

$ 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目录

hexo g

本地启动

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

hexo s

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

发布

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

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

保存配置文件后，执行如下命令：

hexo d

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

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

附录

常用命令：

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的版本

简写：

hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy

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