尧图网站建设 
Beekeeper Studio 多语言支持完全指南用 mkdocs i18n 搭建 10 种语言的数据库文档【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studioBeekeeper Studio 是一款支持 MySQL、Postgres、SQLite 的跨平台 SQL 客户端界面目前仍是全英文但官方文档已经提供西班牙语、日语等 10 种语言版本。本文基于仓库里的真实配置讲清这套多语言文档站是怎么搭的以及如何给新语言添加页面。 多语言功能定位哪些部分翻译了哪些没有Beekeeper Studio 的多语言支持目前落在文档层。在仓库根目录的 mkdocs.yml 中mkdocs-static-i18n 插件声明了 10 个目标语言英语、西班牙语、巴西葡萄牙语、德语、法语、希腊语、日语、意大利语、韩语、印尼语。其中英语是默认语言西班牙语是唯一完整构建的语言——docs/ 目录下有大量与英文页一一配对的 .es.md 文件例如 docs/index.es.md。其余 8 种语言是预留位等待翻译补齐。这套机制面向两类人一类是想用母语读文档的非英语用户另一类是文档维护者和社区贡献者。应用界面本身连接面板、查询编辑器、表视图尚未本地化如果你在设置里找不到语言选项这是当前版本的正常表现不是配置错误。⚡ 快速上手切换语言与新增语言的配置方法读文档的用户只需两步打开官方文档站用右上角的语言切换器选择语言没有翻译的页面会自动回退到英文版不会 404。想确认某个语言覆盖了多少内容去仓库找对应的带语言后缀文件如 .es.md即可。维护者想新增一种语言三步完成在 mkdocs.yml 的 plugins i18n languages 下新增一个 locale 条目把该条目的 build: true 打开否则构建时不会生成该语言页面按后缀规则创建对应文件如 index.zh.md先翻几个页面其余靠回退机制兜底。核心配置只有这几行- i18n: docs_structure: suffix fallback_to_default: true reconfigure_search: true languages: - locale: en default: true build: true 原理通俗版suffix 后缀是怎么切分多语言页面的把这套机制理解成按后缀切文件。插件配了 docs_structure: suffix意味着 index.md 是英文版index.es.md 是西班牙语版未来 index.ja.md 就是日语版。构建时每种语言生成独立站点语言切换器只是在不同语言版本的同一页面之间跳转文档结构永远只有一份。关键开关是 fallback_to_default: true某页缺少翻译时直接显示英文版不需要等所有页面翻完才能上线新语言——这正是 8 种未翻译语言也能出现在配置里的原因。reconfigure_search: true 则让搜索索引按语言重建用西班牙语搜出来的结果是西班牙语页面而不是和英文混在一起。 进阶技巧这份配置里值得借鉴的 3 个细节技巧 1先翻导航再翻正文。西班牙语条目里有一组 nav_translations把 Introduction、Installation 等导航标签逐条翻译成目标语言。适用场景正文还没翻完时先让导航和站点名site_name、site_description本地化用户第一眼看到的就是目标语言翻译可以渐进推进。技巧 2一份英文原文不按语言复制结构。仓库里每个页面只有一个 .md 文件各语言共享同一套文件结构英文更新后只需核对各语言版是否需要同步。适用场景文档团队小、想压低多语言维护成本。技巧 3配置项文档直接引用代码库。ini-includer 插件把 apps/studio/default.config.ini 原样读进配置文档配置键名始终和代码一致。翻译时只需处理描述文字键名不用动也不会过期。适用场景文档里含大量随代码变动的配置项。⚠️ 避坑指南常见困惑与排查清单困惑 1应用界面里找不到语言设置项。界面没有本地化apps/studio/default.config.ini 里也没有界面语言配置项。看到设置界面语言之类的说法时先确认不是当前版本的功能。困惑 2新增语言后构建没有页面。排查顺序先确认该语言条目有 build: true再核对 locale 拼写和文件后缀是否严格一致——写 pt-BR文件就必须是 index.pt-BR.md写成 index.ptbr.md 不会被识别。困惑 3想打开 Material 主题的 instant 导航但无效。mkdocs.yml 里有一行注释navigation.instant - broken with i18n。即时导航和 i18n 插件存在冲突所以被主动关掉这是保留多语言功能的取舍不建议强行打开。想参与翻译的话把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/be/beekeeper-studio新建分支翻译后提交流程即可参照仓库内 CLAUDE.md 中Add the locale to mkdocs.yml一节的操作说明。Beekeeper Studio 的多语言支持集中在文档英语、西语可用8 种语言预留机制就是后缀切分 默认回退 按语言搜索三个开关。想动手的最快路径是打开 docs/getting-started-guide.es.md 看西语版写法然后在 mkdocs.yml 里加上你的 locale 条目。【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Beekeeper Studio 多语言支持完全指南：用 mkdocs i18n 搭建 10 种语言的数据库文档
Beekeeper Studio 多语言支持完全指南用 mkdocs i18n 搭建 10 种语言的数据库文档【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studioBeekeeper Studio 是一款支持 MySQL、Postgres、SQLite 的跨平台 SQL 客户端界面目前仍是全英文但官方文档已经提供西班牙语、日语等 10 种语言版本。本文基于仓库里的真实配置讲清这套多语言文档站是怎么搭的以及如何给新语言添加页面。 多语言功能定位哪些部分翻译了哪些没有Beekeeper Studio 的多语言支持目前落在文档层。在仓库根目录的 mkdocs.yml 中mkdocs-static-i18n 插件声明了 10 个目标语言英语、西班牙语、巴西葡萄牙语、德语、法语、希腊语、日语、意大利语、韩语、印尼语。其中英语是默认语言西班牙语是唯一完整构建的语言——docs/ 目录下有大量与英文页一一配对的 .es.md 文件例如 docs/index.es.md。其余 8 种语言是预留位等待翻译补齐。这套机制面向两类人一类是想用母语读文档的非英语用户另一类是文档维护者和社区贡献者。应用界面本身连接面板、查询编辑器、表视图尚未本地化如果你在设置里找不到语言选项这是当前版本的正常表现不是配置错误。⚡ 快速上手切换语言与新增语言的配置方法读文档的用户只需两步打开官方文档站用右上角的语言切换器选择语言没有翻译的页面会自动回退到英文版不会 404。想确认某个语言覆盖了多少内容去仓库找对应的带语言后缀文件如 .es.md即可。维护者想新增一种语言三步完成在 mkdocs.yml 的 plugins i18n languages 下新增一个 locale 条目把该条目的 build: true 打开否则构建时不会生成该语言页面按后缀规则创建对应文件如 index.zh.md先翻几个页面其余靠回退机制兜底。核心配置只有这几行- i18n: docs_structure: suffix fallback_to_default: true reconfigure_search: true languages: - locale: en default: true build: true 原理通俗版suffix 后缀是怎么切分多语言页面的把这套机制理解成按后缀切文件。插件配了 docs_structure: suffix意味着 index.md 是英文版index.es.md 是西班牙语版未来 index.ja.md 就是日语版。构建时每种语言生成独立站点语言切换器只是在不同语言版本的同一页面之间跳转文档结构永远只有一份。关键开关是 fallback_to_default: true某页缺少翻译时直接显示英文版不需要等所有页面翻完才能上线新语言——这正是 8 种未翻译语言也能出现在配置里的原因。reconfigure_search: true 则让搜索索引按语言重建用西班牙语搜出来的结果是西班牙语页面而不是和英文混在一起。 进阶技巧这份配置里值得借鉴的 3 个细节技巧 1先翻导航再翻正文。西班牙语条目里有一组 nav_translations把 Introduction、Installation 等导航标签逐条翻译成目标语言。适用场景正文还没翻完时先让导航和站点名site_name、site_description本地化用户第一眼看到的就是目标语言翻译可以渐进推进。技巧 2一份英文原文不按语言复制结构。仓库里每个页面只有一个 .md 文件各语言共享同一套文件结构英文更新后只需核对各语言版是否需要同步。适用场景文档团队小、想压低多语言维护成本。技巧 3配置项文档直接引用代码库。ini-includer 插件把 apps/studio/default.config.ini 原样读进配置文档配置键名始终和代码一致。翻译时只需处理描述文字键名不用动也不会过期。适用场景文档里含大量随代码变动的配置项。⚠️ 避坑指南常见困惑与排查清单困惑 1应用界面里找不到语言设置项。界面没有本地化apps/studio/default.config.ini 里也没有界面语言配置项。看到设置界面语言之类的说法时先确认不是当前版本的功能。困惑 2新增语言后构建没有页面。排查顺序先确认该语言条目有 build: true再核对 locale 拼写和文件后缀是否严格一致——写 pt-BR文件就必须是 index.pt-BR.md写成 index.ptbr.md 不会被识别。困惑 3想打开 Material 主题的 instant 导航但无效。mkdocs.yml 里有一行注释navigation.instant - broken with i18n。即时导航和 i18n 插件存在冲突所以被主动关掉这是保留多语言功能的取舍不建议强行打开。想参与翻译的话把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/be/beekeeper-studio新建分支翻译后提交流程即可参照仓库内 CLAUDE.md 中Add the locale to mkdocs.yml一节的操作说明。Beekeeper Studio 的多语言支持集中在文档英语、西语可用8 种语言预留机制就是后缀切分 默认回退 按语言搜索三个开关。想动手的最快路径是打开 docs/getting-started-guide.es.md 看西语版写法然后在 mkdocs.yml 里加上你的 locale 条目。【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考