使用GitHub Pages+ Jekyll搭建个人博客

前言：

今天五一假期最后一天，趁着放假，搭建一个个人博客。之前就听说了GitHub Pages + Jekyll来搭建，今天想都不想其他的实现方式直接就使用这两个搭建。

关于这方面的文章很多，网上查一下一大堆，这篇文章就整理一下搭建的步骤和过程，以及遇到的问题。
之前觉得挺简单的，自己搞了一下，真是各种问题。真的是 纸上得来终觉浅，绝知此事要躬行。

博客地址： http://baiiu.github.io/

1. 安装Jekyll环境

1-1 安装ruby环境

mac下自带ruby 2.0.0，可用命令行查看：

  ruby --version

1-2 安装 bundler

虽然不知道这是个什么玩意，但是按照官方文档说的来吧。

 gem install bundler

直接这样在命令行中输入会出错，因为墙和权限问题，解决方法：

1. 使用homebrew再安装一个ruby。
   因为在Mac OSX下自带的ruby是系统的，使用镜像后 gem intall bundler会发现没有权限，使用 sudo 也可以，但是不好，所以重新安装一个自己的ruby吧。
   更多请参考 Mac OS X 下使用 Ruby Gem 的两个坑。

2. 使用淘宝镜像
   安装完ruby后发现ruby的version为 2.3.0了。然后再次gem install bundler 时就会有墙的问题。所以按照 淘宝镜像 修改mirror，以后使用就方便很多。

1-3 确认是否安装成功

命令行中输入：

jekyll -v

查看是否安装成功，当前版本为 3.0.5。

2. 创建GitHub仓库

参考 官方文档 上创建仓库，注意你的repo的name必须为 yourUsername.github.io

创建完后并克隆到本地，接下来配置主题。

3. 配置主题

1. 第一步：
   在 Jekyll Themes 中选一个自己看好的，下载到本地，将其内所有文件复制到 repo中(第二步克隆到本地的文件)。

2. 第二步：
   当前我使用的是 pithy 主题。在选主题时要注意不要太久远了。之前用了一个13年的，各种版本更新不适配。

3. 第三步：
   放进去后，使用命令行 bundle install 更新一些文件

4. 第四步：
   命令行输入 bundle exec jekyll serve 开启本地服务器，在浏览器中输入网址： http://127.0.0.1:4000/ 就可以在本地查看自己的博客了。此时可以进行一些配置，比如对 _config.xml 的文件修改等。

至此，就可以看到刚配置好的博客在本地显示的样子了。接下来就是推送到远端。

4. 推送到远端

1. 添加.gitignore 文件
   默认的Jekyll项目没有添加.gitignore文件。必须要手动添加。
   添加一下内容，其中 .DS_Store是Mac OSX的桌面文件：

   _site/
   .sass-cache/
   .jekyll-metadata
   .DS_Store 
   

2. 使用git操作推送到远端，即你的github仓库上。

3. 过几分钟左右，在浏览器输入网址 yourUsername.github.io 就可以看到你自己的个人博客网站啦。在_post 文件下可以创建 xxx.markdown 文件进行博客书写。

结语：

使用 Jekyll 来对博客进行操作，刚刚接触，对该项目、项目结构、文件组织等都不是很清晰，不是很会使用。目前仅仅搭建了一个能看的网页而已，还有很多东西要学呀。嘿嘿。

善用工具吧，骚年。去尝试，去面对，去努力。

遇到问题的参考资料：
淘宝镜像
Mac OS X 下使用 Ruby Gem 的两个坑

教程：
官方文档
使用Jekyll在Github-Pages上搭建个人博客
通过Github Pages和Jekyll搭建个人博客