Generator jekyll 把纯文本转换为静态网站的生成器

写博客或文档站，最朴素的需求其实是：我只要写 Markdown，剩下的排版、目录、分页、标签你都帮我搞定，最后产出一个纯静态、能扔到任意服务器上的站点。Jekyll 就是干这个的鼻祖级工具——GitHub Pages 默认就靠它驱动。你写纯文本，它按约定生成完整静态站，没有数据库、没有运行时，简单到极致。

Jekyll 用 Ruby 写成，由 GitHub 背后的团队与社区长期维护。它把「约定优于配置」做到位：目录结构、Front Matter、布局模板都有默认规则，新手几乎零配置就能跑起来。虽然新框架层出不穷，但 Jekyll 凭借与 GitHub Pages 的无缝绑定和极简哲学，依然是个人博客与项目文档最省事的起点之一。

项目基本信息

一、项目介绍

Jekyll 是一个把纯文本转换为静态网站的生成器，被称为「博客感知」的静态站点引擎。它解析 Markdown 与 Liquid 模板，处理布局、分页、分类与标签，输出可直接托管的静态文件。作为 GitHub Pages 的默认引擎，它与仓库托管深度整合，写文档、做博客、搭小站点都极顺手。

二、核心优势

• 零运行时：纯静态输出，部署到任意托管。
• 与 GitHub Pages 无缝：推上去即上线。
• 约定清晰：目录与 Front Matter 规则简单直观。
• 可扩展：插件与 Liquid 标签丰富。
• 历史悠久：生态与教程极其完善。

三、适用场景

• 个人博客与技术笔记。
• 开源项目文档站（配 GitHub Pages）。
• 不需要后端的轻量站点。
• 追求极简部署的静态项目。

四、安装教程

需要 Ruby 环境，安装 gem：

gem install jekyll bundler
jekyll new my-site
cd my-site && bundle exec jekyll serve

浏览器打开 http://localhost:4000 预览。常见报错：Ruby 版本过低——按官方要求升级；bundle 冲突——用项目内 Gemfile 锁定；权限问题——用 rbenv/rvm 避免系统 rubygems 权限纠缠。

五、使用示例

在 _posts 下按 年-月-日-标题.md 命名写文章，头部加 Front Matter：

---
title: 我的第一篇
layout: post
---
正文用 Markdown 写即可。

保存后 Jekyll 自动生成列表、分页与永久链接，无需手动管理路由。

六、常见问题

• 必须 GitHub Pages 吗？不，本地也能构建部署到别处。
• 支持什么语言？核心是 Ruby 与 Liquid。
• 和 Hugo 比？Jekyll 更简更轻，Hugo 更快更现代。
• 插件受限吗？GitHub Pages 仅允许白名单插件，自建可全开。

七、总结

Jekyll 把「写文字、出网站」简化到了最少步骤。它不花哨，但足够可靠，尤其和 GitHub Pages 绑定的那一刻，几乎零成本拥有了属于自己的发布管线。