Hey，2016的夏天

hi，开始新的博客

–用GitHub搭建博客

前言

最近想写总结一下工作，将博客园的主页翻了出来，想弄个新的界面。但是博客园的元素都固定了，样式修改起来太麻烦。去请教前端的同学一个css的写法，被鄙视了『现在都用github』写博客，你太out啦。 OUT，这个不行啊，赶紧的吧，又折腾了一个星期，终于是有了点眉目。

GitHub

Github的Pages可以生成一些静态页面，推销自己和项目。

首先，要注册一个Github的帐号，如 githubblog 接下来按照示例：

• 新建一个repository，名字必须是刚注册的帐号.github.io，也就是 githubblog.github.io
• 在本地clone新建的库
• 在本地库新建index.html文件，随便写点内容
• commit & sync 到github

OK，博客开版啦，访问http://githubblog.github.io,就可以看到刚才index.html的内容。

Jekyll

-哈，没有样式，没有内容，怎么写啊？ -Jekyll来了

Jekyll可以将Github库中的文件，编译成静态的页面。也就是将githubblog.github.io中的文件，编译后放到_site文件夹中， 访问http://githubblog.github.io，实际访问的是编译好的_site的内容。

当然，搭建一个站点，肯定不想从『0』开始啦。OK，先去JekyllThemes找个自己觉得好看的主题，把代码clone代码到本地。 然后拷贝到你自己的库，sync一下，好看的模板就成你的了。

那想要自己改改样式，改改布局，你只要在相应的文件里修改，提交到github就能生效。

如果想在本地先预览一下修改的结果，就需要在本地装一个jekyll，简单的过程如下，每一步都可以baidu到：

• 安装 Ruby
• 安装 Gem （安装ruby包的工具）
• 修改 Gem 源为国内的源，taobao的gem源已经停了，现在可以用这个代替 https://gems.ruby-china.org/
• 使用gem 安装 jekyll : gem install jekyll
• 如果最新的mac os，gem install会出现目录不能写的错误，是mac os的系统保护搞的鬼，直接到恢复模式下关掉 Rootless 内核保护。

安装好jekyll，通过命令行或终端，cd 到你库的目录，运行命令

   jekyll serve --watch

jekyll会编译你的文件，并启动一个本地web服务，在浏览器里输入地址 localhost:4000，便可以预览你的博客啦。

–watch 会监视你文件的修改，实时编译。可能windows没有这个功能，mac下是可以的。

如果提示jekyll命令不对，那要配置一下path，把jekyll的路径加到path里。

MARKDOWN

架子打好了，关键还在后头，如何填充内容。

内容要放在库的 _ posts 文件夹里，按照规则 年-月-日-标题.md 命名，每一篇文章，一个文件。

接着就可以用Markdown来写博客了。当然，如果不想用markdown，直接写html，也是完全没有问题的。

Markdown还没有搞清楚怎么用，以后一边写一边学吧。

高级

接下来，要使博客更酷一点，还要继续完善:

• 买个域名，解析到github.io
• 配置个评论插件，方便和别人交互
• ……

慢慢来吧，希望能有点干货可以分享！

问题

几天用下来的问题，都记在这里：

• window 下运行 jekyll serve 提示 找不到 rouge.rb
  • 这是因为博文中使用了代码高亮，配置中使用 rouge ，windows下没有安装。使用gem install rouge 就可以了。
• window 下写的文章，链接 404
  • 博文的文件名用了中文。改成英文的就oK啦。