项目结构说明
项目结构说明
这个文件帮你快速理解 Wantching.github.io 的文件夹结构 🟢 = 你的内容 🟡 = 模板示例(可参考/可删) 🔵 = 系统文件(不要动)
📁 一图看懂
Wantching.github.io/
│
├── 🔵 _config.yml ← 网站总控制台
├── 🔵 _config.dev.yml ← 开发环境配置
├── 📖 README.md ← 你的搭建教程笔记
├── 📖 STRUCTURE.md ← 本文件:项目结构说明
│
├── 🔵 _layouts/ (7文件) ← 页面骨架,HTML 模板
├── 🔵 _includes/ (40+文件) ← 可复用组件(导航栏、侧边栏等)
├── 🔵 _sass/ (18+文件) ← 网站样式(颜色、字体、布局)
├── 🔵 _data/ (4项) ← 数据配置
│ ├── 🟢 navigation.yml ← 导航菜单(你会改)
│ ├── 🟢 authors.yml ← 作者信息(已改为你的)
│ ├── 🔵 ui-text.yml ← 界面多语言文字
│ └── 🟡 comments/ ← 评论示例数据
│
├── 📦 assets/ ← 静态资源(CSS、JS、字体、图标)
├── 🖼️ images/ ← 图片(头像、配图)
│ ├── 🟢 pink.png ← 你的头像
│ └── 🟡 其他图片 ← 模板示例图片
│
├── 📄 _pages/ (25文件) ← 网站页面
│ ├── 🟢 about.md ← 你的首页(/)
│ ├── 🟢 cv.md ← 你的英文简历(/cv/)
│ ├── 🟢 cv-zh.md ← 你的中文简历
│ ├── 🟢 Blogs.md ← 你的博客列表(/Blogs/)
│ ├── 🟢 Notes.md ← 你的笔记列表(/Notes/)
│ ├── 🟢 Repositories.md ← 你的仓库展示(/Repositories/)
│ ├── 🟢 Links.md ← 你的友情链接
│ ├── 🟡 404.md / markdown.md ← 模板页面
│ └── 🟡 其他 .html/.md ← 归档页面(tags、categories等)
│
├── ✍️ 内容文件夹
│ ├── 🟡 _posts/ (5篇) ← 模板示例文章(2012-2015)
│ ├── 🟢 _Blogs/ (1篇) ← 你的博客
│ │ └── first-blog.md ← "Wantching的第一篇blog"
│ ├── 🟢 _Notes/ (1篇) ← 你的笔记
│ │ └── quantum-science-intro.md ← 量子科学技术概论
│ ├── 🟢 _Repositories/(1篇) ← 你的仓库展示
│ │ └── pku.github.io.md
│ ├── 🟡 _publications/(3篇) ← 模板示例论文
│ ├── 🟡 _talks/ (4篇) ← 模板示例演讲
│ ├── 🟡 _teaching/ (2篇) ← 模板示例教学
│ ├── 🟡 _portfolio/ (2篇) ← 模板示例作品
│ └── 🟡 _drafts/ (1篇) ← 示例草稿
│
├── 🛠️ markdown_generator/ ← 批量生成 md 文件的工具(Python)
├── 🗺️ talkmap/ ← 演讲地图(Leaflet.js)
├── 📖 docs/screenshots/ ← README 配图
│
└── 🔵 根目录配置文件
├── Gemfile / Gemfile.lock ← Ruby 依赖
├── package.json ← JS 依赖
└── .gitignore ← Git 忽略规则
🟢 你的内容(这些是你要维护的)
个人信息
| 文件 | 改什么 | |——|——–| | _config.yml 第 82-118 行 | 名字、头像、简介、社交链接 | | _data/authors.yml | 多作者场景下的作者信息 | | _data/navigation.yml | 导航栏菜单项 |
页面内容
| 文件 | URL | 说明 | |——|—–|——| | _pages/about.md | / | 首页 | | _pages/cv.md | /cv/ | 英文简历 | | _pages/cv-zh.md | /cv-zh/ | 中文简历 |
自定义内容
| 文件夹 | 列表页 | 说明 | |——–|——–|——| | _Blogs/ | _pages/Blogs.md → /Blogs/ | 博客文章 | | _Notes/ | _pages/Notes.md → /Notes/ | 学习笔记 | | _Repositories/ | _pages/Repositories.md → /Repositories/ | 项目仓库展示 |
🟡 模板示例(可作参考,不用时可以删)
这些是原模板 academicpages 自带的示例内容,不是你的实际数据:
| 文件夹 | 数量 | 可以删吗? |
|---|---|---|
_posts/ | 5篇英文示例 | ✅ 如果你不写博客,可以全删 |
_publications/ | 3篇示例论文 | ✅ 如果你不展示论文,可以全删 |
_talks/ | 4篇示例演讲 | ✅ 如果你不展示演讲,可以全删 |
_teaching/ | 2篇示例教学 | ✅ 如果你不展示教学,可以全删 |
_portfolio/ | 2篇示例作品 | ✅ 如果你不展示作品集,可以全删 |
_drafts/ | 1篇示例草稿 | ✅ 可以删 |
_data/comments/ | 7条示例评论 | ✅ 可以删 |
💡 删除示例内容后,对应的导航菜单项(_data/navigation.yml 里被
#注释掉的)也不需要了。
🔵 系统文件(改了网站会出问题)
| 文件夹 | 作用 | 风险 |
|---|---|---|
_layouts/ | 页面骨架 | ⚠️ 改错一个,所有页面都乱 |
_includes/ | 可复用组件 | ⚠️ 导航栏、SEO 等重要功能 |
_sass/ | 样式系统 | ⚠️ 改 _variables.scss 是安全的(只改颜色) |
assets/ | 静态资源 | ⚠️ main.scss 和 JS 不要乱动 |
_config.yml | 总配置 | ⚠️ 大部分可以改,但 collections 和 plugins 要小心 |
🔧 日常操作速查
| 想做什么 | 去哪个文件 |
|---|---|
| 改名字/头像/简介 | _config.yml 第 82-91 行 |
| 加/减导航菜单项 | _data/navigation.yml |
| 改网站主色调 | _sass/_variables.scss 里的 $primary-color |
| 写新博客 | 在 _Blogs/ 新建 .md 文件 |
| 写新笔记 | 在 _Notes/ 新建 .md 文件 |
| 改首页内容 | _pages/about.md |
| 更新简历 | _pages/cv.md |
| 加友情链接 | _pages/Links.md |
📚 更详细的技术讲解参见
study for Claudecode/Git与GitHub入门/讲义/03-项目完整文件讲解.md
