simba_docs/README.md

ΣDOCS · Simba Robotics

黑龙江大学 Simba 战队的文档站，基于 Astro 7 与 Starlight。首页复用 Simba 主站的黑红视觉、机器人实拍、Logo 和小组图标；文章页保留 Starlight 的侧栏、页内目录、搜索、浅色 / 深色主题与语言切换。

本地运行

npm install
npm run dev -- --background
npm run astro -- dev status
npm run astro -- dev logs
npm run astro -- dev stop

中文首页：http://localhost:4321/zh-cn/，英文首页：/en/，根路径跳转到中文首页。

生产构建使用 npm run build，产物在 dist/。npm run preview 可验证生产版本与 Pagefind 搜索；开发模式中的搜索由 Starlight 显示开发提示。正式部署时，在 astro.config.mjs 设置实际 site 域名，以生成 sitemap。

从哪里修改

内容	文件 / 目录
首页布局与中英文文案	src/components/Home.astro
首页卡片、描述和链接	src/data/home.ts
首页样式	src/styles/home.css
文档主题与品牌	src/styles/custom.css、src/components/SiteTitle.astro
分类和顺序	astro.config.mjs、页面 frontmatter 中的 sidebar.order
入门与写作示例	src/content/docs/zh-cn/guides/
技术方向	src/content/docs/zh-cn/{mest,elct,vsag,pram}/
校内赛规则	src/content/docs/zh-cn/competition/
原始规则附件	public/downloads/rmic-2026-original-draft.md

新增 .md 或 .mdx 页面后，侧栏按目录自动生成。技术示例的页首有“示例内容”提示，替换为经过确认的内容后再调整该提示。原有视觉组导论保留，未改写。

英文首页已提供，未翻译文章使用 Starlight 默认语言回退并显示提示。首页入口直达现有中文文章，避免空页面。

校内赛规则

规则被整理为概览、赛前考核、开源审查、对抗赛、制作规范、裁判系统、待确认事项七章。使用 Starlight 提示栏、步骤、卡片、标签页、表格和自适应赛程示意。没有额外引入 Mermaid 客户端依赖；原始 Mermaid 源码保留在下载附件，网页以阶段示意与完整晋级关系表展示同一赛程。

pending.md 记录原稿缺失或有歧义的条款。正式发布前，应补齐报名入口、场地信息、同分规则、尺寸孔位图等，并同步各章节。所有页面当前标记为规则预览版；原始附件保持不变。

主站素材

素材于 2026-09-23 从 https://simba-robotics.com 复用并保存到 public/simba/，页面加载不依赖主站在线。素材属于战队原有资产，不因本次复用改变授权。

本地文件	主站来源路径	用途
logo.svg	/logo.svg	品牌图标、favicon
logo_with_char.webp	/logo_with_char.webp	页脚 Logo
header.webp	/header.webp	首页机器人背景
mest.svg	/icons/mest.svg	机械架构入口
elct.svg	/icons/elct.svg	电传测控入口
vsag.svg	/icons/vsag.svg	视觉算法入口
pram.svg	/icons/pram.svg	宣传筹划入口

参考：Astro 文档、Starlight 文档。