jekyll Gemfile解读

2025-04-30

Gemfile 配置解析与优化建议

本文件记录了 Jekyll 项目的 Gemfile 各项依赖的作用、保留建议，以及可选的精简版本，方便日后查阅。

✅ 当前结构说明

source "https://rubygems.org"

# 核心组件
gem "jekyll", "~> 4.3.3"
gem "minima", "~> 2.5.1"
gem "kramdown", "~> 2.4.0"
gem "rouge", "~> 4.2.0"

# GitHub Pages官方插件
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.17"
  gem "jekyll-sitemap", "~> 1.4"
  gem "jekyll-relative-links", "~> 0.7"
  gem "jekyll-paginate", "~> 1.1"
end

# Sass处理
gem "sassc", "~> 2.4.0"
gem "jekyll-sass-converter", "~> 2.2.0"

# Windows平台依赖
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", "~> 1.2"
  gem "tzinfo-data"
  gem "wdm", "~> 0.1.1"
end

# 开发工具
group :development do
  gem "jekyll-watch", "~> 2.2"
end

📦 依赖项解释与建议

🔹 核心组件

Gem 作用 建议
jekyll 博客生成框架 ✅ 必须保留
minima 默认主题，若未使用可删 ❌ 可删除
kramdown Markdown 渲染器 ✅ 保留
rouge 代码高亮 ✅ 保留

🔹 GitHub Pages 插件

插件名 作用 建议
jekyll-feed RSS 支持 ✅ 保留
jekyll-sitemap sitemap.xml 支持 ✅ 保留
jekyll-relative-links 支持文档相对路径 ✅ 保留
jekyll-paginate 支持分页（目前未用） ⚠️ 可选保留

🔹 Sass 相关

Gem 作用 建议
sassc 使用 C 编译 Sass ✅ 保留
jekyll-sass-converter Jekyll 集成 Sass ✅ 保留

🔹 Windows 平台依赖

Gem 作用 建议
tzinfo 时区信息 ✅ 可保留
tzinfo-data 数据支持 ✅ 可保留
wdm 文件监控 ✅ 可保留

🔹 开发工具

Gem 作用 建议
jekyll-watch 自动刷新/监听文件变化 ✅ 保留

✅ 推荐精简版本

适用于你不使用 minima 主题，也暂时不需要分页功能：

source "https://rubygems.org"

gem "jekyll", "~> 4.3.3"
gem "kramdown", "~> 2.4.0"
gem "rouge", "~> 4.2.0"

group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.17"
  gem "jekyll-sitemap", "~> 1.4"
  gem "jekyll-relative-links", "~> 0.7"
end

gem "sassc", "~> 2.4.0"
gem "jekyll-sass-converter", "~> 2.2.0"

platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", "~> 1.2"
  gem "tzinfo-data"
  gem "wdm", "~> 0.1.1"
end

group :development do
  gem "jekyll-watch", "~> 2.2"
end

✅ 如需进一步定制或精简，请确保兼容 GitHub Pages 支持的插件（官方白名单）。