外观
维护指南
本站是纯静态站点(VitePress),内容即 Markdown 文件。技术维护只需会最基础的命令行和 Git。
本地开发
bash
# 环境:Node.js 20+,推荐 pnpm
pnpm install # 或 npm install
pnpm dev # 本地预览 http://localhost:5173
pnpm build # 构建产物在 docs/.vitepress/dist
pnpm preview # 本地预览构建产物
pnpm audit # 死链与目录表自检目录结构
docs/
├── .vitepress/
│ ├── config.mts # 导航/侧栏/搜索等站点配置
│ ├── appLinks.ts # ★系统入口唯一配置点(成员端/报名/后台)
│ ├── data/
│ │ └── maintainers.js # ★维护团队数据(加人只改这里)
│ └── theme/ # 主题与品牌色(custom.css)
├── public/ # 静态资源(favicon、avatars 头像)
├── about/ department/ library/
├── activity/ resources/
├── guide/ maintainer/
└── index.md # 首页内容规范
- 文件名用英文或拼音(避免 URL 中文编码问题)
- 页面放对应栏目目录,并在
config.mts侧栏登记 - 图片入库前压缩;涉及人物肖像须本人同意
- 示例/占位内容统一用"🚧 待补"标注,方便后续检索清理
- 新增维护者:编辑
docs/.vitepress/data/maintainers.js,头像放入docs/public/avatars/
系统入口(重要)
顶部导航"成员端 ↗"、首页"成员工作区"卡片、招新页报名按钮,全部读取 docs/.vitepress/appLinks.ts。主应用路由变更时只改这一个文件。
发布流程
main 分支 push → GitHub Actions 自动构建并发布到 GitHub Pages(工作流见 .github/workflows/deploy.yml),约 2–4 分钟上线。
main 已开启分支保护:协作者必须走 Pull Request 并由维护者批准;改动数据文件还会触发 CODEOWNERS,需仓库所有者批准。协作细节见协作与贡献流程。
管理后台
中心系统端后台仅对管理员开放,入口不在公开站展示;需要权限请联系现任管理员。