尧图网站建设 
Beekeeper Studio 多语言支持读懂 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-studio上周一位说西班牙语的同事照着 Beekeeper Studio 的官方文档配置备份卡了二十分钟他打开的是西班牙语版页面左侧菜单却还是英文他只能在两个标签页之间来回对照。我去翻了翻这个项目的多语言机制发现它做得比想象中讲究——但也有一些容易踩的坑。先把范围说清楚多语言覆盖的是文档和 README 先给结论免得你有错误预期应用界面本身目前仍是英文Beekeeper Studio 的多语言支持集中在官方文档站和仓库 README 上。它目前能帮你做的事文档站提供 10 种语言英语默认、西班牙语、巴西葡语、德语、法语、希腊语、日语、意大利语、韩语、印尼语翻译文件和英文原文放在同一目录靠后缀区分一眼能找到对应关系某页没翻译完时自动回退到英文版不会出现空白页或 404每种语言的导航菜单可以独立翻译不用跟着正文走仓库根目录有 10 个语言的 README 译文de、el、es、fr、id、it、ja、ko、sw、pt-BR克隆下来就能用母语读项目介绍它是怎么做到的三个你值得知道的机制后缀命名翻译就是旁边放一个副本打开 docs 目录 看文件命名就明白了。英文原文是security.md西班牙语版就叫security.es.md巴西葡语是security.pt-BR.md。翻译文件与原文同目录存放不单独建locales/之类的目录。这个设计的直接好处是改原文时对应的翻译文件就躺在旁边评审 PR 时上下文一目了然不用在两个目录间跳。回退机制没翻完也不露怯mkdocs.yml 里的 i18n 插件配置有一行关键配置- i18n: docs_structure: suffix fallback_to_default: true reconfigure_search: true languages: - locale: en default: true build: true - locale: es name: Espanol build: truefallback_to_default: true意味着西班牙语版下凡是还没有.es.md的页面构建时直接填上英文内容。所以 10 种语言都能完整构建翻译进度不影响可用性只影响你看到的是母语还是英文。菜单翻译是单独一层正文翻完了导航菜单还是英文——这是很多人第一次贡献翻译时碰到的问题。原因是菜单不走正文而是走每语言独立的nav_translations映射在 CLAUDE.md 的翻译指南 里有明确说明- locale: es name: Espanol nav_translations: Introduction: Introduccion Features: Caracteristicas不填这一段菜单就保持英文。这是两个独立的翻译层互不继承。从第一次打开到参与翻译三步递进第一次使用选语言或直接走子路径你不需要改任何配置文件。在线文档站右上角的语言选择器里选你需要的语言即可也可以直接访问对应语言的子路径。想本地预览整站克隆仓库后在 studio 目录跑mkdocs serve翻译指南 里就是这么写的。日常使用顺着母语页面读遇到英文就等一等日常场景很简单按母语浏览。比如西班牙语的配置文档在 docs/user_guide/configuration.es.md。发现某页自动变成了英文不用纠结那就是还没人翻回退机制在工作。进阶自己加一种语言或补一页翻译补一页翻译的流程是固定的照 CLAUDE.md 里的Documentation Translation Guidelines走复制英文文件改后缀security.md→security.zh.md或你要的语言翻译 frontmatter 的title/summary、正文、图片 alt 文本、提示框标题有几样东西不要翻文件路径、URL、代码块、SQL/plugin 这类通用术语、产品名新增一门语言则是三步在 mkdocs.yml 的i18n languages下加 locale 条目含site_name、site_description、nav_translations然后在 docs 里逐个建.{locale}.md。仓库可以这样克隆git clone https://gitcode.com/GitHub_Trending/be/beekeeper-studio几个高频坑直接给排查路径切了语言为什么有些页面还是英文不是 bug是回退机制。该页没有对应.es.md或其他后缀文件。三步确认在 docs 下搜该页的英文文件名 → 确认没有同前缀的.你的语言.md→ 要么等社区要么自己翻。正文都翻了菜单怎么还是英文菜单翻译独立不随正文生效。三步修复打开 mkdocs.yml → 找到对应 locale 的nav_translations→ 把缺的菜单项补上mkdocs serve刷新验证。我按系统语言切了西班牙语应用界面为什么没变现象正常当前版本应用 UI 未做国际化多语言覆盖的是文档和 README界面上没有语言切换入口。别去配置文件里找语言项找不到是对的。本地改了翻译构建后不生效九成是命名。后缀必须是.{locale}.md且 locale 要和 mkdocs.yml 里声明的完全一致pt-BR的大小写也敏感。对照 mkdocs.yml 的 languages 列表核一遍。接下来会发生什么只说仓库里能验证的事mkdocs.yml 已声明 10 个语言目标且都标记build: true其中 de、fr、el、ja、it、ko、id 的正文翻译文件尚不完整补齐后即随构建生效——缺哪页翻哪页门槛是一页一个文件README 译文已有 10 个版本README-es.md、README-de、README-fr、README-ja、README-ko、README-it、README-el、README-id、README-sw、README.pt-br说明社区持续供稿这条路径是活的翻译规范沉淀在 CLAUDE.md 中包括哪些不翻、如何新增语言新贡献者不用猜规则回到开头那位同事他卡在菜单和正文不同步本质是翻译进度不均加上回退机制的副作用。现在你可以做两件事按母语把 官方文档 完整读一遍遇到回退成英文的页面直接翻掉提交或者缺什么页面就提一个 Issue 标清楚。翻译一页文档比背下整套备份流程快多了。【免费下载链接】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 多语言支持：读懂 10 种语言文档，并贡献你的第一个翻译
Beekeeper Studio 多语言支持读懂 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-studio上周一位说西班牙语的同事照着 Beekeeper Studio 的官方文档配置备份卡了二十分钟他打开的是西班牙语版页面左侧菜单却还是英文他只能在两个标签页之间来回对照。我去翻了翻这个项目的多语言机制发现它做得比想象中讲究——但也有一些容易踩的坑。先把范围说清楚多语言覆盖的是文档和 README 先给结论免得你有错误预期应用界面本身目前仍是英文Beekeeper Studio 的多语言支持集中在官方文档站和仓库 README 上。它目前能帮你做的事文档站提供 10 种语言英语默认、西班牙语、巴西葡语、德语、法语、希腊语、日语、意大利语、韩语、印尼语翻译文件和英文原文放在同一目录靠后缀区分一眼能找到对应关系某页没翻译完时自动回退到英文版不会出现空白页或 404每种语言的导航菜单可以独立翻译不用跟着正文走仓库根目录有 10 个语言的 README 译文de、el、es、fr、id、it、ja、ko、sw、pt-BR克隆下来就能用母语读项目介绍它是怎么做到的三个你值得知道的机制后缀命名翻译就是旁边放一个副本打开 docs 目录 看文件命名就明白了。英文原文是security.md西班牙语版就叫security.es.md巴西葡语是security.pt-BR.md。翻译文件与原文同目录存放不单独建locales/之类的目录。这个设计的直接好处是改原文时对应的翻译文件就躺在旁边评审 PR 时上下文一目了然不用在两个目录间跳。回退机制没翻完也不露怯mkdocs.yml 里的 i18n 插件配置有一行关键配置- i18n: docs_structure: suffix fallback_to_default: true reconfigure_search: true languages: - locale: en default: true build: true - locale: es name: Espanol build: truefallback_to_default: true意味着西班牙语版下凡是还没有.es.md的页面构建时直接填上英文内容。所以 10 种语言都能完整构建翻译进度不影响可用性只影响你看到的是母语还是英文。菜单翻译是单独一层正文翻完了导航菜单还是英文——这是很多人第一次贡献翻译时碰到的问题。原因是菜单不走正文而是走每语言独立的nav_translations映射在 CLAUDE.md 的翻译指南 里有明确说明- locale: es name: Espanol nav_translations: Introduction: Introduccion Features: Caracteristicas不填这一段菜单就保持英文。这是两个独立的翻译层互不继承。从第一次打开到参与翻译三步递进第一次使用选语言或直接走子路径你不需要改任何配置文件。在线文档站右上角的语言选择器里选你需要的语言即可也可以直接访问对应语言的子路径。想本地预览整站克隆仓库后在 studio 目录跑mkdocs serve翻译指南 里就是这么写的。日常使用顺着母语页面读遇到英文就等一等日常场景很简单按母语浏览。比如西班牙语的配置文档在 docs/user_guide/configuration.es.md。发现某页自动变成了英文不用纠结那就是还没人翻回退机制在工作。进阶自己加一种语言或补一页翻译补一页翻译的流程是固定的照 CLAUDE.md 里的Documentation Translation Guidelines走复制英文文件改后缀security.md→security.zh.md或你要的语言翻译 frontmatter 的title/summary、正文、图片 alt 文本、提示框标题有几样东西不要翻文件路径、URL、代码块、SQL/plugin 这类通用术语、产品名新增一门语言则是三步在 mkdocs.yml 的i18n languages下加 locale 条目含site_name、site_description、nav_translations然后在 docs 里逐个建.{locale}.md。仓库可以这样克隆git clone https://gitcode.com/GitHub_Trending/be/beekeeper-studio几个高频坑直接给排查路径切了语言为什么有些页面还是英文不是 bug是回退机制。该页没有对应.es.md或其他后缀文件。三步确认在 docs 下搜该页的英文文件名 → 确认没有同前缀的.你的语言.md→ 要么等社区要么自己翻。正文都翻了菜单怎么还是英文菜单翻译独立不随正文生效。三步修复打开 mkdocs.yml → 找到对应 locale 的nav_translations→ 把缺的菜单项补上mkdocs serve刷新验证。我按系统语言切了西班牙语应用界面为什么没变现象正常当前版本应用 UI 未做国际化多语言覆盖的是文档和 README界面上没有语言切换入口。别去配置文件里找语言项找不到是对的。本地改了翻译构建后不生效九成是命名。后缀必须是.{locale}.md且 locale 要和 mkdocs.yml 里声明的完全一致pt-BR的大小写也敏感。对照 mkdocs.yml 的 languages 列表核一遍。接下来会发生什么只说仓库里能验证的事mkdocs.yml 已声明 10 个语言目标且都标记build: true其中 de、fr、el、ja、it、ko、id 的正文翻译文件尚不完整补齐后即随构建生效——缺哪页翻哪页门槛是一页一个文件README 译文已有 10 个版本README-es.md、README-de、README-fr、README-ja、README-ko、README-it、README-el、README-id、README-sw、README.pt-br说明社区持续供稿这条路径是活的翻译规范沉淀在 CLAUDE.md 中包括哪些不翻、如何新增语言新贡献者不用猜规则回到开头那位同事他卡在菜单和正文不同步本质是翻译进度不均加上回退机制的副作用。现在你可以做两件事按母语把 官方文档 完整读一遍遇到回退成英文的页面直接翻掉提交或者缺什么页面就提一个 Issue 标清楚。翻译一页文档比背下整套备份流程快多了。【免费下载链接】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），仅供参考