Template

项目结构

代码库地图——路由、组件、内容和配置分别位于何处。

应用遵循 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 的接线都已就绪——参见指南了解它们如何协同工作。

On this page