Dai0814 ea47bab100
mirror-to-gitee / mirror (push) Successful in 4s
style(portal): 核心能力改为深色强调区块,并前移到产品功能之前
用户反馈"上方没有核心能力重点突出"。原因是原实现里
核心能力用的是 p-section--alt(浅灰底),而它相邻的产品功能是白底、
项目列表也是浅灰底,三者色阶接近,深色上没有形成视觉断点,
区块在页面里读起来和普通段落没有区别。

改动
- 新增 .p-section--deep 变体:浅色主题下用 #0d1220 近黑底 +
  顶部靛蓝径向光晕 + 一道渐变高光线,卡片改半透明白
- 核心能力改用该变体,并从产品功能之后移到之前:
  项目 → 核心能力(深色)→ 产品功能 → 界面预览
  深色块夹在项目列表与产品功能之间,形成明显的节奏断点
- 产品功能改用 p-section--alt,与前后白底交替
- 暗色主题下强调区不能用"压深"(页面底已是 #0c0f16),
  改用 #161b2c 冷灰蓝 + 更强光晕,靠提亮形成层次

验证
- 构建 13 页,256 条引用 0 失效
- 浏览器实测区块顺序:hero → projects → core → features → preview
  → foundation → howtheyfit → docs → cta
- 浅色 / 暗色两套主题均截图核对,强调区都能跳出来
2026-11-04 14:34:53 +08:00

雪羊科技开源项目门户

开源项目门户站源码。当前收录 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                    # 多阶段构建镜像

新增一个项目

两步,不需要改动站点其它部分:

  1. 在 data/projects.ts 里加一条记录(名称、定位、说明、代码仓、许可证、技术栈、状态、详情页路径、子页面)
  2. 写 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

详见 门户部署。

S
Description
雪羊科技开源项目门户(iotLCM / xiu-dtu / xiu-admin 等开源项目索引)
Readme 1.6 MiB
Languages
TypeScript 31.3%
CSS 28.2%
Vue 24.4%
JavaScript 14.4%
Dockerfile 1.7%