github pages不能自动更新

昨天往github pages的repository里提交了一篇文章后，却发现github pages的页面一直没有更新——看不到新提交的文章。网上搜了一些资料，最后解决了这个问题。

一般来说，只要你的github pages repository有新的提交，github的服务器就会运行jekyll编译你的repository（延时很小）。如果编译出错，那么你的github pages页面是不会更新的；同时，github也会给你发一封提醒邮件，大致内容如下，

The page build failed with the following error:
page build failed

给出的错误信息很有限，仅仅通知你编译出错。

要找到出错的原因，首先确认下github pages服务有没有down掉；查看这个网址，https://status.github.com/，可以了解服务器的运行状态。如果服务器运行良好，那么极有可能是提交的内容有错误。 可以在本地用jekyll编译一下repository，看看是否有错误。首先，更新一下本地的jekyll。github可能使用了较新版本的jekyll，所以即使你使用以前的本地jekyll编译没有问题，远端的jekyll编译时也可能出错。（当然，最好是保证本地和远端的jekyll版本一样。但是，还没有发现查看远端jekyll版本的方法。）

$ sudo gem install jekyll
$ jekyll --version 然后，在本地编译你的repository。

$ jekyll build --safe jekyll给出的出错信息还是很详细的，能看出在什么位置发生了错误。比如，

| Maruku tells you:
+---------------------------------------------------------------------------
| Invalid char for url
| ---------------------------------------------------------------------------
| 结构如下所示，  N![ELF layout]("../images/blog/217px-elf-layout.png"
| --------------------------------------|-------------------------------------
|                                       +--- Byte 206
| Shown bytes [168 to 75] of 257:

“Maruku”应该是Markdown语法相关的错误。根据错误信息，修正相关的错误并重新提交，应该马上就可以在 github pages上看到新的提交了。（有时候即使本地有错误，也可以在本地server上看到新的改动；但是远端的服务器会要求更严格。）

所以，在提交改动前，最好保证在本地能编译无错。同时，也要时常更新本地的jekyll版本。

文章的时间

我在今天写了一篇博客，本地jekyll编译没有任何问题，但是Github Pages上却始终没有更新。 Google了一番，发现是个时区问题。Github Pages的server应该是跑在UTC时区下的，而 我所在的时区是北京时区，也就是UTC+8。在我今天发布的这篇博客里，所有的时间用的都是 UTC+8时区的本地时间。Github Pages估计只会编译server的当前时刻之前的文件。

把我的文章所用的时间都设置成前一天，再push一下，Github Pages就立马更新了。

参考链接：
https://help.github.com/articles/pages-don-t-build-unable-to-run-jekyll
http://youngsterxyf.github.io/2013/01/08/fix-github-pages-builds-failed/
http://python-china.org/topic/481