提醒:本文最后更新于 474 天前,文中所描述的信息可能已发生改变,请谨慎使用!
你似乎正在查看一篇很久远的文章。
为了你这样的访客,我特地保留了我的历史博文。不要笑话过去的我,用温柔的目光看下去吧。

在完成这个wordpress站点的搭建之后,我忽然发现了Github Pages。 看到网上好多以github.io结尾的博客,瞬间觉得好炫酷有没有,于是我也准备搭建一个

GitHub Pages

Github Pages 是面向用户、组织和项目开放的公共静态页面搭建托管服 务,站点可以被免费托管在 Github 上,你可以选择使用 Github Pages 默 认提供的域名 github.io 或者自定义域名来发布站点。Github Pages 支持 自动利用 Jekyll 生成站点,也同样支持纯 HTML 文档,将你的 Jekyll 站 点托管在 Github Pages 上是一个不错的选择。

不得不说Github非常良心,利用GitHub Pages平台,我们可以将自己的静态网站零成本托管到 GItHub,并且还可以使用自己的域名,甚至支持自动帮你申请SSL证书以开启HTTPS访问

The GitHub Blog里有这么一段话:

You can put anything here you like. Use it as a customizable home for your Git repos. Create a blog and spread your ideas. Whatever you want!

Hexo

Hexo是一个开源的静态博客生成器,用node.js开发,作者是台湾大学生tommy351。在 Hexo 的文档中,我们可以找到官方对 Hexo 的定义:

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。

好了,介绍完成后我们开始搭建吧

ps:文中博客是在win10环境下进行搭建的,并且对github pages和一些shell脚本知识有所了解。如果你有LInux设备推荐在Linux环境下搭建

第一步:创建Github Pages

创建Github Pages比较简单,只要你有一个Github账号再创建一个仓库就行了,但是这个仓库是有规则的,其格式必须为:yourusername.github.io。然后根据提示一直下一步即可,非常简单。如果你还没有Github账号,那快注册一个吧。

ps:一定要注意,仓库的格式必须是:你的用户名.github.io。还有就是创建仓库是要选择公共(Public)仓库

第二步:创建Git和Node.js环境

下载并安装Git

Windows:https://git-scm.com/download/win

LInux:sudo apt-get install git-coreorsudo yum install git-core

安装完成后,还需要最后一步设置,在命令行输入:

$ git config --global user.name "Your Name"
$ git config --global user.email "[email protected]"

因为Git是分布式版本控制系统,所以,每个机器都必须自报家门:你的名字和Email地址。你也许会担心,如果有人故意冒充别人怎么办?这个不必担心,首先我们相信大家都是善良无知的群众,其次,真的有冒充的也是有办法可查的。

注意git config命令的--global参数,用了这个参数,表示你这台机器上所有的Git仓库都会使用这个配置,当然也可以对某个仓库指定不同的用户名和Email地址。

安装 Node.js

Linux:

cURL: $ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

Wget:$ wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

安装完成后,重启终端并执行下列命令即可安装 Node.js。

$ nvm install stable

Windows:

下载安装程序

ps:安装时,请勾选Add to PATH选项

安装 Hexo

所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

第三步:搭建网站

打开终端,cd到你想要放网站的目录执行

$ hexo init yourname
$ cd yourname
$ npm install

其中yourname是你的文件夹名字,可随意取,这里我以spirit1431007为例(这是我在GitHub上的用户名)

进入到你的站点,然后以文本编辑器打开_config.yml文件,并滚动到最下面添加如下配置信息(注意最下边有deploytype字段,删除这两个字段然后复制下面的四个字段):

  deploy:
  type: git
  repo: https://github.com/spirit1431007/spirit1431007.github.io.git
  branch: master

把其中repo字段的值替换成你的github pages提交代码的git地址。branch字段一般默认是master,你也可以自己设置。

到此建站基本完成,进入终端,定位到你的站点文件夹使用hexo s命令,如果成功会打印Hexo is running at http://localhost:4000/. Press Ctrl+C to stop这样的一句话,打开你的浏览器输入localhost:4000地址,可以看见你的站点可以运行啦!

第四步:发布站点

当然,这只是本地跑起来了,而你的Github Pages服务器上并没有,所以你就需要在你的站点里使用终端命令进行发布:

$ hexo clean
$ hexo g
$ hexo d

命令说明:第一条是清楚缓存,第二条命令是生成本地发布文件夹,第三条命令才是最后的发布到github pages上(输入hexo d后会让你登录Github,输入账户名密码登录即可,如果你嫌麻烦,可以采用ssh的方式登录,具体Google)。更多的hexo命令操作请参考官方文档即可:Hexo官方命令参考文档

这时,在浏览器打开https://spirit1431007.github.io显示正常,大功告成!!

后记

当完成上面的操作,打开自己搭建的博客的时候,我想你和我一样,心里很激动,但是又很失望:网站怎么那么丑!!!这时你可能需要更换主题,主题选择可以参考:有哪些好看的 Hexo 主题?这里我使用的是:https://github.com...,下载主题文件后解压到theme目录,在项目的_config.yml中,将theme的值改成themes/下对应文件夹的名称。

还有就是使用Hexo搭建的网站在编辑文章时可能不是那么符合你的习惯,那么你可能需要这个:hexo-admin或者是Markdown