Skip to content

docs: 加入图标与 SVG 示意图,header 文字改为图标,减少纯文字 - #2

Merged
JiTianYu391 merged 1 commit into
masterfrom
claude/funny-dirac-62qs1c
Nov 7, 2026
Merged

JiTianYu391 merged 1 commit into
masterfrom
claude/funny-dirac-62qs1c

Conversation

@JiTianYu391

Copy link
Copy Markdown
Contributor

做了什么

页面纯文字偏多,加入图标和 SVG 示意图。只放在有信息量的地方,避免给每张卡片配同一批通用图标(上一版被认为"太 AI"的原因之一)。

机制图

  • PySpOS:一条命令的执行路径(Shell → 进程 → 运行时),标注对应源码路径
  • SpaceOS 9:启动顺序(UEFI → Limine → SpaceKernel → systemg → ash)
  • SpaceOS 8:系统分层图,虚线标出系统调用 ABI 的分界;应用规模用条形图对比
  • OTA 页:A/B 槽位升级与回滚的 SVG 示意
  • 两个下载页:下载 → 校验 → 启动三步

插画与图标

  • 首页首屏的分层示意图,三个项目色块各配不同图标
  • 每个产品页顶部四个要点,图标各不相同
  • 提示块、已验证/未验证徽标、下载按钮配功能性图标
  • 配置要求页的产品标题配与首页一致的图标

Header

  • 主题切换、菜单按钮改为太阳/月亮、汉堡/关闭图标,随状态切换
  • 下拉箭头由文字符号改为 SVG,下拉项配产品图标;GitHub 加外链图标
  • 品牌名前加分层标志,与首页插画呼应

实现

  • 25 个线条图标画成一个 SVG sprite,由 tools/sync_docs_chrome.py 统一注入,用 currentColor 与 token 上色,深浅主题自动适配
  • check_docs_html 新增:<use href="#i-..."> 必须在 sprite 里有对应 symbol
  • 流程图用 HTML + CSS 绘制,窄屏自动竖排,文字保持真实字号

验证

  • check_tokens_contrast / check_design_layer / check_docs_html / check_ota_manifest 全部通过
  • pytest tests/web:4 passed;ruff check tools/ build_update.py 通过
  • 11 个页面在 1280 / 390 / 320 宽度、浅色与深色下检查:无控制台报错、无 404、无页面级横向溢出,每页导航都有 SpaceOS 9
  • 图标引用核对:页面用到的图标在 sprite 中均存在,无未使用图标

说明

  • 图中的说法均来自页面原有事实;首页插画里的"宿主 / 硬件"是概括,用来同时覆盖 PySpOS 和 SpaceOS
  • 没有使用 GitHub 官方 logo,GitHub 链接为"文字 + 外链图标"

Generated by Claude Code

只放在有信息量的地方,避免给每张卡片配同一批通用图标:

机制图
- PySpOS:一条命令的执行路径(Shell → 进程 → 运行时)
- SpaceOS 9:启动顺序(UEFI → Limine → SpaceKernel → systemg → ash)
- SpaceOS 8:系统分层图,含系统调用 ABI 分界;应用规模用条形图对比
- OTA:A/B 槽位升级与回滚的 SVG 示意
- 两个下载页:下载 → 校验 → 启动三步

插画与图标
- 首页首屏的分层示意图,三个项目色块各配不同图标
- 每个产品页顶部四个要点,图标各不相同
- 提示块、已验证/未验证徽标、下载按钮配功能性图标
- 配置要求页的产品标题配与首页一致的图标

Header
- 主题切换、菜单按钮改为太阳/月亮、汉堡/关闭图标,随状态切换
- 下拉箭头由文字符号改为 SVG,下拉项配产品图标;GitHub 加外链图标
- 品牌名前加分层标志,与首页插画呼应

实现
- 20 余个线条图标画成一个 SVG sprite,由 sync_docs_chrome.py 统一注入,
  用 currentColor 与 token 上色,深浅主题自动适配
- check_docs_html 新增:<use href="#i-..."> 必须在 sprite 里有对应 symbol
- 流程图用 HTML + CSS 画,窄屏自动竖排,文字保持真实字号

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdLheqvbhbobVxS1NvgLpw
@JiTianYu391
JiTianYu391 merged commit 46155d4 into master Nov 7, 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