使用hexo建立信息发布平台

Growinware
2018/04/11
文档

Hexo是一个快速、简洁且高效的博客框架，基于Node.js，适合用于维护静态内容的网站，并且集成了本地调试服务器、Github Page发布等功能，推荐用于维护项目课题的主页。

GitHub Pages 仓库

在GitHub账号下创建一个新的仓库，命名为username.github.io（username 为 Github 账号，例如本项目的账号为growinware-nju)。

GitHub Pages有两种类型：User/Organization Pages 和 Project Pages，而这里使用的是 User/Organization Pages。

简单来说，User Pages 与 Project Pages的区别是：

User Pages 是用来展示用户的，而 Project Pages 是用来展示项目的。
用于存放 User Pages 的仓库必须使用username.github.io的命名规则，而 Project Pages 则没有特殊的要求。
User Pages 将使用仓库的 master 分支，而 Project Pages 将使用 gh-pages 分支。
User Pages 通过 http(s)://username.github.io 进行访问，而 Projects Pages通过 http(s)://username.github.io/projectname 进行访问。

因此，这里使用 User/Organization Pages 的主要目的是得到一个能够直接访问的域名(https://growinware-nju.github.io)。

GitHub Pages Basics / User, Organization, and Project Pages。

安装与配置Git

使用 Hexo

安装

在安装 Hexo 之前，首先确保已经安装 Node.js 和 Git，然后只需在命令行中使用npm安装 Hexo 即可：

1	$ npm install -g hexo-cli

建立网站

在任意目录中，输入

1 2	$ hexo init $ npm install

则会自动完成网站的建立。建立完网站后可以使用hexo server(或简写为hexo s)启动本地的调试服务器，更多内容请参考 Hexo 官方文档

关联Github Page

为了能够使Hexo部署到GitHub上，需要安装一个插件：

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

然后，我们建立的是 User/Organization Github Page，根据 Github Pages 的约定，在master分支存放博客的实际内容，在另一个(任意)的分支中存放源代码。我们不妨将源代码保存在hexo分支中 (源代码的保存非常重要，用于实现信息聚合)，修改_config.yml中的部署配置：

修改后的_config.yml：

deploy:
  type: git
  repo: 对应的Github仓库地址
  branch: 分支 (因为我们建立User/Organization Page，因此目标分支是master，如果是项目的Github Page，则是gh-pages)。

然后，执行下列指令即可完成部署：

1
2
3

$ hexo clean
$ hexo generate
$ hexo deploy

如果一切配置正常，稍等片刻github.io就能完成更新了(自动生成内容并上传到master分支)。同时也不要忘记将源代码提交到Github的远程仓库中。

更多的文档请参考Hexo官网。

Growinware