Skip to content

docs: 手机端排版优化,长内容改为折叠、横滑和本页目录 - #4

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

JiTianYu391 merged 4 commits into
masterfrom
ccr-a7403d49-gagk8j

Conversation

@JiTianYu391

Copy link
Copy Markdown
Contributor

改了什么

接着 #3,解决官网在手机上"文字太长、太挤"的问题。没有删任何文案,只改呈现方式。

手机端排版

  • 表格在 48rem 以下每行变成一张卡片:行名在上,值前面补列名(main.js 把表头写进 data-label)。原来三列表格把说明列挤到五六个字宽、徽标被裁掉的问题没有了
  • 卡片里的状态徽标和数字列(行数)挪到标题右边;文字最长的说明列不再重复显示列名
  • .rows-wide 特性列表改为带 01 / 02 编号的卡片网格(电脑两列)
  • 中文排版:text-autospace、text-spacing-trim、line-break: strict,段落 text-wrap: pretty 避免末行孤字
  • 行内代码缩小一号并用 box-decoration-break: clone;窄屏代码块的复制按钮移到代码上方,不再压住长命令

长内容

  • 小节较多的页面在首屏下方加吸顶的「本页目录」,滚动时高亮当前小节,页眉收起时贴顶
  • 特性卡片:电脑上先显示 4 张,其余用「展开其余 N 项」展开;手机上改为横向滑动的卡片带,下方有进度条和「当前 / 总数」
  • 超过 5 行的表格先显示 4 行;配置要求页的表格标了 data-nofold,不折叠(硬件要求必须直接看到)
  • 展开后新内容由 motion.js 依次浮现

效果(手机,按屏数计)

页面 之前 之后
SpaceOS 8 16.3 11.7
PySpOS 10.7 7.6
SpaceOS 9 8.1 7.0
SpaceOS 7 5.0 3.2
SpaceOS 6 4.3 2.8
配置要求 6.6 6.0

兜底

  • 折叠、横滑、目录都是渐进增强:没有 JavaScript 时内容全部平铺

验证

  • 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 squash 合并前的旧分支头,不带来任何文件改动。


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
@JiTianYu391
JiTianYu391 merged commit ade0851 into master Nov 8, 2026
3 checks passed
JiTianYu391 pushed a commit that referenced this pull request Nov 8, 2026
…his branch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLhesahBsuQSbGntwoQFN
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