Dai0814
fefad82e78
mirror-to-gitee / mirror (push) Successful in 6s
现象：导航左上角显示成「雪羊科技物联网卡与设备管理平台」挤在一行， 副标题没有换行，还压到了 logo 上。 根因 siteTitle 里的副标题是 <span class="site-subtitle">，经 v-html 插入后， 其父级是 VitePress 自己的**裸 <span>（无 class）**，而不是 .title-text。 原样式写的是 `.VPNavBarTitle .title-text .site-subtitle`， 选择器永远匹配不上，display:block 从未生效，副标题只能行内跟随。 改动 - 选择器改为 .VPNavBarTitle .site-subtitle（去掉不存在的 .title-text） - 品牌名与副标题的容器改为 flex 纵向 + 垂直居中， 整体在导航高度内居中 - 副标题 11px / 0.03em 字距 / var(--p-ink-3) 弱化； 品牌名与副标题间距 3px - 响应式：≤860px 副标题缩到 10.5px；≤480px 隐藏副标题只留品牌名 - 新增 scripts/check-nav-brand.mjs 并接入 npm run check（prebuild/predev 自动跑）： 校验 siteTitle 的**品牌主体**必须是「雪羊科技」（允许带副标题 span）， 且 logo 配置与文件都存在。 反例全部验证：改成「雪羊开源」→ 拦；只留「雪羊科技」→ 通过； 改成「雪羊科技开源」→ 拦；删掉 siteTitle → 拦 验证 - 干净副本构建后实测三档宽度： 1440/860 → 「雪羊科技 ⏎ 物联网卡与设备管理平台」，display:block 390 → 只显示「雪羊科技」，副标题 display:none - 品牌区截图确认两行居中、不压 logo
雪羊科技开源项目门户
开源项目门户站源码。当前收录 iotLCM（物联网卡全生命周期管理平台）、秀杰 DTU 管理平台、XiuAdmin（中后台开发框架）。
- 站点框架：VitePress 1.6（与 iotLCM 的文档站同构）
- 产物：纯静态文件
- 许可：Apache-2.0
目录
.
├── data/projects.ts # 项目注册表 —— 门户唯一项目清单来源
├── pages/
│ ├── index.md # 门户首页
│ ├── projects/index.md # 全部项目
│ ├── projects/<id>/index.md # 各项目详情页
│ ├── guide/portal-deploy.md # 门户自身的构建与部署
│ └── about.md # 关于、许可、贡献说明
├── .vitepress/theme/components/ # 项目卡片与列表组件
├── scripts/check-registry.mjs # 注册表与详情页一致性校验
├── deploy/docker-compose.yml # 容器部署编排
└── Dockerfile # 多阶段构建镜像
新增一个项目
两步，不需要改动站点其它部分：
- 在
data/projects.ts里加一条记录（名称、定位、说明、代码仓、许可证、技术栈、状态、详情页路径、子页面） - 写
pages/projects/<id>/index.md详情页
首页卡片、项目列表页、侧边栏都会自动带上新项目。
构建前会自动校验注册表与详情页目录是否一一对应，不一致直接报错：
npm run check
本地开发
npm ci
npm run dev # http://127.0.0.1:5173
构建
npm run build # 产物在 .vitepress/dist/
部署
docker compose -f deploy/docker-compose.yml up -d --build
默认发布在宿主机 127.0.0.1:8020。站点资源前缀由 SITE_BASE 决定：
| 形态 | 参数 | 访问方式 |
|---|---|---|
| 子路径（过渡，无独立域名） | /www/（默认） |
由已有网关转发 /www/ 到本容器 |
| 独立域名 | / |
域名根路径 |
SITE_BASE=/ docker compose -f deploy/docker-compose.yml up -d --build
详见 门户部署。