Dai0814
6944652966
mirror-to-gitee / mirror (push) Successful in 3s
原先导航「官方文档」指向 /#docs（首页内的文档区块）， 用户期望点它直接进 http://open.5iot.com:5051/docs/。 改动 - 导航项改为外链 http://open.5iot.com:5051/docs/， 带 target=_blank 与 rel=noopener，新开标签页不打断阅读 - 首页 hero 的「官方文档」按钮同样改为外链直跳 - 文档站地址收敛为单一来源：data/content.ts 导出 DOCS_BASE / DOCS_HOME， 可用环境变量 DOCS_BASE 覆盖；config.mts 与 HomePage.vue 都引用它， 消除原先三处硬编码 - 首页的「官方文档」区块（#docs）保留，仍是各手册入口的聚合卡片 验证 - 导航渲染实测：href=http://open.5iot.com:5051/docs/, target=_blank - 点击实测：新开标签页到目标地址，原页面 URL 不变 - 锚点项高亮不受影响（点「产品功能」仍正常变蓝） - 构建 13 页 262 引用 0 失效
25 lines
933 B
Markdown
25 lines
933 B
Markdown
---
|
|
title: 全部项目
|
|
description: 雪羊科技开源项目清单
|
|
outline: deep
|
|
---
|
|
|
|
# 全部项目
|
|
|
|
雪羊科技对外开源的物联网卡与设备管理平台。三个项目覆盖物联网卡管理、硬件设备管理与中后台开发底座，全部以 Apache-2.0 发布。
|
|
|
|
<ProjectList />
|
|
|
|
## 清单怎么维护
|
|
|
|
项目清单由站点源码里的单一注册表维护（`data/projects.ts`），首页卡片、侧边栏与本页都从它生成。
|
|
|
|
新增一个项目需要两步：
|
|
|
|
| 步骤 | 做什么 |
|
|
| --- | --- |
|
|
| 1 | 在 `data/projects.ts` 里加一条记录（名称、定位、说明、代码仓、许可证、技术栈、状态、详情页路径、子页面） |
|
|
| 2 | 写 `pages/projects/<id>/index.md` 详情页，有子页面则在记录的 `sections` 里登记 |
|
|
|
|
构建前会自动校验「注册表条目」与「详情页目录」是否一一对应，不一致直接报错，避免清单与页面脱节。
|