项目结构说明

项目结构说明

这个文件帮你快速理解 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