标签：
最近在玩github，突然发现很多说明网站或者一些介绍页面全部在一个域名是*****.github.io上。
好奇！！！真的好奇！！！怎么弄的？我也要一个~~~
于是去网站上查询了一下，找到了https://pages.github.com/官方网站。
只可以写html静态页面。在最下方找到了一个github推荐的Jekyll。
jekyll原网站是英文的，这里有个翻译的网站：http://jekyll.bootcss.com/。不过貌似有些日子没更新了，还是推荐看回官网。
于是，通过jekyll，开启了github的网站搭建之路。
1. 打开terminal，任意路径执行： gem install jekyll
抛出异常：
ERROR: While executing gem ... (Gem::FilePermissionError) You don‘t have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
解决方法：
sudo gem install jekyll
2. 在github上创建项目username.github.io
3. 拉取项目到本地
4. 在terminal中，任意路径执行： jekyll new username.github.io
5. 将生成的文件复制到刚刚拉取的github项目目录下。
6. 同步代码，上传~ 访问username.github.io，即可看到下图，博客搭建完成。
7. 本地运行，切换到项目目录下，执行：jekyll serve
8. 在浏览器中执行：http://127.0.0.1:4000/，即可看到和username.github.io相同的页面内容。
9. 想要停止服务，在terminal中关闭其进程即可。届时terminal中会显示 “ [1]+ Stopped jekyll serve ”
10. 再次启动时很可能会出现如下错误：
[2016-04-22 22:51:20] WARN TCPServer Error: Address already in use - bind(2) jekyll 3.1.3 | Error: Address already in use - bind(2)
产生原因：
关闭时使用了错误的命令，不是command+c，而是control+c。
解决方法：
a. 使用命令：ps aux | grep jekyll 查找到进程号
b. 使用命令：kill -9 28185 杀死进程（其中28185是进程号）
11. 打开 _config.yml 文件，即可修改文件展示的很多内容。如下图：
12. 再次浏览网页，这是就会发现网页内容被改变了。咦？中文呢？说好的颜色不一样的烟火呢？如下图：
解决方法：非常简单···换一个ide就可以了···这个是个编码问题···
之前使用vs code，好吧，编码有问题，换成了atom，问题解决···
话说，这样我可以给vs code提bug么?···
下面附上我的github page连接地址：http://lunagao.github.io/
标签：
原文地址：http://www.cnblogs.com/maomishen/p/5436938.html
