Dai0814
ac1354da9e
mirror-to-gitee / mirror (push) Successful in 5s
排版语言 - 引入独立视觉系统 .vitepress/theme/styles/portal.css： 中性底色 + 单一强调色（#4f46e5），正文靠留白与层级取胜， 不使用大面积彩色底、渐变铺满或装饰性图形 - CSS 变量定义在 :root（原先挂在 .portal 下，导致内容页拿不到值） - 完整支持暗色模式，变量在 html.dark 下整体替换 首页（pages/index.md → HomePage.vue） - hero：居中大标题（强调色渐变仅作用于一个词组）、双按钮、四格数据条 - 项目区：三栏卡片，标题 + 状态徽标 + 定位 + 说明 + 技术栈标签 - 通用能力：六格编号卡片 - 组合方式：三栏场景步骤卡，每张带一条可复制命令 - 底部 CTA 区块 - 页面改用 layout: page，通过 Layout 包装层去掉默认窄栏 项目详情页 - iotLCM / DTU：能力矩阵改为标签切换（CapabilityTabs）， 每个业务域一屏，点击切换，替代原先的大宽表 - XiuAdmin：22 项内置功能按用途归为四组标签墙（FeatureGrid） - 内容页二级标题加短强调线，表格首列不换行，属性表不再竖排 数据 - 新增 data/content.ts 承载首页文案、能力分组、长期事实统计， 与 projects.ts 并列；文案口径取自各项目 README/详情页，无凭空数字 - 修正 scripts/check-registry.mjs：原先扫描 data/ 下所有 .ts 的 id， 新增 content.ts 后把业务分组 id 误判为项目；改为只读 projects.ts 验证 - 构建通过，12 个页面，193 条引用 0 失效 - HTTP 实测 12 个路径全 200，不存在路径 404 - 暗色模式与移动端（390px）已截图核对，无横向溢出
雪羊科技开源项目门户
开源项目门户站源码。当前收录 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
详见 门户部署。