 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
|
39209ef591
|
fix(portal): 导航栏锚点项点击后正确高亮
mirror-to-gitee / mirror (push) Successful in 3s
问题：点「产品功能 / 核心能力 / 界面预览 / 官方文档」跳转后图标不变蓝。
根因：VitePress 的 isActive() 只比较 path，不看 hash。nav 里
「首页 /」「产品功能 /#features」「核心能力 /#core」的路径部分都是 `/`，
默认逻辑要么把首页和当前锚点同时点亮，要么只亮首页。
改动
- 新增 .vitepress/theme/nav-anchor.ts 接管首页内锚点项的激活判定：
用 data-anchor-active 属性标记，规则为
在首页且有 hash → 只有 hash 匹配项亮；在首页无 hash → 只有「首页」亮；
不在首页 → 清标记交回 VitePress 默认逻辑
- 样式侧用 html.portal-nav-home 限定压制默认 active 的作用域，
只影响首页，不影响 /projects/ 与 /about 的正常高亮
- 导航「项目」加 activeMatch: '^/projects/'，
使 /projects/iotlcm/ 等详情页也保持高亮
- MutationObserver 监听导航 DOM 变化（SPA 切换、主题切换会重建）
踩的坑
- Layout 是函数式组件，onMounted 在其中无效（Vue 报"no active component
instance"），改用 nextTick 调度
- 初版用 hashOf(a) 判空来识别「首页」，但 /projects/ 与 /about 也没有 hash，
被误判成首页项一起点亮；改为判断 href 解析后是否为 '/'
- 抑制规则最初没加作用域，导致非首页页面的正常 active 也被压成黑字
验证（8 个场景逐个实测）
首页顶部→首页 / 四个锚点→各自高亮 / 项目页→项目 /
关于页→关于 / iotLCM 详情→项目；构建 13 页 274 引用 0 失效
|
2026-11-04 15:23:37 +08:00 |
|
|
Dai0814
|
ccb3f5e39a
|
feat(portal): 首页补齐产品功能、核心能力、界面预览、官方文档四个区块
mirror-to-gitee / mirror (push) Successful in 4s
用户反馈首页缺产品功能、核心能力与界面预览，且没有官方文档入口。
新增区块
- 产品功能：三条产品线（iotLCM / 秀杰 DTU / XiuAdmin），
每条列 6 项能力，卡片底部直达详情页
- 核心能力：8 张带标签的卡片，讲工程层面的硬指标
（部署、接入、开放、治理、韧性、交付、数据、维护），
与"产品功能"区分开：前者是做什么，后者是凭什么能用住
- 界面预览：ScreenshotPreview 组件，Web 管理端 / 小程序端两组标签切换，
首屏大图 + 缩略图条，带浏览器窗口装饰
- 官方文档：6 个入口卡片（文档中心、Web 手册、小程序手册、部署手册、
OpenAPI 合同、门户部署说明），外链自动加 target=_blank
界面预览的占位机制
- previewShots 里 file 留空时渲染带图注的占位框，不报错、不影响构建
- 补图只改 file 字段，组件无需改动
- 新增 pages/public/screenshots/README.md 写清命名、尺寸、脱敏要求
导航
- 增加产品功能、核心能力、界面预览、官方文档四个锚点项
- 窄屏（≤860px）隐藏中间三个锚点项，避免挤压
验证
- 构建 13 页，208 条引用 0 失效
- 浏览器实测：7 个导航项、5 个 section 锚点齐全
- 移动端 390px 无横向溢出
- 文档站 5 个外链地址均实测 200 可达
|
2026-11-04 14:27:48 +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 |
|