Jekyll
概述
Jekyll（지킬）是一款使用Markdown、Liquid模板语言和HTML/CSS生成静态网站的开源静态网站生成器（Static Site Generator）。它由Tom Preston-Werner于2008年开发，因与GitHub Pages的紧密集成，被广泛用于博客、作品集、文档网站等场景。
主要内容
1. Jekyll的核心概念
- 静态网站生成：Jekyll生成纯HTML、CSS、JavaScript文件，无需服务器端动态处理。这带来了加载速度快、安全性高、托管成本低的优势。
- Markdown支持：内容以Markdown编写，Jekyll自动将其转换为HTML。对开发者和写作者都友好的语法提高了生产力。
- Liquid模板：使用Liquid模板语言，可在模板中插入变量、循环、条件语句等。从而在静态网站中实现动态元素（如最新文章列表、按分类归档）。
- Front Matter（前置元数据）：在每个页面或文章顶部以YAML格式定义元数据（标题、日期、布局、标签等）。Jekyll解析这些数据来构建网站结构。
2. 安装与基本用法
- 安装：需要Ruby环境，通过
gem install jekyll bundler命令安装。 - 创建新项目：使用
jekyll new my-site命令生成基本结构。 - 目录结构：
- _posts/：存放博客文章的文件夹。文件名必须遵循YYYY-MM-DD-title.md格式。
- _layouts/：存放页面布局模板（默认、文章、页面等）。
- _includes/：存放可复用的HTML片段（导航栏、页脚等）。
- _data/：以YAML、JSON、CSV文件管理网站数据。
- assets/：存放CSS、JavaScript、图片等静态文件。
- _config.yml：网站全局配置文件（标题、URL、插件等）。
- 运行本地服务器：使用
bundle exec jekyll serve命令，可在http://localhost:4000预览网站。
3. 主要功能
- 博客引擎：为文章指定日期、分类、标签，自动生成归档页面。使用
paginate插件可实现分页。 - 自定义布局：通过HTML和Liquid设计布局，完全控制网站设计。可创建多层继承结构的布局。
- 数据文件：在
_data文件夹中存储结构化数据，并在模板中调用使用。例如，可动态渲染团队成员列表或价格表。 - 集合（Collections）：除文章外，可定义文档、项目等自定义内容类型。每个集合拥有独立的输出路径和元数据。
- 插件系统：Jekyll支持多种插件。典型的有自动生成SEO标签（
jekyll-seo-tag）、生成站点地图（jekyll-sitemap）、图片优化等。GitHub Pages仅允许安全插件。 - GitHub Pages集成：Jekyll是GitHub Pages的默认引擎。只需推送到仓库，即可自动构建并部署到
https://username.github.io。支持自定义域名、HTTPS、404页面等。
4. 优点与缺点
- 优点：
- 速度：静态文件可通过CDN快速传输。
- 安全：无数据库或服务器端代码，黑客攻击风险低。
- 成本：可利用GitHub Pages、Netlify等免费托管服务。
- 版本控制：所有内容均为文本文件，易于通过Git管理。
- 缺点：
- 缺乏动态功能：评论、搜索、用户认证等需依赖外部服务（Disqus、Algolia）。
- 构建时间：网站规模增大时，构建时间可能变长。
- 学习曲线：需掌握Ruby、Liquid、YAML等多种技术。
5. 替代方案与对比
- Hugo：基于Go语言，构建速度极快，适合大型网站。配置简单，但模板语法不同。
- Gatsby：基于React，提供动态功能和丰富的插件生态。虽是静态网站，但支持客户端渲染。
- Next.js：基于React的框架，同时支持静态生成（SSG）和服务端渲染（SSR）。适合更复杂的Web应用。
- 11ty（Eleventy）：基于JavaScript，简单灵活，支持多种模板语言。比Jekyll配置更少。
最新动态
截至2024-2025年，Jekyll在静态网站生成器市场的份额有所下降，但由于与GitHub Pages的集成，仍被许多个人博客和项目文档网站使用。近期趋势如下：
- 云端构建：通过GitHub Actions、Netlify、Vercel等CI/CD流水线自动构建和部署Jekyll网站的案例增多。
- 无头CMS集成：与Contentful、Forestry、CloudCannon等无头CMS集成，使非开发人员也能轻松编辑内容。
- 性能优化：图片优化插件（
jekyll-cloudinary）、CSS/JS压缩、懒加载等性能改进插件正在积极开发。 - 社区变化：Jekyll官方论坛和Stack Overflow的活动减少，但GitHub仓库仍保持活跃维护。2024年稳定发布了4.3.x版本，推荐使用Ruby 3.0以上。
- 迁移案例：部分用户为更快的构建和现代功能转向Hugo或11ty，但Jekyll的简洁性和GitHub Pages兼容性仍是其强大优势。
相关主题
- [[静态网站生成器]]
- [[GitHub Pages]]
- [[Markdown]]
- [[Liquid模板语言]]
- [[Ruby]]
---
AI自动生成文档 · 社区共同改进