禅心诡道

GitHub博客搭建

2019/05/30

前段时间自己搞了这个GitHub博客，原先自己也有博客习惯，但是没有这个方便，但据我所知绝大部分技术同学到现在仍然没有自己的技术博客。原因有很多，有的是懒的写，有的是怕写不好，还有的是一直想憋个大招，幻想做到完美再发出来，结果一直胎死腹中。但其实更多程序员是不知道如何去搭建一个博客，其实如今搭建一个个人技术博客非常简单，其中最简单搭建方式莫属使用 GitHub Pages + Jekyll 了，我的博客就是使用这种技术。

GitHub Pages

Github Pages 是面向用户、组织和项目开放的公共静态页面搭建托管服务，站点可以被免费托管在 Github 上，你可以选择使用 Github Pages 默认提供的域名 github.io 或者自定义域名来发布站点。Github Pages 支持 自动利用 Jekyll 生成站点，也同样支持纯 HTML 文档，将你的 Jekyll 站点托管在 Github Pages 上是一个不错的选择。

使用 Github Pages 搭建博客有以下几个优点：

  • 完全免费，其中服务器、流量、域名什么的都管，完全零费用搭建一个技术博客
  • 写博客就是提交代码，让写作和编程的体验保持一致
  • 支持绑定自己的域名
  • 提供流行的网页主题模板

缺点也是有的：

  • 不支持动态内容，博客必须都是静态网页，一般会使用 Jekyll 来构建内容。
  • 博客不能被百度索引，因 Github 和百度有过节，所以 Github 就把百度给屏蔽了。
  • 仓库空间不大于1G
  • 每个月的流量不超过100G
  • 每小时更新不超过 10 次

Github Pages 使用 Jekyll 来构建内容，那么 Jekyll 是什么呢？

Jekyll 介绍

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

但如果我们只是在 GitHub 上面使用的话，到不需要知道 Jekyll 的语法，一般 Github 会自动将我们写的 Markdown 文件转换成静态页面。使用 Jekyll 需要使用 Markdown 语法来写你的文章，不过 Markdown 语法非常简单，做为程序员来讲基本上两三天就掌握了，大家也可以参考这篇文章：markdown 使用总结。

给大家分享一些 Jekyll 主题，这个网站下有很多 http://jekyllthemes.org/ 主题，大家可以根据自己的爱好去选择博客主题。

我的个人博客

使用 Github Pages + Jekyll 构建一个技术博客很简单，基本上步骤就是网上找一个自己喜欢的主题，直接 Fork 到自己的 Github ，然后在删掉原博客中的内容，在上传自己的文章即可，以我自己的博客为例。

1559179385164

使用这个主题的原因是，我比较喜欢简洁大气的风格，并且此博客主题对代码展示支持良好。

快速构建一个博客

以我的博客为例，介绍如何最快搭建一个博客。这也是我博客经历的第一个阶段。

1、首先打开地址https://github.com/chanxinguidao/chanxinguidao.github.com，点击 Fork 按钮将代码复制一份到自己的仓库。

1559179420794

过上一分钟，你的 github 仓库发现一个 chanxinguidao.github.com 项目。

2、设置 GitHub Pages

点击 Settings 按钮打开设置页面，页面往下拉到 GitHub Pages 相关设置，在 Source 下面的复选框中选择 master branch ，然后点击旁边的 Save 按钮保存设置。

1559179588056

3、重命名项目

点击 Settings 按钮打开设置页面，重命名项目名称为：github_username.github.io。

1559179675943

github_username 是你的 github 登录用户名

5、重命名之后，再次回到 Settings > GitHub Pages 页面

会发现存在这样一个地址： https://github_username.github.io

这个时候，你访问此地址已经可以看到博客的首页，但是点击文章的时链接跳转地址不对，这是因为少配置了一个文件。

6、配置 _config.yml

打开项目目录下的 _config.yml 文件，修改以下配置：

repository: github_username/github_username.github.io
github_url: https://github.com/github_username
url: https://github_username.github.io

这时候在访问地址： https://github_username.github.io，就会发现博客就已经构建完成了。剩下的事情就是去项目的 _posts 目录下删除掉我的文章，然后按照 Jekyll 的语法就写自己的文章就好了。

GitHub的博客原理，很简单，我们提交markdown语法的文件到对应的post下，他会自动编译成html。

写博客再也不需要数据库，以及自己搞格式，平时的markdown的文件直接通过git提交就是一篇博客，非常方便。

Post Directory