工程开发
fumadocs-i18n avatar

fumadocs-i18n

自动化配置 Fumadocs 的国际化 (i18n)。实现 Next.js 多语言路由、语言切换器、侧边栏过滤及文档目录组织。

简介

fumadocs-i18n 是一款专业的自动化工具,旨在将标准的 Fumadocs 项目转换为生产级的多语言文档站点。该技能严格遵循官方最佳实践,处理在 Next.js App Router 环境下支持全球化访问所需的复杂结构调整,确保您的内容既具备良好的 SEO 性能,又易于维护。

该工具专为需要为文档添加、扩展或重构为多种语言(如英语、中文、法语或韩语)的开发者而设计。它极大地减少了手动调整路由逻辑、目录模式和 UI 组件所需的繁琐工作,让您可以专注于内容翻译而非繁琐的基础架构配置。

  • 自动创建 lib/i18n.ts 配置文件,定义支持的语言及目录解析规则。

  • 配置 middleware.ts 以管理自动语言重定向及基于路径的语言检测。

  • 重构 app/ 目录结构,将路由移动至 [lang] 动态片段中,从而生成如 /en/docs/ 等语义化的 URL。

  • 集成功能完善的语言切换器,直接嵌入现有的导航栏 UI 中。

  • 规范内容组织,自动构建 content/docs/[lang] 目录体系并更新 source.ts 以支持各语言独立的页面树。

  • 实现侧边栏按语言过滤,确保用户只能浏览与当前语言上下文相关的内容。

  • 在运行前,请确保项目已成功初始化 fumadocs-corefumadocs-uifumadocs-mdx

  • 工具假设项目采用标准的 app/content/lib/ 目录结构,若使用自定义结构,请预先确认路径。

  • 完美契合 Next.js App Router 模式,充分利用服务器组件和动态路由能力。

  • 内置针对侧边栏显示所有语言、路由错误及解析器配置不当等常见问题的修复逻辑。

  • 建议在独立的 Git 分支中执行此技能,以便于查看文件变动并确保项目安全性。

仓库统计

Star 数
10
Fork 数
1
Open Issue 数
0
主要语言
MDX
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 20:48
在 GitHub 查看