项目结构
目录树
目录说明
| 路径 | 职责 |
|---|---|
index.html | HTML 入口，脚本指向 /src/main.jsx |
src/main.jsx | createRoot 挂载，引入 index.css 与 i18n |
src/App.jsx | 全部路由；新增页面在此注册 |
src/i18n/index.js | i18next 初始化与命名空间注册 |
src/locales/zh/、src/locales/en/ | 翻译 JSON |
src/components/layout/ | MainLayout、CompactPageHeader |
src/components/Pages/ | 页面级组件 |
src/hooks/ | useLocale、usePageMotion、useHomeNavbarReveal |
src/lib/ | locale.js、LocalizedLink.jsx、utils.js |
public/images/ | 静态图片；构建时原样复制到站点根路径 /images/ |
dist/ | npm run build 输出（勿提交；.gitignore 已忽略） |
仓库根目录没有 CRA 时代的 public/index.html、src/index.js、src/App.js、App.css 或文档用的 docs/。
页面子目录
| 目录 | 内容 |
|---|---|
Pages/Home/ | 首页 |
Pages/Activity/ | 活动列表；ActivityDetail/ 各活动页与缓冲页 |
Pages/Resources/ | 资源列表与职发详情 |
Pages/About/ | 关于页、关于网站；Divisions/ 各部门页 |
Pages/Honor_Wall/ | 荣誉墙组件 + Honor_Wall.json |
Pages/Partnership/ | 合作页 + Partnership.json |
图片存放规范
- 统一放在
public/images/，按模块分子目录（Activity/、About/、Resources/等） - 代码中使用根路径：
/images/模块名/文件名 - 优先
.webp
更多约定见 管理图片。