Skip to content

docs: 介绍页改为 Markdown 式排版并精简文案,配置要求改为最低 / 推荐对照表 - #5

Merged
JiTianYu391 merged 7 commits into
masterfrom
ccr-a7403d49-gagk8j
Nov 8, 2026
Merged

JiTianYu391 merged 7 commits into
masterfrom
ccr-a7403d49-gagk8j

Conversation

@JiTianYu391

Copy link
Copy Markdown
Contributor

改了什么

接着 #4,进一步解决官网"文字太长、排版太花"的问题。

介绍页(PySpOS、SpaceOS 9 / 8 / 7 / 6)

  • 首屏保留,以下改成单栏文章,排版仿渲染后的 Markdown:带 # / ## 的小节标题和下边线、短横线列表、等宽编号的有序列表、GitHub 风格提示块、带边框和隔行底色的表格
  • 电脑上左侧吸顶目录,手机上是顶部目录条,滚动时高亮当前小节(目录是静态 HTML,没有脚本也能用)
  • 去掉这些页上的要点卡片、流程图、分层图和特性卡片网格,改为列表
  • 文案按短句、一句一事重写,保留版本号、数字、组件名和状态等事实;正文字数约减半
页面 字数 屏数(手机)
SpaceOS 8 3348 → 1637 11.7 → 6.3
PySpOS 2631 → 1433 7.6 → 4.9
SpaceOS 9 1676 → 1000 7.0 → 3.7
SpaceOS 7 951 → 533 3.2 → 2.3
SpaceOS 6 934 → 539 2.8 → 2.3

配置要求页

  • 每个产品一张「项目 | 最低配置 | 推荐配置」表,下面只留一两句注意事项;只用原页面已有的事实,没有单独推荐值的写「同左」
  • 排版与介绍页一致;表格标 data-keep-labels,手机上最低 / 推荐两栏并排
  • 手机上从约 6 屏缩到 4.9 屏

脚本

  • main.js:目录高亮同时支持静态目录和自动生成的目录;文档页里的表格不折叠;data-keep-labels 的表在手机上保留每一列的列名

验证

  • check_tokens_contrast.py、check_design_layer.py、check_docs_html.py、check_ota_manifest.py、sync_docs_chrome.py --check、ruff check tools/ 全部通过
  • Playwright(Chromium)在 Pixel 7 和 1440 宽度下检查:无横向溢出、无控制台报错,目录高亮正常
  • 未在 Safari / Firefox / 真机上测试

注:分支上的 -s ours 合并提交只用来接上 #3、#4 squash 合并前的旧分支头,不带来文件改动;与 master 的实际差异是 13 个文件。


Generated by Claude Code

- 配色改为近黑底 + 紫青渐变,默认深色,浅色仍可切换;token 全部通过 WCAG AA 检查
- 样式重做:玻璃质感卡片、首屏极光与网格背景、渐变标题、终端窗口栏、鼠标跟随高光
- 新增 js/motion.js:Lenis 平滑滚动、首屏逐行/逐字入场、插画分层拼装与连线流动、
  滚动入场、条形图生长与数字滚动、终端逐行打出、卡片 3D 倾斜、按钮磁吸、导航滑块、
  阅读进度条、页眉滚动收起、页脚大字标
- 主题切换用 View Transitions 圆形展开;同站跳转加跨页面转场
- GSAP 3.15.1 与 Lenis 1.3.27 放在 docs/js/vendor 本地加载,由 sync_docs_chrome.py 写入各页
- 无脚本、脚本加载失败、减少动态效果时都退回静态页面,内容不会被藏住
- check_design_layer.py 放宽为:@Keyframes 内与白名单里的装饰伪元素可以用 opacity,
  静态内容仍然不允许

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
- 表格在 48rem 以下每行变成一张卡片,行标题在上,值前面补列名(main.js 把表头写进 data-label),
  不再把说明列挤成几个字宽,徽标也不再被裁掉
- .rows-wide 特性列表改为带 01/02 编号的卡片网格:桌面两列,手机一列
- 中文排版:text-autospace、text-spacing-trim、line-break: strict,段落 text-wrap: pretty 避免末行孤字
- 行内代码缩小一号并用 box-decoration-break: clone,折行时两段都保留完整圆角
- 配置要求页左侧图标标题与其他页的小节标题一样吸顶

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
…his branch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
- 小节多的页面在首屏下方加吸顶的本页目录,滚动时高亮当前小节,页眉收起时贴顶
- 特性卡片:电脑上先显示 4 张,其余用「展开其余 N 项」按钮展开;
  手机上改为横向滑动的卡片带,下方有进度条和「当前 / 总数」
- 超过 5 行的表格先显示 4 行;配置要求页的表格标了 data-nofold,不折叠
- 手机表格卡片:状态徽标和数字列挪到标题右边,说明列不再重复显示列名
- 窄屏代码块的复制按钮移到代码上方,不再压住长命令
- 全部是渐进增强:没有脚本时内容全部平铺
- 手机上 PySpOS 页从约 10.7 屏缩到 7.6 屏,SpaceOS 8 页从 16.3 屏缩到 11.7 屏

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
- PySpOS、SpaceOS 9 / 8 / 7 / 6 五个介绍页:首屏保留,以下改成单栏文章,
  左侧吸顶目录(手机上是顶部目录条),滚动时高亮当前小节
- 排版仿渲染后的 Markdown:带 # / ## 的小节标题和下边线、短横线列表、
  等宽编号的有序列表、GitHub 风格提示块、带边框和隔行底色的表格
- 去掉这些页上的要点卡片、流程图、分层图和特性卡片网格,改为列表
- 文案按短句、一句一事重写,正文字数约减半(SpaceOS 8 3348→1637 字,PySpOS 2631→1433 字)
- 文档页里的表格不再折叠;main.js 的目录高亮同时支持静态目录和自动生成的目录

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
…his branch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
- 每个产品一张「项目 | 最低配置 | 推荐配置」表,下面只留一两句注意事项;
  表里只用原页面已有的事实,没有单独推荐值的写「同左」
- 页面换成和介绍页一致的文档排版(左侧目录、单栏正文)
- 对照表加 data-keep-labels:手机上最低 / 推荐两列都保留列名,并排成两栏
- 手机上配置要求页从约 6 屏缩到 4.9 屏

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
@JiTianYu391
JiTianYu391 merged commit e39ab6b into master Nov 8, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants