2025/03/15
国际化
在您的文档中支持多种语言
开始之前
Fumadocs 不是一个功能齐全的 i18n 库，它只管理自己的组件和工具。
您可以使用其他库，如 next-intl，用于应用程序的其余部分。 阅读 Next.js 文档，了解更多关于在 Next.js 中实现 I18n 的信息。
手动设置
在一个文件中定义 i18n 配置，我们将在本指南中使用 @/ilb/i18n 导入它。
将其传递给源加载器。
在您的文档中支持多种语言
开始之前
Fumadocs 不是一个功能齐全的 i18n 库，它只管理自己的组件和工具。
您可以使用其他库，如 next-intl，用于应用程序的其余部分。 阅读 Next.js 文档，了解更多关于在 Next.js 中实现 I18n 的信息。
在一个文件中定义 i18n 配置，我们将在本指南中使用 @/ilb/i18n 导入它。
将其传递给源加载器。
import { i18n } from '@/lib/i18n';
import { loader } from 'fumadocs-core/source';
export const source = loader({
i18n,
// other options
});并更新 Fumadocs UI 布局选项。
import { i18n }
创建一个将用户重定向到适当语言环境的中间件。
{
"file": "../../examples/i18n/middleware.ts",
"codeblock": {
"lang": "ts",
"meta": "title=\"middleware.ts\""
}
}查看中间件了解可自定义选项。
请注意，这是可选的，您也可以使用自己的中间件或 i18n 库提供的中间件。
创建一个 /app/[lang] 文件夹，并将所有文件（例如 page.tsx、layout.tsx）从 /app 移动到该文件夹。
将根提供程序包装在 I18nProvider 中，并向其提供可用语言和翻译。
请注意，默认情况下只提供英文翻译。
import { RootProvider }
在您的页面和布局中将区域设置传递给 Fumadocs。
在您的搜索解决方案上配置 i18n。
Fumadocs 只处理其自己的布局（例如侧边栏）的导航。
对于其他地方，您可以使用 useParams 钩子从 url 获取区域设置，并将其添加到 href。
import Link
另外，fumadocs-core/dynamic-link 组件支持动态 hrefs，您可以使用它来添加区域设置前缀。
这对于 Markdown/MDX 内容很有用。
import { DynamicLink } from 'fumadocs-core/dynamic-link';
<DynamicLink href="/[lang]/another-page">This is a link</DynamicLink>加入我们的社区
订阅邮件列表，及时获取最新消息和更新
