diff --git a/README.md b/README.md index 26b7cf7..3b73ca8 100644 --- a/README.md +++ b/README.md @@ -31,13 +31,13 @@ npm run dev - Astro Content Collections - Markdown 内容 - 原生 CSS -- 原生 JavaScript 主题切换与移动导航 +- 原生 JavaScript 主题切换、移动导航、轮播分页和阅读位置恢复 页面层不依赖 React、用户系统或客户端状态框架。 ```text src/ -├── components/ # 页头、页脚、页面导语和视觉组件 +├── components/ # 站点、通用界面和内容交互组件 ├── content/ │ ├── docs/ # 系列文档与章节 │ ├── interviews/ # 访谈正文与元数据 @@ -50,7 +50,7 @@ src/ │ ├── news/ # 动态目录与文章详情路由 │ ├── about.astro │ └── index.astro -└── styles/global.css # 完整视觉系统和响应式规则 +└── styles/ # 模块化视觉系统与集中响应式规则 ``` ## 内容约定 @@ -59,6 +59,7 @@ src/ - 访谈位于 `src/content/interviews/`,单篇 Markdown 对应一个详情页。 - 三类内容统一公开日期和阅读时间,并通过 `tone: light | mid | dark` 配置单篇视觉色调;文档、访谈和动态均可将任意多篇内容设置为 `featured: true`,集合页会将它们组成精选展板,未指定时自动突出一篇内容。 - 精选展板是否自动翻页及翻页间隔统一在 `src/data/site.ts` 的 `featuredCarouselConfig` 中按栏目配置。 +- 三个集合页共享阅读返回状态:从列表进入详情后,返回按钮会恢复原分页和滚动位置。 - 访谈使用 `affiliation` 记录系所;设置 `anonymous: true` 时隐藏姓名,未提供系所则显示“系所信息保密”。 - 内容字段由 `src/content.config.ts` 校验。 - 默认语言为简体中文;当前不配置多语言路由。 diff --git a/docs/components.md b/docs/components.md index f06ee11..8577760 100644 --- a/docs/components.md +++ b/docs/components.md @@ -15,6 +15,8 @@ GeoGenesis 的几何站点标记。它没有 Props,颜色继承父元素,可 - `overlay?: boolean`:让页头覆盖在首页等深色 Hero 上。 - 导航数据来自 `src/data/site.ts`,不要在组件内重复维护。 - 主题选择保存到 `localStorage`。 +- 窄屏导航使用全屏抽屉;打开时锁定页面滚动并通过 `inert` 隔离背景内容,点击链接、遮罩或按下 Escape 均会关闭。 +- 菜单按钮同步维护 `aria-expanded`,抽屉开关不依赖前端框架。 ### `SiteFooter.astro` @@ -44,6 +46,15 @@ GeoGenesis 的几何站点标记。它没有 Props,颜色继承父元素,可 - `primaryDatetime?: Date`:存在时将日期渲染为语义化 `