系统架构
架构概览
cssadoc 是典型的 静态站点生成（SSG） 架构：构建阶段将 Markdown/MDX 编译为 HTML，运行时由 CDN / Workers 直接提供静态资源。
请求路径
| 路径 | 来源 | 说明 |
|---|---|---|
/ | src/pages/index.tsx | 自定义首页 |
/docs/* | docs/ + sidebars.ts | 主文档区 |
/blog/* | blog/ | 博客文章 |
| 静态资源 | static/ | Logo、图片等 |
配置与路由关系
- 路由：Docusaurus 根据
docs/文件路径自动生成 URL（如docs/systems/cssagpt/index.md→/docs/systems/cssagpt/） - 导航：
sidebars.ts手动定义侧边栏顺序与分组，可与文件目录不完全一致 - i18n：
i18n/下各 locale 覆盖部分页面翻译
数据流特点
- 无后端 API：站点不连接数据库或业务接口
- 构建时渲染：搜索、侧边栏、目录均在构建阶段生成
- 客户端增强：主题切换、版本切换、语言切换由 React 客户端处理