Docusaurus无法识别已翻译Markdown文件问题求助
问题排查与解决
这是你的配置问题,不是Docusaurus的bug,按以下步骤检查修复:
1. 修正baseUrl配置
打开docusaurus.config.js,确认baseUrl设置是否正确:
- 你的本地访问URL出现
/website/,说明baseUrl被配置成了'/website/',但实际你的项目根目录就是website文件夹,Docusaurus启动时会以此为根路径,所以baseUrl应该设为'/'。 - 错误的
baseUrl会导致语言切换时路径拼接异常,进而出现重复追加语言代码de的问题。
2. 验证i18n文档配置
在docusaurus.config.js的i18n字段下,确保docusaurus-plugin-content-docs的本地化配置正确启用:
i18n: { defaultLocale: 'en', locales: ['en', 'de'], localeConfigs: { en: { label: 'English' }, de: { label: 'Deutsch' }, }, },
无需额外修改docs插件的路径配置,保持默认即可让Docusaurus自动读取i18n/下的本地化文档。
3. 清理缓存重启服务
执行以下命令清理缓存并重新启动开发服务,避免缓存残留导致路由生成异常:
npm run clear npm run start
内容的提问来源于stack exchange,提问作者Sven
相关产品推荐
相关产品推荐

