How to Create a Github.io Site with Jekyll
1.安装Ruby
安装 Jekyll 我们需要使用gem install jekyll bundler,而gem是Ruby 的包管理工具，而 Jekyll 和 Bundler 都是 Ruby 环境中的工具。因此，首先需要确保你已经正确安装了 Ruby，并且将其添加到了系统的 PATH 环境变量中。
访问 Ruby 官方网站 下载安装包。
我们下载了 Ruby+Devkit 3.3.7-1 (x64)
在安装 Ruby 时，MSYS2 是必需的，它是 Ruby 在 Windows 上运行所需要的开发工具集和库。Devkit（开发工具包）是 MSYS2 的一部分，用于支持 Ruby 扩展和原生扩展的编译。所以，是的，你需要下载和安装 MSYS2 以及 Devkit。
地址: [https://www.aliyun.com/product/oss?spm=5176.21213303.J_v8LsmxMG6alneH-O7TCPa.8.1f002f3dZbM4cJ&scm=20140722.S_product@@%E4%BA%91%E4%BA%A7%E5%93%81@@102633..ID_product@@%E4%BA%91%E4%BA%A7%E5%93%81@@102633-RL%E5%AF%B9%E8%B1%A1%E5%AD%98%E5%82%A8-LOC_2024SPAllResult-OR_ser-PAR1213e36e417438357211394388e93a9-V_4-RE_new3-P0_0-P1_0](https://www.aliyun.com/product/oss?spm=5176.21213303.J_v8LsmxMG6alneH-O7TCPa.8.1f002f3dZbM4cJ&scm=20140722.S_product@@%E4%BA%91%E4%BA%A7%E5%93%81@@102633..ID_product@@%E4%BA%91%E4%BA%A7%E5%93%81@@102633-RL_%E5%AF%B9%E8%B1%A1%E5%AD%98%E5%82%A8-LOC_2024SPAllResult-OR_ser-PAR1_213e36e417438357211394388e93a9-V_4-RE_new3-P0_0-P1_0)
等待安装完程序会自动关闭,接下来 ruby -v可以看到版本号
1
ruby 3.3.7 (2025-01-15 revision be31f993d7) [x64-mingw-ucrt]
更改镜像源 gem sources --add https://gems.ruby-china.com/
1
2
https://gems.ruby-china.com/ added to sources
https://rubygems.org/ removed from sources
安装Jekyll gem install jekyll bundler,使用jekyll -v看是否安装成功
1
jekyll 4.4.1
3.初始化Jekyll项目
初始化
本地创建一个文件夹,运行jekyll new . --force初始化新项目
导入主题
随后在Gemfile文件中加下面的命令安装Minimal Mistakes 主题
1
gem "minimal-mistakes-jekyll"
添加完主题,下一步安装Ruby依赖.这会安装主题以及其他必要的依赖库。
1
bundle install --verbose
如果第一次没下载成功,再下一次就可能成功
启动服务
安装完成后，可以通过以下命令启动 Jekyll 的本地开发服务器：
1
bundle exec jekyll serve
这会启动一个本地的 Jekyll 网站，通常可以在http://127.0.0.1:4000/上访问。
4.配置博客
- 打开
_config.yml文件，进行你需要的设置，比如博客名称、描述、社交链接等。 - 根据之前的建议，在
_config.yml中配置科幻风格的主题样式、字体、背景等。
N.推荐阅读
官方源码
https://github.com/cotes2020/jekyll-theme-chirpy/
官方指南
https://chirpy.cotes.page/posts/getting-started/
免费主题
Mac的安装方式
https://blog.csdn.net/v20000727/article/details/140712498
推荐样式
https://huanyushi.github.io/posts/chirpy-blog-customization/
常用命令
定位主题位置
1
bundle info --path jekyll-theme-chirpy
启动服务
1
bundle exec jekyll serve
安装包依赖
1
bundle install --verbose