 Dai0814
|
e4757446cf
|
feat(portal): 补入整站页脚，并让项目列表页不显示页脚
mirror-to-gitee / mirror (push) Successful in 4s
用户反馈 /projects/（项目列表）页底部的品牌/联系/版权区应该去掉。
背景：这几个文件此前一直未提交——远端仓库其实没有页脚，
PortalFooter.vue 只存在于本地，HEAD 版 index.ts 也没引用它。
所以本次把页脚整套补齐，再叠加「按页面决定是否展示」的逻辑。
新增/改动
- .vitepress/theme/components/PortalFooter.vue（新增，274 行）
品牌区 + 产品体系/文档资源/关于我们/联系我们四栏 + 二维码浮层 + 版权条
- .vitepress/theme/styles/portal.css：补入全部 .pf-foot-* 样式（508 行）
只搬运页脚相关规则，不夹带工作区里其它未提交的样式改动
- .vitepress/theme/index.ts：挂载页脚 + 页面级显隐判定
- pages/projects/index.md：frontmatter 加 footer: false
页脚显隐判定（isDocPage）
「文档型页面不挂页脚」——这类页面有左侧目录树、右侧本页目录、
底部上一页/下一页翻页，读者正在阅读流里，450px 的品牌收尾区是纯噪音。
命中任一条件即隐藏：
1) 路径 /projects/<id>/manual/...
2) frontmatter 有 sidebar / outline / aside
3) frontmatter 显式 footer: false
frontmatter 的 footer 可双向覆盖（这解决了 /projects/ 的困境）：
该页有 outline: deep，按上面的规则本会被判成文档页而隐藏页脚，
但它本质是「浏览页」，需要显式 footer: false 才符合预期。
同理 footer: true 可强制显示。
验证（干净 clone 构建后实测）
- /projects/ 无页脚（footer=false，无版权条）
- / 有页脚（453px，渐变背景正常）
- 文档页（详情/对比/快速开始/手册）均无页脚
- 自定义整页（关于/联系/演示/官方文档）均有页脚
|
2026-11-06 13:39:41 +08:00 |
|
|
Dai0814
|
6944652966
|
fix(portal): 官方文档导航直接跳文档站，不再停在本站锚点
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 失效
|
2026-11-04 15:36:04 +08:00 |
|
|
Dai0814
|
ac1354da9e
|
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）已截图核对，无横向溢出
|
2026-11-04 14:13:50 +08:00 |
|
|
技小云
|
fe63dacae2
|
feat: 开源项目门户站首版（iotLCM / 秀杰 DTU / XiuAdmin 三项目，注册表驱动）
|
2026-11-04 11:08:47 +08:00 |
|