Hexo简介

Hexo是什么

Hexo(中文官方网站)是一个快速,简洁且高效的博客框架,让上百个页面在几秒内瞬间完成渲染。Hexo 支持 GitHub Flavored Markdown 的所有功能,甚至可以整合 Octopress 的大多数插件,只需一条指令即可部署到 GitHub Pages, Heroku 或其他平台,而且Hexo自己也拥有强大的插件系统:强大的 API 带来无限的可能,与数种模板引擎(EJS,Pug,Nunjucks)和工具(Babel,PostCSS,Less/Sass)轻易集成。

安装node.js

Hexo是基于 node.js 的,所以我们在安装它之前需要用到 npm 安装工具,这个工具是 node.js 安装包的工具;另外我们还会用到git工具,所以请先确保已经安装下列应用程序:

安装 Hexo

使用npm安装hexo

1
npm install -g hexo-cli

创建Blog

现在我们已经完成hexo的安装,那么现在我们来创建一个Blog:

  1. 创建一个名称为blog博客

    1
    hexo init blog

    如果不写blog,就会在当前目录进行初始化。如果后面跟了名称就会创建目录并在指定目录下进行初始化操作,以这个名字为目录名。

  2. 我们进入创建的blog目录里。并运行该服务

    1
    2
    3
    cd blog
    npm install
    hexo server
  3. 打开浏览器,在地址栏输入http://localhost:4000/可以看到我们刚刚创建的blog首页

  4. 安装部署使用到的git插件
    我们使用的是git源码管理工具,所以安装这个插件才能使用git进行自动部署:

    1
    npm install hexo-deployer-git --save
  5. 修改blog目录下的 _config.yml 配置文件将网站自部署到Github

    1
    2
    3
    4
    deploy:
    type: git
    repository: git@github.com:用户名/用户名.github.io.git
    branch: master

    注意在type前面需要增加两个空格,在type的冒号后面需要增加一个空格。请保持代码风格一致。否则会出现错误。

  6. 生成网站
    当我们部署网站前,需要先生成静态网站。执行命令hexo g会自动在目录下创建public的目录,并将新生成的网页存放在这个目录里

    1
    2
    cd blog
    hexo g
  7. 手动部署网站

    注意:部署前需要重新生成网站,每一次修改后都需要重新生成网站并进行部署,生成网站请看第6步。

    1
    hexo d

    如果在部署出现如下错误信息请参考第4步,需要提前安装git部署插件

    1
    ERROR Deployer not found: git
  8. 如果上面的步骤都已经顺利完成了,恭喜你,你已成功完成了第一个网站的部署和搭建

  9. 打开浏览器输入网址:https://用户名.github.io 欣赏一下你的成果:)

参考资料

hexo官方网站(中文)
hexo官方网站(英文)
Hexo官方API(中文)
Hexo官方文档(中文)
Github官方网站
Node.js官方文档
Node.js安装文档