项目结构
代码库地图——路由、组件、内容和配置分别位于何处。
应用遵循 Next.js App Router 的布局,在开始添加功能前,有几条约定值得了解。
目录布局
src/
app/ App Router 路由 —— [locale] 为语言地址化页面,
dash 为 Dashboard 根路由,以及元数据路由
components/ 共享的、应用本地的展示组件
lib/ i18n、metadata、工具函数,以及 fumadocs source 加载器与类型
env.ts 经校验的环境变量 schema
content/ 文件夹所属的 MDX 条目及其图片
public/ 不属于内容的静态资源路由
语言地址化页面位于 src/app/[locale] 之下并被静态生成。营销类页面(首页、博客、法律、作者)在 (marketing) 路由组中共享一个布局;文档区则自带 fumadocs 外壳。
Dashboard 是一个以 /dash 为根的独立语言中立路由族。所有语言共用这个稳定路径;用户的语言偏好决定界面译文。/zh/dash 等带语言前缀的形式均无效。
内容
文档、博客文章、法律页面和作者都是 content/ 下的 MDX 文件,通过 fumadocs 加载。添加一个文件,它就会出现——无需注册步骤:
content/blog/my-post/index.mdx → /blog/my-post
content/docs/my-page/index.mdx → /docs/my-page
content/legal/privacy/index.mdx → /legal/privacy国际化与 SEO
语言路由、规范链接以及 hreflang/JSON-LD 的接线都已就绪——参见指南了解它们如何协同工作。