Jekyll 负责把 Markdown、模板和配置生成静态网站，GitHub Pages 负责托管生成后的页面。这套方案不需要单独购买服务器，适合个人博客和技术笔记。

1. 准备工作

  • 一个 GitHub 账号
  • Git 基本用法

2. 选择主题

因为使用的是开源的博客模板，所以需要先去主题官网挑选一个自己喜欢的主题。想要什么样子的博客可以在 Jekyll 官网主题随便选：http://jekyllthemes.org/

我选的主题：http://jekyllthemes.org/themes/jekyll-theme-yat/ GitHub 仓库地址：https://github.com/jeffreytse/jekyll-theme-yat/ 这个博客主题也非常不错 https://github.com/cotes2020/jekyll-theme-chirpy

选好主题后，访问主题的 GitHub 仓库，Fork 到自己的账号下。个人主页仓库通常命名为 <用户名>.github.io。

3. 设置 GitHub Pages

进入仓库的 Settings → Pages，选择需要发布的分支或 GitHub Actions 工作流。部署完成后，可以在 Actions 页面查看构建记录。

设置好了就可以访问了，但此时博客的内容都是模板自带的，还需要以下步骤来改成自己的内容。

4. 配置

接下来是简单的配置。 仓库根目录中的 _config.yml 是 Jekyll 的站点配置文件。通常需要修改 title、email、description、url 和 favicon。网站图标可以使用 Favicon Generator 生成。

提交修改后，GitHub Actions 会重新构建网站。可以在仓库的 Actions 页面查看部署过程和历史记录。

5. 写博客

接下来就是写自己的博客了。 文章放在 _posts/ 目录中，文件名必须使用 YYYY-MM-DD-title.md 格式。每篇文章开头还需要包含 Front Matter，例如：

---
layout: post
title: 我的第一篇文章
categories: 教程
tags: [Jekyll]
---

写完后提交到 GitHub，部署工作流会自动更新网站。

6. 更多的功能

  • 自定义域名
  • 访问量统计
  • 评论功能
  • 本地预览

这些功能应按实际需求逐步添加。对于个人博客，先保证文章结构、链接和本地预览稳定，再增加统计或交互功能。

7. 本地验证

bundle install
bundle exec jekyll serve

访问 http://localhost:4000。如果修改了 _config.yml，需要重启 Jekyll 服务。