使用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

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

使用homebrew再安装一个ruby。

因为在Mac OSX下自带的ruby是系统的，使用镜像后

gem intall bundler

会发现没有权限，使用

sudo

也可以，但是不好，所以重新安装一个自己的ruby吧。

更多请参考 Mac OS X 下使用 Ruby Gem 的两个坑。

使用淘宝镜像

安装完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. 配置主题

第一步：

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

第二步：

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

第三步：

放进去后，使用命令行

bundle install

更新一些文件

第四步：

命令行输入

bundle exec jekyll serve

开启本地服务器，在浏览器中输入网址：

http://127.0.0.1:4000/

就可以在本地查看自己的博客了。此时可以进行一些配置，比如对

_config.xml

的文件修改等。

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

4. 推送到远端

添加

.gitignore

文件

默认的Jekyll项目没有添加.gitignore文件。必须要手动添加。

添加一下内容，其中 .DS_Store是Mac OSX的桌面文件：

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

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

过几分钟左右，在浏览器输入网址

yourUsername.github.io

就可以看到你自己的个人博客网站啦。在

_post

文件下可以创建

xxx.markdown

文件进行博客书写。

结语：

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

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

遇到问题的参考资料：

淘宝镜像

Mac OS X 下使用 Ruby Gem 的两个坑

教程：

官方文档

使用Jekyll在Github-Pages上搭建个人博客

通过Github Pages和Jekyll搭建个人博客