ea47bab1008d29b7896eb22f4cbdee922e610213
mirror-to-gitee / mirror (push) Successful in 4s
用户反馈"上方没有核心能力重点突出"。原因是原实现里 核心能力用的是 p-section--alt(浅灰底),而它相邻的产品功能是白底、 项目列表也是浅灰底,三者色阶接近,深色上没有形成视觉断点, 区块在页面里读起来和普通段落没有区别。 改动 - 新增 .p-section--deep 变体:浅色主题下用 #0d1220 近黑底 + 顶部靛蓝径向光晕 + 一道渐变高光线,卡片改半透明白 - 核心能力改用该变体,并从产品功能之后移到之前: 项目 → 核心能力(深色)→ 产品功能 → 界面预览 深色块夹在项目列表与产品功能之间,形成明显的节奏断点 - 产品功能改用 p-section--alt,与前后白底交替 - 暗色主题下强调区不能用"压深"(页面底已是 #0c0f16), 改用 #161b2c 冷灰蓝 + 更强光晕,靠提亮形成层次 验证 - 构建 13 页,256 条引用 0 失效 - 浏览器实测区块顺序:hero → projects → core → features → preview → foundation → howtheyfit → docs → cta - 浅色 / 暗色两套主题均截图核对,强调区都能跳出来
雪羊科技开源项目门户
开源项目门户站源码。当前收录 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
详见 门户部署。
Description
Languages
TypeScript
31.3%
CSS
28.2%
Vue
24.4%
JavaScript
14.4%
Dockerfile
1.7%