在全球化的开发环境中，多语言支持已经成为项目的必备能力。
然而，手动进行翻译工作费时费力，且难以保证翻译质量。
而微软 Azure 开源的 Co-op-Translator，正是一款面向开发者的 多语言翻译工具，让项目本地化变得更加简单高效。
不论是中文、英文，还是韩文、日文等都可以一键翻译并匹配原有格式。
对于经常浏览GitHub 或 发布开源项目 时，非常有必要。
项目介绍
co-op-translator 是一个基于 Python 的开源翻译库，利用 Azure AI 服务和先进的 LLM 技术，自动将项目中的Markdown文件和图像中的文字成多种语言。
通过将 Co-op Translator 集成到工作流程中，自动生成不同语言的整理翻译文件夹，从而简化多种语言的翻译过程，使开发人员能够方便、高效地使用。
无论是 Markdown 文件还是图片中的文字都能轻松搞定，且原格式完美保留！
主要功能
-
自动翻译: 一键将项目中的文字翻译成多种语言。
-
Markdown 保存：在翻译过程中保持正确的 Markdown 语法。
-
图像文字翻译: 支持提取并翻译图像中的文字。
-
集成 LLM 服务: 利用 Azure AI 服务和先进的 LLM 技术，保证翻译的高质量。
-
轻松集成：无缝集成到您现有的项目设置中。
-
简化本地化：简化将项目本地化为国际市场的流程。
工作原理
从项目文件夹中的Markdown和图像文件开始，都由 Azure AI 服务处理：
-
Azure OpenAI：从Markdown文件中翻译文本。
-
Azure计算机视觉：从图像中提取文本，然后由Azure OpenAI进行翻译。
最终翻译的Markdown和图片文件保存到指定翻译文件夹中，随时可以用于多种语言。
快速上手
1、安装指南
安装Python: 确保您的系统已安装Python 3.10或更高版本。
使用 pip 命令安装co-op-translator（此方式会自动安装依赖包）
pip install co-op-translator
配置Azure资源：
在项目根目录下创建env文件，并配置Azure Computer vision和Azure OpenAI资源信息。
2、使用方法
co-op-translator 是一个命令行界面工具，可将项目中的 Markdown 和图像文件翻译成多种语言。
比如基本翻译，要将整个项目（markdown 文件和图片）翻译成单一语言（如韩语），可以使用以下命令：
(.venv) ..\translator>translate -l"ko"
Translating images: 100%|███████████████████████████████████████████████████| 276/276 [1:09:56<00:00, 15.37s/it]
Translating markdown files: 100%|████████████████████████████████████████████████| 153/153 [1:43:07<00:00, 241.31s/it]
如果要将项目翻译成多种语言（如西班牙语、英语和德语），可使用此命令：
(.venv) ..\translator>translate -l "ko ja zh tw es fr" -a
Translating images: 100%|███████████████████████████████████████████████████| 273/273 [1:09:56<00:00, 15.37s/it]
Translating markdown files: 100%|████████████████████████████████████████████████| 6/6 [24:07<00:00, 241.31s/it]
默认情况下，翻译器使用当前工作目录。如果你的项目位于其他地方，可以使用-r选项指定根目录：
translate -l "es fr de" -r "./my_project"
只翻译图片可以加-img参数，只翻译md文件可以加-md参数。
还可以加-d,以debug方式运行，就可以看到详细的处理日志了。
除了命令行方式，如果你使用Python开发项目时，可以直接以Python包进行调用。
导入指令：
from co_op_translator.translators.text_translator import TextTranslator
from co_op_translator.translators.markdown_translator import MarkdownTranslator
from co_op_translator.translators.image_translator import ImageTranslator
应用场景
1、多语言文档生成
开发者编写的文档或说明书可快速生成多语言版本，便于全球开发者阅读。
2、开源项目国际化
提升开源项目的国际化水平，吸引更多全球用户参与和使用。
3、跨团队协作
在多语言团队中，统一技术文档语言，提升工作效率。
4、翻译 UI 和图片资源
针对包含图片或 UI 元素的资源文件，快速生成翻译版本，节省大量时间。
写在最后
co-op-translator 是一款开发者不可或缺的多语言翻译助手，能够帮助开发者轻松实现项目本地化。
特别是对于需要多语言支持的文档或图片内容。它不仅节省了时间，还提升了翻译质量和一致性。
如果你之前深受项目多语言翻译的苦楚，特别建议试一试 co-op-translator。
GitHub 地址：github.com/Azure/co-op…
