利用jekyll+github制作自己的Blog

前言：

---

完全依靠第三方博客平台不是长久之计，比如某书的静态资源服务器经常报500，图片显示不出来，还封了我不少文章。这还看个锤子，想想还是得搞个靠谱得Blog

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

搭建本地环境：

---

• 安装Ruby：

到官网进行下载：https://rubyinstaller.org/downloads/，选择包含的DEVKIT的安装包名：

或者brew install ruby

更改默认的source源：

• 查看当前已经添加的源：gem sources -l
• 删除官网源：gem sources -r https://rubygems.org/
• 添加了[ruby china]的可用源：gem sources -a http://gems.ruby-china.org

• 安装RubyGems：https://rubygems.org/pages/download

• 安装msys2：https://www.msys2.org/

• 安装Jekyll和bundler：gem install jekyll bundler

• 检测安装是否成功：ruby -v、gem -v、jekyll -v

• 新建jekyll项目：jekyll new myblog

• 登录网站：cd myblog、jekyll serve

搭建本地博客：

---

• 获取主题模板

Jekyll官网主题：http://jekyllthemes.org
我选择的主题：http://jekyllthemes.org/themes/jekyll-theme-chirpy/
官方部署手册：https://chirpy.cotes.page/posts/getting-started/

• 部署过程：

1. 将源码clone至本地，并安装依赖：

git clone https://github.com/cotes2020/chirpy-starter
cd chirpy-starter
bundle

2. 运行本地服务器，预览站点内容：bundle exec jekyll s
3. _config.yml根据需要更新变量。其中一些是典型的选项：

• url
• avatar
• timezone
• lang

按照注释提示修改url：'https://username.github.io'

4. 创建一个新存储库并将其命名为<USERNAME>.github.io，其中USERNAME代表你的GitHub 用户名。
5. 建立本地与GitHub仓库的关联

git init
git add .
git commit -m "first commit"
git branch -m master main
git remote add origin https://github.com/username/username.github.io.git
git push -u origin main

文件结构大致如下：

推送到远程触发 GitHub Actions 工作流程，构建完成并成功后，将出现一个名为的新远程分支gh-pages来存储构建的站点文件。

6. 将构建的站点文件存储在新分支上，并将该分支用作 GitHub Pages 服务的源：

7. 访问https://username.github.io：

参考如下：

---

博客 | Jekyll搭建个人博客-拓展版
Jekyll博客搭建指南
使用Jekyll搭建免费的个人博客详细教程
如何利用jekyll+github或jekyll+coding制作一个属于自己的博客.
jekll + chirpy 打造个人博客