jekyll和github pages搭建个人博客
一. 搭建环境
1.1 下载软件
- jekyll：这个是将纯文本转化为静态网站和博客，使用gem安装下载：
gem install bundler jekyll。 - github pages：免费开源，并且可以自动生成域名，自己去构建一个属于自己的github账号和新建一个仓库（名字为：
XX.github.io，这里XX就是你自己的账号名称）
- mac或者linux或者Windows平台。
1.2 选择一个适合自己的博客主题
jekyll主题：http://jekyllthemes.org/
jekyll插件：http://www.jekyll-plugins.com/
- 本人选择的jekyll主题：Flexible-Jekyll，如下图所示：
- 选择一个地方存放下载的主题（直接git下载）：
git clone https://github.com/artemsheludko/flexible-jekyll - 这里直接在本地利用jekyll生成一个网页进行测试和调试：
bundle exec jekyll server或者是bundle exec jekyll s，这里会生成一个本地的博客地址：http://127.0.0.1:4000/，可以直接查看
1.3 将主题放入自己的仓库中
- git下载创建好的xx.github.io该仓库到自己本地：
git clone https://github.com/xx/xx.github.io.git - 将之前下载的主题放到自己创建的github.io这个仓库中
- git上传修改的地方：
- git添加修改的地方：
git add . - git提交：
git commit -m "修改" - git推送：
git push
- git添加修改的地方：
- 这里可以直接在网页上打开
https://xx.github.io/查看自己的博客，当然这里还是别人的内容，还需要自己修改成属于自己专属的博客。 - 这里注意：如果无法访问github pages，这里需要修改dns服务器就可以了，修改为114.114.114.114，具体如下所示：
二. 创建一个专属于自己的个人博客
2.1 了解下载主题的文件和文件夹的作用和内容
整个下载jekyll主题的代码结构如下图所示：
- _drafts文件夹：主要是存放一些自己还没有写好的markdown文档，这里是不会在网页上展示的，但是没有写完的却可以通过git来保存
- _posts文件夹：保存已经写好的markdown文章
- assets文件夹：保存一些图片和css的一些文件
- _config.yml：用来修改主页上的一些个人信息
- Gemfile：这里是该主题下需要的一些gem依赖，这里直接在当前目录下
bundle install即可下载安装依赖，注意这里如果gem下载很慢，可以设定source源，直接在Gemfile文件开头写source 'https://gems.ruby-china.com/'
2.2 如何在博客中展示公式
如果自己的博客中需要展示数学公式的，那么需要在_layouts/default.html文件中进行添加：
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML" type="text/javascript"></script>
2.3 打开自己博客网页响应很慢
这里一般是自己博客中展示的图片资源过大导致的，这里需要将图片进行无损压缩，重新上传即可。这里推荐几个图片无损压缩的网站。
TinyPNG：https://tinypng.com/
Compressor：https://compressor.io/
三. Windows下安装jekyll
这里由于jekyll一般在mac和linux上安装较为方便，官方也有指导，但是windows下官方写的不详细，因此这里主要介绍下Windows下如何安装jekyll。
3.1 软件安装
- Ruby+Devkit 2.7.2(x64)：安装的时候注意添加到Path中，其需要安装
MSYS2 and MINGW development toolchain - RubyGems：这里直接选择zip进行安装即可。
3.2 Jekyll及gem依赖的安装
- cd到解压后的RubyGems的文件中：
ruby setup.rb - 安装jekyll：
gem install jekyll - 安装jekyll-paginate：
gem install jekyll-paginate - 安装bundler（注意这里在后面安装gem依赖需要）：
gem install bundler - 验证下jekyll和bundler：
jekyll -v和bundler -v
3.3 在本地运行静态博客
- cd到自己博客中，安装gem依赖：
bundle install - 本地运行服务：
bundle exec jekyll s
