引言
文档 https://docs.github.com/zh/pages
GitHub Pages官方网站推荐模板 https://pages.github.com/themes/
注意Github Pages的关键字
一次提交后博客没有更新成功，收到的邮件中提示报了错，点开邮件中的超链接，查看 build 中的提示文字是：
github-pages 228 | Error: Liquid syntax error (line 925): Variable '\{\{1, 2}' was not properly terminated with regexp: /\}\}/
其中上面把具体文件也点出来了，这里就是因为使用了双大括号{导致的。
双大括号具有特殊含义，其中图片地址就用到了，这里把大括号删除后，再次提交就没有问题了。
Github Pages中Jekyll升级导致项目构建失败
一次更新了blog，发现Github Pages没有更新，接着收到Github Pages的构建失败的通知邮件：
The page build failed for the `master` branch with the following error:
Page build failed. For more information, see https://help.github.com/en/articles/troubleshooting-jekyll-build-errors-for-github-pages-sites#troubleshooting-build-errors.
For information on troubleshooting Jekyll see:
https://help.github.com/articles/troubleshooting-jekyll-builds
If you have any questions you can contact us by replying to this email.
过去几年一直用的好好的，今天突然出现这个情况，不会是NBA为港独站队，Github不让大陆这面使用了吧。然后各种搜索，发现有好多人过去也碰到过这个情况， 所以应该是其他原因。查来查去，解决方法是只能本地安装Jekyll，然后构建寻找失败原因。邮件中给的网址一直看不到想要的解决办法， 好多人说是Github Pages升级了jekyll，新版本导致的问题。所以只能本地想办法复现问题了。看文档，jekyll安装需要先安装Ruby,而且不同的版本对Ruby的版本有要求。
自己先在自己的deepin系统用apt-get方式安装了Ruby,版本是：
ruby 2.3.3p222 (2016-11-21) [x86_64-linux-gnu]
然后被要求又安装了ruby-dev，发现还是不能安装Jekyll，Jekyll4.0最新版本要求Ruby的最低版本是2.4，怎么升级Ruby呢？又成了一个问题。 折腾来折腾去，只能用rvm方式安装2.4版的Ruby了，又开始安装rvm。
先把上面apt安装的Ruby卸载：
sudo apt remove ruby
sudo apt remove ruby-dev
sudo apt autoremove
准备安装rvm，切换到国内源：
sudo apt-get install gem
sudo apt-get install bundler
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
再看一下gem的版本：
gem -v
版本是3.0.6。
安装rvm：
curl -L get.rvm.io | bash -s stable
可能报错，按照报错提示：
gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
然后再安装rvm：
curl -L get.rvm.io | bash -s stable
看到 Thanks for installing RVM 🙏 ，说明安装成功。
echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm"' >>~/.bashrc
source ~/.bashrc
现在就可以用rvm -v查看版本了：
rvm -v
输出：
rvm 1.29.9 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
下面安装Ruby，列出已知的ruby版本：
rvm list known
看到最新版是2.6，那我们就安装2.6：
rvm install 2.6
完成后查看Ruby版本：
ruby -v
结果是ruby-2.6.3。
然后安装我们的主角Jekyll：
gem install jekyll
完成后，我们看一下Jekyll的版本：
jekyll -v
输出 jekyll 4.0.0。
定位问题
现在我们可以定位问题了，cd切换到项目目录下，也就是_config.yml所在的目录下，构建：
jekyll build
输出问题文件：
Configuration file: /home/baiyang/www/blog/_config.yml
Source: /home/baiyang/www/blog
Destination: /home/baiyang/www/blog/_site
Incremental build: disabled. Enable with --incremental
Generating...
Conversion error: Jekyll::Converters::Markdown encountered an error while converting '_posts/HTML/2018-05-25-WebSocket 技术探究.md':
Rouge::Guesser::Ambiguous
------------------------------------------------
Jekyll 4.0.0 Please append `--trace` to the `build` command
for any additional information or backtrace.
------------------------------------------------
这里已经点明了问题所在的文件，Rouge::Guesser::Ambiguous 这句话还是有些模糊，还需要在这个文件中一步一步缩小范围定位问题，多次jekyll build查看问题在哪一行。
最后定下来居然是这个地方的问题，html文件头标记：
!DOCTYPE html
把这一行删了就好了，jekyll build看一下：
Configuration file: /home/bai/www/blog/_config.yml
Source: /home/bai/www/blog
Destination: /home/bai/www/blog/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 2.427 seconds.
然后提交到github上，发现构建成功了，问题解决。
模板
chirpy
github地址 https://github.com/cotes2020
在线体验 https://chirpy.cotes.page/
Gitee码云搭建博客
码云Gitee Pages也搭建博客，参考 https://cloud.tencent.com/developer/article/2116255
参考资料
［solved］Page build failed(Jekyll) https://blog.csdn.net/wuzhimang/article/details/77132014
deepin15.11使用RVM安装ruby https://www.cnblogs.com/Zlcode/p/11490724.html
Jekyll基本用法 http://jekyllcn.com/docs/usage/
Jekyll 官网 http://jekyllcn.com/
GitHub Pages 官网 https://pages.github.com/
GitHub Pages 文档 https://docs.github.com/cn/pages
码云Gitee Pages搭建博客 https://cloud.tencent.com/developer/article/2116255