XPipe 多语言界面切换中文设置与翻译机制【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe这篇文章解决两个问题如何把 XPipe 的界面从英文切换成中文以及它的多语言翻译系统背后如何运作让你能判断界面里偶尔出现的英文是设置问题还是翻译没跟上。XPipe 是一款在本地桌面上管理整套服务器基础设施的工具内置 18 种语言包含简体中文与繁体中文。本文覆盖翻译文件的结构、语言配置入口、切换后的影响范围以及你可以自行扩展的边界。翻译文件在哪里XPipe 的界面文本全部放在lang/目录下分两层lang/strings/存放短字符串菜单、按钮、设置项标签。每种语言一个.properties文件简体中文对应 translations_zh-Hans.properties全文 2800 多行。lang/texts/存放较长的说明文档用 Markdown 格式例如 Termius、Xshell 连接导入功能的中文引导说明。翻译的生产流程是三步以英文为基准用 DeepL 自动翻译再由人工校对。新增字符串先写英文自动翻译到各语言社区贡献者只负责修正个别错译。这种分工让翻译文件能跟上功能迭代的速度。各语言的校对状态也记录在 lang/README.md 中并标注对应版本号方便判断某语言校对到了哪一版。语言配置入口在哪里应用内切换语言的位置在设置面板的个性化Personalization分类里其中的语言下拉框就是配置项选择后新语言立即生效不需要重启。首次启动的初始设置窗口里也提供了同一个选项。下拉框旁的说明文字来源就是简体中文文件里的这两条language语言 languageDescription设置界面语言第一条是选项标签第二条是下拉框旁显示的说明。由于设置面板本身也被翻译无论当前使用哪种语言你都能认出这一项。即时切换来自底层的可观察绑定语言选项变化后国际化模块会重新加载对应翻译文件界面上所有绑定的字符串随之同步刷新。相关实现在 AppI18n 中负责全部界面字符串的查找与回退。切换后哪些内容会变切换到简体中文后菜单、按钮、设置说明以及lang/texts/中的文档文本都会变成中文。有两个边界情况值得知道未翻译的条目会自动回退到英文。新功能加入的字符串如果中文还没跟上界面直接显示英文原文不会留下空白或占位符。你自己输入的内容比如连接名称、命令输出不属于翻译范围不受语言切换影响。代码中的查找顺序是先查当前语言查不到再查英文仍查不到才返回键名本身。所以看到一行英文通常意味着新增但尚未翻译而不是设置出错。翻译怎么查进度、怎么扩展各语言的翻译进度在 lang/README.md 的状态表里记录了人工校对完成的版本号。发现错译时可以直接修改对应.properties文件中的条目但必须在前面加一行标记#custom storeIntroHeader连接中心这个标记表示该条目经过人工校对后续自动重新生成翻译时不会覆盖它没有标记的条目则会被覆盖。上例中的连接中心标题正是一条这样的自定义条目。如果某个条目在多种语言里自动翻译都不准确还可以在英文原条目上添加#context注释补充翻译上下文让工具下次生成时给出更准的结果。lang/texts/下的 Markdown 文本不会被自动覆盖直接修改即可。改完后按 CONTRIBUTING.md 中的步骤在本地构建开发者版本就能看到修改效果。如果只想把界面切成中文记住一处即可设置里个性化分类下的语言下拉框。如果希望减少英文混杂可以先到 lang/strings/ 下的文件中确认相关条目是否有中文取值缺失的按#custom规范补上。动手前把 lang/README.md 通读一遍篇幅不长本文涉及的规则它都有覆盖。【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
XPipe 多语言界面切换：中文设置与翻译机制
XPipe 多语言界面切换中文设置与翻译机制【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe这篇文章解决两个问题如何把 XPipe 的界面从英文切换成中文以及它的多语言翻译系统背后如何运作让你能判断界面里偶尔出现的英文是设置问题还是翻译没跟上。XPipe 是一款在本地桌面上管理整套服务器基础设施的工具内置 18 种语言包含简体中文与繁体中文。本文覆盖翻译文件的结构、语言配置入口、切换后的影响范围以及你可以自行扩展的边界。翻译文件在哪里XPipe 的界面文本全部放在lang/目录下分两层lang/strings/存放短字符串菜单、按钮、设置项标签。每种语言一个.properties文件简体中文对应 translations_zh-Hans.properties全文 2800 多行。lang/texts/存放较长的说明文档用 Markdown 格式例如 Termius、Xshell 连接导入功能的中文引导说明。翻译的生产流程是三步以英文为基准用 DeepL 自动翻译再由人工校对。新增字符串先写英文自动翻译到各语言社区贡献者只负责修正个别错译。这种分工让翻译文件能跟上功能迭代的速度。各语言的校对状态也记录在 lang/README.md 中并标注对应版本号方便判断某语言校对到了哪一版。语言配置入口在哪里应用内切换语言的位置在设置面板的个性化Personalization分类里其中的语言下拉框就是配置项选择后新语言立即生效不需要重启。首次启动的初始设置窗口里也提供了同一个选项。下拉框旁的说明文字来源就是简体中文文件里的这两条language语言 languageDescription设置界面语言第一条是选项标签第二条是下拉框旁显示的说明。由于设置面板本身也被翻译无论当前使用哪种语言你都能认出这一项。即时切换来自底层的可观察绑定语言选项变化后国际化模块会重新加载对应翻译文件界面上所有绑定的字符串随之同步刷新。相关实现在 AppI18n 中负责全部界面字符串的查找与回退。切换后哪些内容会变切换到简体中文后菜单、按钮、设置说明以及lang/texts/中的文档文本都会变成中文。有两个边界情况值得知道未翻译的条目会自动回退到英文。新功能加入的字符串如果中文还没跟上界面直接显示英文原文不会留下空白或占位符。你自己输入的内容比如连接名称、命令输出不属于翻译范围不受语言切换影响。代码中的查找顺序是先查当前语言查不到再查英文仍查不到才返回键名本身。所以看到一行英文通常意味着新增但尚未翻译而不是设置出错。翻译怎么查进度、怎么扩展各语言的翻译进度在 lang/README.md 的状态表里记录了人工校对完成的版本号。发现错译时可以直接修改对应.properties文件中的条目但必须在前面加一行标记#custom storeIntroHeader连接中心这个标记表示该条目经过人工校对后续自动重新生成翻译时不会覆盖它没有标记的条目则会被覆盖。上例中的连接中心标题正是一条这样的自定义条目。如果某个条目在多种语言里自动翻译都不准确还可以在英文原条目上添加#context注释补充翻译上下文让工具下次生成时给出更准的结果。lang/texts/下的 Markdown 文本不会被自动覆盖直接修改即可。改完后按 CONTRIBUTING.md 中的步骤在本地构建开发者版本就能看到修改效果。如果只想把界面切成中文记住一处即可设置里个性化分类下的语言下拉框。如果希望减少英文混杂可以先到 lang/strings/ 下的文件中确认相关条目是否有中文取值缺失的按#custom规范补上。动手前把 lang/README.md 通读一遍篇幅不长本文涉及的规则它都有覆盖。【免费下载链接】xpipeAccess your entire server infrastructure from your local desktop项目地址: https://gitcode.com/GitHub_Trending/xp/xpipe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考