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-core、fumadocs-ui和fumadocs-mdx。 -
工具假设项目采用标准的
app/、content/和lib/目录结构,若使用自定义结构,请预先确认路径。 -
完美契合 Next.js App Router 模式,充分利用服务器组件和动态路由能力。
-
内置针对侧边栏显示所有语言、路由错误及解析器配置不当等常见问题的修复逻辑。
-
建议在独立的 Git 分支中执行此技能,以便于查看文件变动并确保项目安全性。
仓库统计
- Star 数
- 10
- Fork 数
- 1
- Open Issue 数
- 0
- 主要语言
- MDX
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月3日 20:48