本文是快速上手版，完整图文教程（含所有踩坑解决方案）请访问：https://www.jay-r-j.top/textlog-github-pages-tutorial/
一句话概括
使用 Jekyll 主题 heiswayi/textlog，通过 GitHub Pages 免费搭建个人博客，所有文章用 Markdown 书写，极简无干扰。
核心步骤（5步搞定）
-
Fork 主题仓库 → 重命名为
用户名.github.io（或自定义仓库名） -
修改
_config.yml→ 设置title、baseurl（规则见完整版） -
安装 Ruby 2.7.8 + DevKit （不要用 3.x ），执行
bundle _1.17.3_ install -
本地预览 ：
bundle _1.17.3_ exec jekyll serve -
推送到 GitHub → 启用 Pages（分支选
main）
重要提醒（避坑）
-
Ruby 安装路径不能有空格 （如
C:\Ruby27） -
baseurl必须和仓库名一致（仓库名textlog→baseurl: "/textlog"） -
若仓库名为
用户名.github.io，baseurl设为空字符串
写第一篇文章
在 _posts/ 下新建 YYYY-MM-DD-标题.md，开头加上：
bash
layout: post
title: "文章标题"
date: 2026-08-08完整教程（含截图、常见问题全解）
由于篇幅限制，所有踩坑细节（Ruby版本冲突、http_parser编译失败、样式丢失等）我都整理在了个人博客，强烈建议阅读：
Happy Blogging！
------ Jay（2026-08-09）