网站结构

网站结构

理解 StarmoAI 的页面、组件、内容与静态资源如何协作。

页面与路由

src/pages/ 决定公开访问地址。首页、项目、日记、文档、资源和关于页面都应保持清晰、稳定的路径。

顶部导航

主导航按“项目、日记、文档、资源、关于”的顺序展示。音乐播放器仍可从首页的主要入口进入,但不会挤占文档型主导航。

内容详情页

日记、项目和文档详情由内容集合生成。新增 Markdown 文件后,构建阶段会自动生成对应静态页面。

组件职责

公共导航、页脚、文章正文和侧栏都应拆成独立组件。页面文件负责组合,不重复复制公共结构。

共享样式

颜色、字号、间距和圆角集中在设计令牌中维护。页面可以有不同氛围,但不应重新发明一套排版标准。

静态资源

图片、音频和不需要构建处理的文件放在 public/。所有路径使用站点根目录相对地址,确保本地预览与服务器环境一致。