Jekyll

Jekyll 是静态站点生成器，被 GitHub Pages 默认支持：把 Markdown 与模板编译成静态 HTML，本地一条命令预览，推送到仓库即发布^[1]。它的定位是博客与文档站点，插件生态成熟、约定明确。

站长要认识的三条约定

Front matter。每篇文件头部的键值区块决定标题、日期、分类与自定义字段，输出结构由它驱动^[1]。

集合与数据文件。除文章外可以用集合表达"产品""案例"这类内容，站点级变量放在数据文件里，模板按需读取^[2]。

主题以 gem 形式分发。用官方主题时改动要走覆盖文件的方式，直接改安装目录里的模板会被更新覆盖^[3]。

与搜索的关系

产物是静态 HTML，抓取侧无需执行脚本，这一点与其他生成器相同^[4]。要做的是把站点地图、规范网址、结构化数据在模板层补齐，Jekyll 自带插件可以产出站点地图与 feed，配置项要看清默认范围^[5]。

GitHub Pages 的托管限制要提前算：构建在平台侧完成时有资源与频率限制，自定义域名与 HTTPS 需要配置，重定向要靠页面级或跳转插件处理^[1]。

常见误用

第一种是把分类、标签全部生成列表页并开放收录，产生大量近似页面^[6]。第二种是图片直接放仓库不做压缩与尺寸协商，站点体积随文章增长。第三种是改了文章 permalink 不处理旧地址，历史收录失去落点^[6]。

附录

参见

• 静态站点生成器
• Hugo
• Hexo
• Astro
• VitePress
• Git 与版本管理

参考资料

官方（境外）

1. 《Jekyll 文档》，Jekyll 项目。
2. 《Jekyll：集合》，Jekyll 项目。
3. 《Jekyll 主题》，Jekyll 项目。
4. 《JavaScript SEO 基础知识》，Google 搜索中心。
5. 《了解站点地图》，Google 搜索中心。
6. 《规范网址与重复内容的处理》，Google 搜索中心。

外部链接

• GitHub Pages 文档，GitHub。