使用 jekyll + github pages 搭建个人博客

1. 新建 `github.io` 项目

其实 github pages 有两个用途，大家可以在官方网页看到。其中一个是作为个人/组织的主页（每个账号只能有一个），另一个是作为 github 项目的项目主页（每个项目可以有一个）。

而 github pages 本身就支持 jekyll ，所以二者的结合使用非常方便。

这两种静态页面怎么生成在 https://pages.github.com/ 这里都有详细步骤。

所以现在既然我们要建的是个人博客，就是第一种用途了。

在 github 上新建一个 repo，命名为 username.github.io，其中 username 就是你的 github 用户名。
把该项目 clone 到本地。
进入项目目录，在根目录下创建 index.html ，这个会自动作为博客的主页。
把所有的修改通过 git push 到刚刚创建的 repo。
好了，现在我们可以通过 https://username.github.io 来浏览我们的个人网站了。

2. 安装、使用 `jekyll`

网站跑起来了，但是里面没内容。当然我们可以自己写各个页面去丰富她。但是这样比较麻烦，弄个人博客我们主要关注的当然是写博文，而不想每次写一篇文章都要自己去排版一个页面。jekyll 就是可以帮助我们实现只要关注写文章本身，她会帮我们自动转化成静态页面。

可以看一下官网的描述

Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过一个转换器（如 Markdown）和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Pages 上，也就是说，你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站，而且是完全免费的。

支持 markdown ，非常方便。

下面我们开始安装 jekyll 并且新建一个项目看一下。

# 安装jekyll

gem install jekyll

# 新建项目

jekyll new myblog # myblog 是项目名

# 进入项目目录

cd myblog

创建成功后的项目目录是这样的

因为现在最新版(3.8.3)的 jekyll new 命令创建的项目默认已经用了主题了（可以在 _config.yml 配置文件下看到 theme: minima 这一行），因此我们要安装相应的依赖。

# 安装依赖包

gem install jekyll bundler

bundle install # 这个命令会自动安装项目所需的依赖

# 启动一个本地服务器，而且启动后还会自动监听文件，如果本地修改了某个文件，会重新生成静态页面，我们只需要在浏览器刷新一下就好

jekyll serve

启动后应该能看到以下的输出

这时候我们就能在本地通过 http://127.0.0.1:4000/ 来预览效果了。

PS：有一些预设的设置可以在 _config.yml 配置文件里面修改。

3. 怎么写一篇文章

大家可以先看看 jekyll 项目的目录结构

所以新增文章应该在 _posts 目录下操作，而且注意命名要按照 年-月-日-标题.后缀名 的格式。

现在我们来新建文章。

cd _post

touch 2018-08-14-my-first-article.md

2018-08-14-my-first-article.md 文件输入以下内容

---

layout: post # 使用post模版

title:  "我的第一篇文章"

date:   2018-08-14

categories: life

---

这是我的第一篇文章

再启动一下 jekyll serve 就能看到效果了。

4. 使用 `jekyll` 主题美化网站

内容知道怎么创建了，但是现在网站太简陋了。那怎么办？不用担心，jekyll 本身已经提供了挺多主题供我们选择使用。大家浏览 Jekyll Themes 这个网页慢慢选吧~~

至于每个主题怎么用最好还是看这个主题项目的说明，具体可能不太一样，我就不细说了。

记得最后修改完在本地预览没问题后要 git push 到 github 上哦~~

参考链接：

GitHub Pages

Jekyll文档

 快速在 Windows 上搭建 Jekyll 开发环境

本文首发于我的个人网站【https://dandelion-drq.github.io】，转载请注明出处。