【Jekyll博客】如何使用Jekyll在github上搭建个人博客（Winodows版本）

最后的成果

博客本身带了一篇，最后的结果就是这样，不需要服务器来支撑，直接上传到 github 上就可以看了

界面一般，还没换主题

需要安装的内容

1. 安装 ruby
2. 安装 jekyll
3. 安装 bundler

别问，问我也不知道都是干嘛的，就硬装就完事了

大概的原理就是，使用 ruby 安装了 jekyll 和 bundler，bundler 使用来管理 gem 依赖关系的，然后通过 jekyll 生成了博客模版，把博客模版传到 github 上面，就可以直接访问了

1. 安装ruby

下载地址

版本选择，2.6.6 x64 版本，之前下了 3.0.0 的版本直接报错了，所以选好版本还挺重要的。

下载完了就傻瓜式安装就可以了。

2. 安装 jekyll

打开命令提示符，执行以下下命令：

gem install jekyll

3. 安装 bundler

打开命令提示符，执行以下下命令：

gem install bundler

需要在本地上创建的内容

创建一个用来放自己博客的空文件夹
例如我在 D盘 跟目录下创建了一个 my-blog 文件夹
在命令提示符界面中，进入当前文件夹

通过 jekyll 创建一个个人的博客，后面的名称是自己定的，名称随意，这里的目的是创建一个博客，目的在于本地使用，

jekyll new banana-blog

创建好了的目录结构如下：

.
├── .jekyll-cache
├── _posts
|   ├── 2020-12-29-testblog.md
|   └── 2020-12-29-welcome-to-jekyll.markdown
├── _site
├── _config.yml
├── .gitignore
├── 404.html
├── about.markdown
├── Gemfile
├── Gemfile.lock
└── index.markdown

进入到博客文件夹之后，执行 jekyll serve，可以功过 http://localhost:4000 本地查看自己的博客

需要在 github 上配置的内容

在 github 上，先找到自己的名字（后面称 name ），大概是进到自己的 repository 里面，url 里面就会有显示，然后创建一个名为 name.github.io 的仓库

推送内容到 github

（推送不清楚，评论一下，我就再重新写一遍怎么推送 github）

把我的 banana-blog 文件夹中的所有内容，全部都推送到 github 中，然后通过 name.github.io 直接访问博客了

如何写博客

在 _posts 文件夹中，使用md格式的文件即可编写博客，但是有一些格式要注意

文件命名遵循以下的格式：日期-博客标题.类型

年：四位数字，2020年为2020
月：两位数字，1月为01
日：两位数字，1号为01
最后的 .md 为 markdown 格式

2020-12-29-博客标题.md

博客中的内容要遵循以下格式，这是固定格式：

---
layout: post
title:  "第一篇博客"
date:   2020-12-29 18:35:20 +0800
tags:
      - example
---

Hello World !!!

写好了一篇博客，直接推送到github就可以了

bug记录

解决ruby安装后无法添加淘宝gem源
https://www.jianshu.com/p/243bc5643921