什么是 ai-i18n-tools?
您有一个应用、网站、文档站点或仓库自述文件,它只有一种语言,而您希望支持更多语言。这种语言是 sourceLocale,它可以是任何语言。在这些指南中,英语是一个常见的例子。ai-i18n-tools 会找到文本,使用您选择的 LLM 提供商上的模型进行翻译,并写入您的项目已加载的文件。它会缓存每个结果,因此重新运行时只会将新的或更改的文本发送到模型。
你做什么以及工具做什么
| 您 | 工具 |
|---|---|
| 选择要尝试的语言、提供商和模型 | 提取文本、进行翻译、验证结果并写入目录或页面 |
让面向用户的文本对工具可见:应用代码中的 t() 调用、网站框架自身的 i18n,或自述文件中的语言列表标记 | 缓存翻译并在每次重新运行时重用它们 |
| 将结果连接到应用、网站路由或 README 的语言行 | 显示进度,并允许您在仪表板中审阅译文 |
该工具不会重写您的源代码,除非您使用 --write 运行 migrate-python-i18n 或 migrate-dotnet-i18n。包装步骤提供了编码代理提示。它不会安装 i18next 或您的站点框架的 i18n,也不会构建您的语言切换器,尽管为此提供了运行时帮助程序。
从何开始?
演练分组在为你的项目添加 i18n中,其中包含共享设置和针对每种项目的页面。请选择一行:
| 你有 | 从这里开始 |
|---|---|
| 源代码中包含纯文本的 JS/TS 应用(React、Next.js、Node、CLI) | 为 JS/TS 应用添加 i18n |
| Python 应用(Streamlit、FastAPI、Flask、桌面应用、脚本) | 为 Python 应用添加 i18n |
| 一个 .NET 应用程序 (Avalonia, WPF, MAUI, ASP.NET, Blazor, 控制台) | 为 .NET 应用程序添加 i18n |
一个已使用 ResourceManager 或 IStringLocalizer 的 .NET 应用程序 | 为 .NET ResourceManager 应用程序添加 i18n |
| Django 应用、Flask-Babel 目录或已使用 GNU gettext 的应用 | 为 Django / Python gettext 应用添加 i18n |
| 网站或文档站点(VitePress、Docusaurus、Starlight、Nextra、Fumadocs、Astro、纯 HTML) | 为网站或文档站点添加 i18n |
| 仓库自述文件和其他 Markdown 文件,通常与应用放在一起 | 为你的自述文件和 Markdown 文档添加 i18n |
| 独立的嵌套 JSON 区域设置文件 | JSON |
| 带有文本标签的 SVG 图表 | SVG 翻译 |
| Intlayer 字典(迁出 Intlayer) | 从 Intlayer 迁移 |
| Intlayer 字典(保留 Intlayer,就地翻译) | 就地翻译 Intlayer |
工作原理
- 安装 CLI 并设置提供商的 API 密钥:安装。
- 运行
init以写入ai-i18n-tools.config.json:快速入门。 - 准备项目:将字符串包装在
t()中,启用网站框架的 i18n,或将语言列表标记添加到自述文件中。 - 运行
sync。它会提取文本,翻译新内容,并写入输出。 - 在你的应用或网站中加载输出,添加语言切换器,并在源文件更改时重新运行
sync。
翻译模式
在底层,该工具运行四个流水线。你的配置会启用你需要的流水线,sync 会按顺序运行它们。
- UI 字符串 — 从 JS/TS 和 Python 中提取
t("…")和_()调用,以及从 C# 和 XAML 中提取T("…")/{loc:Tr '…'}(包括 GNU gettext 和 .NET.resx卫星程序集),并写入扁平的每个区域设置 JSON、.po/.mo或.resx。命令:extract、translate-ui、migrate-dotnet-i18n。指南:UI 字符串。Python:Python 应用程序。.NET:.NET 应用程序 和 为 .NET ResourceManager 应用程序添加 i18n。 - 文档 — 翻译
docs[].contentPaths中列出的 Markdown、MDX 和.astro页面。适用于 VitePress、Starlight、Docusaurus、Nextra、Fumadocs、Astro 和其他静态文档站点,以及存储库 README(flat的docsOutput.style)。命令:translate-docs。指南:文档 和 为您的 README 和 Markdown 文档添加 i18n。 - JSON — 翻译在顶级
json[]中定义的嵌套 JSON 区域设置包(主题标签、i18n 覆盖、不在源代码中的应用程序文本)。命令:translate-json。指南:JSON。 - SVG — 翻译 SVG 插图(
<text>、<title>、<desc>)中的可见文本,并为每个区域设置写入一个输出文件。与文档翻译分开。命令:translate-svg。指南:SVG 翻译。
许多项目会组合多种模式。常见的组合是 UI 字符串加上仓库的 README。像 VitePress 这样的文档网站是另一种常见的组合。请参阅组合管道和为您的 README 和 Markdown 文档添加 i18n。
示例
该仓库在 examples/ 下提供了可运行的示例项目,每个项目都有自己的配置、已提交的本地化输出和 README。无需 API 密钥即可浏览已翻译的文件;重新运行翻译则需要提供商密钥。
| 如果您有 | 示例 |
|---|---|
| 一个 JS/TS 应用 | console-app, nextjs-app |
| 一个与应用并存的仓库 README | console-app, nextjs-app |
| 一个 Python 应用 | python-streamlit, python-fastapi, python-gettext |
| 一个 .NET 帮助程序 | dotnet-console, dotnet-resx |
| 一个文档网站 | docusaurus-docs, vitepress-docs, astro-docs |
| 一个网站或纯 HTML | astro-website, plain-html |
请参阅示例查看完整列表和 npx degit 复制命令。