style(portal): 重做整站排版,改为落地页式布局
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)已截图核对,无横向溢出
This commit is contained in:
Dai0814
2026-11-04 14:13:50 +08:00
parent 1d67fc7082
commit ac1354da9e
16 changed files with 1286 additions and 219 deletions
+25 -13
View File
@@ -10,13 +10,13 @@ outline: deep
## 许可证
全部项目以 **Apache-2.0** 发布。可自由使用、修改、商用与再分发;分发时保留版权声明与许可证原文,并对修改部分注明变更。各项目依赖的上游组件保留其原始许可。
全部项目以 **Apache-2.0** 发布。
## 参与贡献
1. 从目标项目的默认分支切出特性分支,命名 `feat/xxx`、`fix/xxx`
2. 提交前确保各自的构建与测试通过(Go 服务跑 `go build ./...` 与 `go test ./...`,前端跑 `pnpm build`)
3. 提交合入请求并说明变更动机
| 允许 | 需要 |
| --- | --- |
| 自由使用、修改、商用、再分发 | 保留版权声明与许可证原文 |
| 用于闭源商业产品 | 对修改过的文件注明变更 |
| 专利授权(贡献者授予) | 各项目上游依赖保留其原始许可 |
## 各项目仓库
@@ -27,17 +27,29 @@ outline: deep
| XiuAdmin | <https://gitee.com/snowgoat/xiu-admin> |
| 本门户站 | <https://git.5iot.com/iotlcm-public/website> |
## 参与贡献
| 步骤 | 做什么 |
| --- | --- |
| 1 | 从目标项目的默认分支切出特性分支,命名 `feat/xxx`、`fix/xxx` |
| 2 | 提交前确保构建与测试通过:Go 服务跑 `go build ./...` 与 `go test ./...`,前端跑 `pnpm build` |
| 3 | 提交合入请求,说明变更动机与影响范围 |
## 提问与反馈
- 使用问题与缺陷:对应仓库开 issue
- 功能建议:issue 里描述清楚场景与期望
- 部署排错:先看各项目详情页的常见问题表,再开 issue 附上 `docker compose ps` 与相关日志
| 类型 | 去哪 |
| --- | --- |
| 使用问题与缺陷 | 对应仓库开 issue |
| 功能建议 | issue 里描述清楚场景与期望 |
| 部署排错 | 先看各项目详情页的常见问题表,再开 issue 并附 `docker compose ps` 与相关日志 |
## 运维自用组件的边界
## 边界说明
飞书通知机器人(`with-bot` profile)是给运维方自用的工具,需要自建应用的凭据才能启动,**不是平台功能**,未配置时不影响平台运行。
运营商通道的生产凭据不随仓发布,需自行向运营商申请。
| 项 | 说明 |
| --- | --- |
| 飞书通知机器人 | `with-bot` profile 下的运维自用工具,需要自建应用凭据才能启动,**不是平台功能**,未配置不影响运行 |
| 运营商凭据 | 通道的生产凭据不随仓发布,需自行向运营商申请与配置 |
| 老平台私有模块 | 开源版发布的是微服务家族,不含历史项目的私有定制部分 |
## 门户本身