人工智能AI 应用前端媒体生成【免费下载链接】ChatGPT-Midjourney 一键拥有你自己的 ChatGPT众多AI 网页服务 | One click access to your own ChatGPTMany AI web services项目地址https://gitcode.com/gh_mirrors/ch/ChatGPT-Midjourney点击查看免费下载本文围绕 ChatGPT-Midjourney 仓库中的 docs/translation.md 展开系统讲解如何为该开源项目新增一种界面语言翻译的完整流程。你将从零开始学会复制基础语言文件、切换类型声明、注册语言到ALL_LANGS与ALL_LANG_OPTIONS、逐条翻译文案并理解背后的语言回退fallback机制与语言自动检测逻辑最终能独立提交一份可被作者合并的翻译 PR。一、前置认知项目国际化i18n架构概览在动手添加翻译之前先理解 ChatGPT-Midjourney 的语言体系是如何组织的。所有语言文件都存放在 app/locales/ 目录下目前已内置 19 种语言语言键文件语言键文件cncn.tseses.tsenen.tsitit.tstwtw.tstrtr.tsptpt.tsdede.tsjpjp.tsvivi.tskoko.tsruru.tsidid.tscscs.tsfrfr.tsnono.tsarar.tsbnbn.tssksk.ts其中 en.ts 是唯一使用完整LocaleType的基准语言文件其余语言文件如 jp.ts、ru.ts、ar.ts都使用PartialLocaleType。语言注册的中心在 app/locales/index.ts它负责集中import所有语言模块并组装成ALL_LANGS映射表通过ALL_LANG_OPTIONS提供每种语言在设置界面中的展示名称提供getLang()/changeLang()/getISOLang()等运行时 API在启动时把目标语言与回退语言英语做深合并缺词自动补英文。从源码结构看新增语言本质上是三步式改动新建语言文件 → 在 app/locales/index.ts 中注册 → 翻译文案。下面按 docs/translation.md 的官方步骤逐一展开。二、核心流程以新增语言new为例的完整 8 步原文档以假想语言new为例给出如下 8 个步骤。我们逐条拆解并补充源码依据。第 1 步复制基础语言文件cp app/locales/en.ts app/locales/new.ts以英文文件 app/locales/en.ts 为模板复制出new.ts。之所以选择en.ts而不是其他语言文件是因为它是唯一完整定义全部文案键的文件约 682 行包含所有嵌套对象与函数型字段作为翻译对照表最齐全。复制后先不要急着翻译先做第 2 步的类型改造否则 TypeScript 会在编译期报错。第 2 步改写类型声明与默认导出编辑new.ts把文件末尾的导出与类型声明改为// 修改前 const en: LocaleType { ... }; export default en; // 修改后 const new: PartialLocaleType { ... }; export default new;这里有两个关键点类型从LocaleType改为PartialLocaleType。两者的差异定义在 app/locales/cn.tstype DeepPartialT T extends object ? { [P in keyof T]?: DeepPartialT[P] } : T; export type LocaleType typeof cn; export type PartialLocaleType DeepPartialtypeof cn;LocaleType要求所有字段必须存在而PartialLocaleType把每个字段都变成可选。这意味着你允许在new.ts中只翻译部分文案——缺失的键会在运行时自动回退到英文不会导致界面出现空白。这也是 en.ts 顶部注释反复强调的原因if you are adding a new translation, please use PartialLocaleType instead of LocaleType新增翻译请使用PartialLocaleType而非LocaleType。导出方式。注意 index.ts 中的导入使用的是import new from ./new.ts这种 default 导入形式因此语言文件的默认导出必须是对应语言对象本身。第 3~6 步在语言注册中心登记编辑 app/locales/index.ts共四处改动// ① 在文件顶部 import 区新增 import new from ./new.ts; // ② 在 ALL_LANGS 对象中加入新键 const ALL_LANGS { cn, en, tw, pt, jp, ko, id, fr, es, it, tr, de, vi, ru, cs, no, ar, bn, sk, new, // 新增 }; // ③ 在 ALL_LANG_OPTIONS 中加入显示名称 export const ALL_LANG_OPTIONS: RecordLang, string { ... sk: Slovensky, new: new lang, // 新增这里应填写该语言的原生名称 };要点说明ALL_LANGS键名即语言代码它的keyof类型被导出为Lang联合类型见 app/locales/index.ts新增键会自动扩展Lang类型从而让getLang()、changeLang()、ALL_LANG_OPTIONS等强类型 API 立刻接受新语言。ALL_LANG_OPTIONS值是展示在下拉菜单中的语言名称惯例使用该语言的自称。观察现有条目可见规律如cn: 简体中文、en: English、ar: العربية、bn: বাংলা因此new也应填入对应语言的原生拼写。AllLangs由Object.keys(ALL_LANGS)自动生成见 app/locales/index.ts无需手动维护。它被 app/components/settings.tsx 中的语言下拉菜单遍历用于渲染选项Select value{getLang()} onChange{(e) { changeLang(e.target.value as any); }} {AllLangs.map((lang) ( option value{lang} key{lang} {ALL_LANG_OPTIONS[lang]} /option ))} /Select完成以上注册后新语言会自动出现在设置页面的语言选择器中用户无需任何额外配置即可切换。第 7 步翻译文案这是工作量最大的环节。逐条将new.ts中的英文文案翻译为目标语言。翻译时请特别留意以下四种特殊字段形态① 函数型字段保留函数签名只翻译返回的字符串。例如 en.ts 中的ChatItem: { ChatItemCount: (count: number) ${count} messages, }, Chat: { SubTitle: (count: number) ${count} messages, ... Input: (submitKey: string) { var inputHints ${submitKey} 发送; ... }, },翻译时保持(count: number) ...的签名与插值结构不变只替换引号内的文案例如中文版 cn.ts 写为(count: number) ${count} 条对话。② 内嵌 Markdown 链接的文案。如Error.Unauthorized字段的值中包含[Settings](https://link.gitcode.com/i/cd14212de9dbe472bd6874670be33b49)这类链接见 en.ts翻译时必须保留 Markdown 链接语法与路由地址只翻译链接文字否则前端渲染会破坏链接。③ 依赖isApp的环境分支。文件顶部有一行const isApp !!getClientConfig()?.isApp;它根据当前是否运行在桌面客户端Tauri 应用中为Error.Unauthorized等字段选择不同文案。翻译时要完整保留三元表达式结构仅替换两个分支里的字符串。④ 带占位符/动态内容的文案。注意类似PinToastContent: Pinned 1 messages to contextual prompts、Commands下以new、newm、next、prev、clear、del为键的快捷指令名以及设置页中各种带Title/SubTitle的嵌套对象都需要一并翻译保证整个界面语言统一。第 8 步提交 Pull Request完成翻译后提交 Pull Request作者审核合并后新语言即随下一版本发布。提交前建议自查运行yarn lint或npx tsc --noEmit确认类型检查通过未翻译的字段因PartialLocaleType可选不会报错但请勿把翻译文件里的类型误写为LocaleType确认 app/locales/index.ts 中ALL_LANGS与ALL_LANG_OPTIONS都已登记确认new.ts的 default 导出正确。三、理解背后的机制为什么缺词也能用新增语言之所以不需要翻译 100% 的文案就能上线得益于 app/locales/index.ts 中的回退合并逻辑const fallbackLang en; const targetLang ALL_LANGS[getLang()] as LocaleType; // if target lang missing some fields, it will use fallback lang string merge(fallbackLang, targetLang); export default fallbackLang as LocaleType;运行流程是先通过getLang()解析出当前语言再从ALL_LANGS取出对应的语言对象作为targetLang然后调用 app/utils/merge.ts 将targetLang的字段深合并进英文基准对象fallbackLang。合并后的对象作为默认导出供全项目通过import Locale from ./locales消费。merge的实现app/utils/merge.ts对每个键递归处理如果源值是对象则递归合并否则直接覆盖。因此目标语言中已翻译的键覆盖英文未翻译的键保留英文原文——这就是缺词自动补英文的机制保证也是 docs/translation.md 要求新语言文件使用PartialLocaleType的原因只有字段可选未翻译的键才不会被类型系统强制要求。四、语言自动检测与切换新语言如何被用户使用新语言注册后会参与到 app/locales/index.ts 的运行时逻辑中① 初次访问的自动检测getLanguage。index.ts 使用Intl.Locale解析浏览器语言优先检查地区代码如zh-CN的CN小写cn是否在AllLangs中其次检查语言代码如zh、en是否在AllLangs中均不命中则回退到默认语言en。这意味着新语言的键命名建议与 ISO 语言/地区代码保持一致例如简体中文用cn、繁体中文用tw更利于用户访问时被自动识别。② 用户手动切换changeLangexport function changeLang(lang: Lang) { setItem(LANG_KEY, lang); location.reload(); }选择结果写入localStorage的lang键并刷新页面下次进入时getLang()会优先读取该键见 index.ts。③ 输出 HTML 语言属性getISOLangexport function getISOLang() { const isoLangString: Recordstring, string { cn: zh-Hans, tw: zh-Hant, }; const lang getLang(); return isoLangString[lang] ?? lang; }cn/tw这类非标准代码会被映射为符合 HTMLlang属性标准的zh-Hans/zh-Hant其他语言直接返回自身键。该值被 app/components/home.tsx 用于设置页面的document.documentElement.lang影响屏幕阅读器与浏览器翻译功能——如果你的新语言有特殊书写方向如阿拉伯语ar的 RTL还可留意相关样式适配。五、实战验证清单按上述流程操作完成后建议按以下清单验证确保翻译可正常工作类型层面确认new.ts使用PartialLocaleType类型且 default 导出正确tsc --noEmit通过注册层面确认 app/locales/index.ts 的 import、ALL_LANGS、ALL_LANG_OPTIONS三处均已改动运行时层面启动开发服务yarn install yarn dev在设置页语言下拉菜单中找到新语言并切换刷新后确认界面文案生效回退层面有意漏译某个键如WIP确认界面该处显示英文而非空白验证 merge 回退机制特殊字段层面检查Input这类函数型文案、Error.Unauthorized这类含 Markdown 链接的文案、以及isApp分支文案显示是否正常。六、常见问题速查Q1翻译文件里个别键忘了翻译会编译报错吗不会。只要类型是PartialLocaleType所有字段均为可选未翻译的键运行时回退为英文。但若误用LocaleType类型TypeScript 会强制要求补全所有键。Q2新增语言后设置页没有出现该语言选项检查是否漏改了 app/locales/index.ts 中的ALL_LANGS或ALL_LANG_OPTIONS。AllLangs由ALL_LANGS自动派生无需单独维护语言选择器直接遍历AllLangs与ALL_LANG_OPTIONS见 app/components/settings.tsx。Q3语言键命名有什么讲究从 index.ts 的自动检测逻辑看键名应尽量贴近 ISO 语言/地区代码如pt、vi、ar这样用户首次访问时更可能被自动匹配非标准代码如cn、tw需要靠getISOLang()的映射表转换为标准值。Q4可以只翻译部分常用界面吗可以。得益于PartialLocaleType merge 回退机制先翻译高频区域Auth、Chat、Settings等即可让新语言可用后续再逐步补齐其余文案无需一次性完成全部翻译。赞分享人工智能AI 应用前端媒体生成【免费下载链接】ChatGPT-Midjourney 一键拥有你自己的 ChatGPT众多AI 网页服务 | One click access to your own ChatGPTMany AI web services项目地址https://gitcode.com/gh_mirrors/ch/ChatGPT-Midjourney点击查看免费下载相关推荐tui.editor国际化翻译完整指南为开源编辑器添加新语言包tui.editor国际化翻译完整指南为开源编辑器添加新语言包 TOAST UI Editor 是一款功能强大的开源 Markdown 编辑器支持多种语言国前端UI组件如何用Rust构建键盘记录器Rust-for-Malware-Development实战教程如何用Rust构建键盘记录器Rust for Malware Development实战教程 在网络安全领域键盘记录器Keylogger是一种重要的监控如何为noVNC添加新语言支持完整国际化指南如何为noVNC添加新语言支持完整国际化指南 noVNC作为一款流行的HTML5 VNC客户端支持多语言国际化功能让全球用户能够以自己熟悉的语言使用该工具前端音视频上一篇今日热门项目推荐PhalApi - 让PHP接口开发更高效优雅下一篇妙言MiaoYan最佳实践10个技巧构建高效个人知识管理系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考