网站结构
理解 StarmoAI 的页面、组件、内容与静态资源如何协作。
页面与路由
src/pages/ 决定公开访问地址。首页、项目、日记、文档、资源和关于页面都应保持清晰、稳定的路径。
顶部导航
主导航按“项目、日记、文档、资源、关于”的顺序展示。音乐播放器仍可从首页的主要入口进入,但不会挤占文档型主导航。
内容详情页
日记、项目和文档详情由内容集合生成。新增 Markdown 文件后,构建阶段会自动生成对应静态页面。
组件职责
公共导航、页脚、文章正文和侧栏都应拆成独立组件。页面文件负责组合,不重复复制公共结构。
共享样式
颜色、字号、间距和圆角集中在设计令牌中维护。页面可以有不同氛围,但不应重新发明一套排版标准。
静态资源
图片、音频和不需要构建处理的文件放在 public/。所有路径使用站点根目录相对地址,确保本地预览与服务器环境一致。