本 demo 基本信息001
本 demo 基本信息001
🧱 1. 项目结构简介（Chirpy Jekyll Theme）
你的仓库属于 GitHub Pages + Jekyll + Chirpy 主题。核心结构如下：
1
2
3
4
5
6
7
.
├── _config.yml # 站点总配置
├── _posts/ # 博客文章 (Markdown)
├── _tabs/ # 顶部标签栏 (About, Categories, Tags ...)
├── assets/ # 图片、CSS、JS
├── index.html # 首页入口
└── ... # 其他 Chirpy 主题文件
你主要用到的目录是：
| 目录 / 文件 | 作用 |
|---|---|
_posts/ |
所有博客文章（以日期命名的 md 文件） |
_tabs/ |
顶部导航栏 Tab 页面（比如 About、Categories） |
_config.yml |
网站名称、描述、作者等设置 |
assets/img/ |
图片素材放这里 |
✏️ 2. 如何添加新的 Markdown 文章
Chirpy 主题的文章放在 _posts/ 内，必须使用固定文件名格式：
1
YYYY-MM-DD-标题.md
例如：
1
_posts/2025-12-01-windows-dev-env.md
文章模板
内容中必须包含 YAML 头部（Front Matter）：
1
2
3
4
5
6
7
8
---
title: Windows 10 开发环境配置教程
date: 2025-12-01 12:00:00 +0800
categories: [Windows, Tutorial]
tags: [windows, tutorial, dev]
---
这里写正文内容...
写完推送到 GitHub 后，GitHub Pages 自动构建，会出现在：
1
https://<你的用户名>.github.io/posts/<文章标题>/
🏷️ 3. 如何修改静态网页标签（顶栏 Tabs）
顶栏 Tab 页面存放在：
1
_tabs/
默认会有：
1
2
3
4
about.md
categories.md
tags.md
archives.md
你可以：
✔️ 修改已有 Tab 内容
例如修改 About 页面：
1
2
3
4
5
6
7
8
9
# _tabs/about.md
---
title: About
icon: fas fa-info-circle
order: 1
---
这里写你的简介...
✔️ 新增一个自定义 Tab
例如新增 Tutorials：
创建文件：
1
_tabs/tutorials.md
内容写：
1
2
3
4
5
6
7
---
title: Tutorials
icon: fas fa-book
order: 5
---
这里放你的教程内容或链接列表。
GitHub Pages 自动生成导航，无需手动修改 HTML。
🎨 4. 修改首页、主题、标题等
你的站点的大部分设置在 _config.yml。
常用字段：
1
2
3
4
5
6
7
8
9
title: "RookiePhaseChangeBoss"
tagline: "个人技术博客"
url: "https://rookiephasechangeboss.github.io"
author:
name: "你的名字"
email: "xxxx@example.com"
theme_mode: dark # 强制深色模式（可选）
想改网站图标（favicon），替换：
1
assets/img/favicons/
🖼️ 5. 如何添加图片（建议方法）
将图片放到：
1
assets/img/
例如：
1
assets/img/proxy-setting.png
Markdown 里这样使用：
1
或绝对路径：
1
📂 6. 如何修改主题样式（可选）
你可以在这里覆盖 CSS：
1
assets/css/jekyll-theme-chirpy.css
例如改变文章标题颜色：
1
2
3
h1.post-title {
color: #ff5722;
}
🧪 7. 如何本地预览（强烈推荐）
Windows 10 上你需要用 WSL 来运行 Jekyll。
✔️ 安装 Ruby + Jekyll + Bundler（WSL）
进入仓库目录：
1
2
sudo apt update
sudo apt install ruby-full build-essential zlib1g-dev
安装 bundle：
1
gem install bundler jekyll
安装依赖：
1
bundle install
✔️ 本地运行
1
bundle exec jekyll serve
然后浏览器打开：
1
http://127.0.0.1:4000
🔧 8. 如何修改完推送到 GitHub（自动部署）
只需正常 Git 提交：
1
2
3
git add .
git commit -m "添加 Windows 10 开发环境教程"
git push
GitHub Pages 会自动构建，等待 1～5 分钟即可上线。
📘 如果你希望，我还可以帮你写：
✅ 固定的 md 模板 ✅ 如何自定义文章首页封面图 ✅ 如何添加侧边栏菜单 ✅ 如何自定义 Chirpy 主题颜色 ✅ 整套 Windows 开发环境教程（你之前提到的）
只要告诉我你要哪一部分！
本文由作者按照
CC BY 4.0
进行授权