Skip to content

feat: 新增官网的框架与首页 - #92

Merged
rakuyoMo merged 1 commit into
mainfrom
feature/rakuyo/website-home
Nov 20, 2026
Merged

rakuyoMo merged 1 commit into
mainfrom
feature/rakuyo/website-home

Conversation

@rakuyoMo

Copy link
Copy Markdown
Owner

新增官网:website/ 下用 Astro 与 Starlight 搭的站点,这次带来整站的框架与首页。手册的 40 页先只有标题与简介,正文、截图与其余语言的翻译由后续的 PR 补上。

改动

  • 站点框架
    • 8 种语言:访问根路径时按浏览器的语言跳转,手动选过的语言会记住
    • 浅色与深色两种外观:默认跟着系统,页头的按钮切换
    • 首页与 404 页的页头只有站名、GitHub、外观与语言,页脚是一行链接与版权;手册页另有搜索、分 10 组的侧边栏与上一页 / 下一页
  • 与 App 的衔接
    • 页面里的界面叫法按资源键取自 Localizable.strings(:ui[…] 与 UiLabel),官网用到的资源键改名或删除时构建失败
    • 截图按名字引用(::screenshot),每个画面要有 8 种语言 × 2 种外观,缺一张构建就失败;截图存进 Git LFS,这次只带首页用到的四个画面
    • 首页与 404 页上的应用图标、Mac、服务器与幽灵,构建时由 scripts/make-icon/ 的绘制脚本画成 SVG
  • 首页
    • 主视觉下面是一扇能操作的演示窗口,可以暂存、提交与推送;文字与颜色取自 App 的资源
    • 服务器仓库的示意图与要点、几段配截图的功能介绍、收尾
    • 一只小幽灵跟着滚动走完全页:从顶部图标的机架身后飘出来,停在演示窗口边、示意图的服务器身前与冲突向导旁那台服务器投出的光里,最后摘到樱桃、落在收尾的标语上方;脚本没有运行或系统开了 “减弱动态效果” 时页面是静止的
  • 工程
    • mise run website:dev 与 mise run website:build:后者按锁文件安装依赖,运行自测,检查类型与站内链接,再构建;Node 只为这两个 task 安装
    • website.yml:PR 上只构建,推送到 main 后发布到 GitHub Pages
    • README 与 AGENTS.md 补上官网的构建方式与写页面的约定

验证

  • mise run website:build 通过:自测 33 条,类型检查 0 错误,329 页,站内链接全部有效
  • 无头的 Chrome 与 WebKit 里核对了 66 项:按浏览器语言跳转与记住所选的语言,外观跟着系统、手动切换与记住,截图只下载当前外观的一张、放大与关闭,全程只向本站发请求
  • 小幽灵这一路:关掉脚本与开着 “减弱动态效果” 时页面静止;途中切换外观位置不跳;示意图那一站的灯、影子与叠放次序在宽 1440、820 与 390 的视口下都对
  • 15 种视口(320 × 568 到 2560 × 1300)× 英文与简体中文各排了一遍路线:飘着的幽灵没有压在正文后面

未验证

  • 桌面版 Safari、真机上的 iPhone 与 VoiceOver
  • website.yml 的 “发布” 一步

注意

  • 仓库还没有启用 GitHub Pages:合并后 main 上的 “发布” 一步会失败;启用(Source 选 GitHub Actions)之后才上线,上线时手册各页还只有标题
  • 首页的正文只有英文与简体中文两份,其余 6 种语言暂时显示英文
  • 下载按钮指向 GitHub Releases
  • 克隆之前先装好 Git LFS 才能取到截图

@rakuyoMo
rakuyoMo merged commit a178270 into main Nov 20, 2026
6 checks passed
@rakuyoMo
rakuyoMo deleted the feature/rakuyo/website-home branch November 20, 2026 01:01
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.

1 participant