极简博客搭建(精简版):textlog + GitHub Pages

本文是快速上手版,完整图文教程(含所有踩坑解决方案)请访问:https://www.jay-r-j.top/textlog-github-pages-tutorial/


一句话概括

使用 Jekyll 主题 heiswayi/textlog,通过 GitHub Pages 免费搭建个人博客,所有文章用 Markdown 书写,极简无干扰。


核心步骤(5步搞定)

  1. Fork 主题仓库 → 重命名为 用户名.github.io(或自定义仓库名)

  2. 修改 _config.yml → 设置 title、baseurl(规则见完整版)

  3. 安装 Ruby 2.7.8 + DevKit (不要用 3.x ),执行 bundle _1.17.3_ install

  4. 本地预览 :bundle _1.17.3_ exec jekyll serve

  5. 推送到 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)

相关推荐
岁月宁静8 小时前
五、《从零手撸 Agent》 — 什么是 Agent:从“会聊天”到“会做事”,差的就是一个循环
python·agent
梯度下降者8 小时前
Python - 函数
python·高阶函数·可调用对象·functools·嵌套作用域
wflynn10 小时前
GitHub 日榜趋势速报 | 2026-11-18
开源·github
starzy199010 小时前
深入理解Scala隐式参数:上下文流转
开发语言·python·scala
Hvitur11 小时前
Git - 多分支合并
git·github
wuyk55511 小时前
Spider-第16讲-线程池与竞态问题
大数据·爬虫·python·elasticsearch·搜索引擎
laoyeye83115 小时前
手写 vLLM 分页 KV Cache(三):引用计数、写时复制(CoW)与前缀缓存
人工智能·github
kyle~17 小时前
FastAPI --- 将业务能力以 API 的形式提供给外部系统
python·fastapi·前后端
aiotto资源分享17 小时前
Python 写 JSON 文件,程序中途退出会留下什么?
java·python·json·jsondecodeerror
一条Go18 小时前
边缘 Agent:为什么是它连出来,而不是平台连进去
后端·架构·github