开发者必备！微软开源的项目翻译好帮手，一站式解决多语言翻译需求。 - 文章 - 开发者社区

点击上方“蓝色字体”关注我，每天推送“实用有趣的项目”！

在全球化的开发环境中，多语言支持 已经成为项目的必备能力。

然而，手动进行翻译工作费时费力，且难以保证翻译质量。

而微软 Azure 开源的 Co-op-Translator ，正是一款面向开发者的 多语言翻译工具 ，让项目本地化变得更加简单高效。

picture.image

不论是中文、英文，还是韩文、日文等都可以一键翻译并匹配原有格式。

对于经常浏览GitHub 或发布开源项目时，非常有必要。

项目介绍

picture.image

co-op-translator 是一个基于 Python 的开源翻译库，利用 Azure AI 服务和先进的 LLM 技术，自动将项目中的Markdown文件和图像中的文字成多种语言。

通过将 Co-op Translator 集成到工作流程中，自动生成不同语言的整理翻译文件夹，从而简化多种语言的翻译过程，使开发人员能够方便、高效地使用。

无论是 Markdown 文件还是图片中的文字都能轻松搞定，且原格式完美保留！

主要功能

• 自动翻译 : 一键将项目中的文字翻译成多种语言。
• Markdown 保存 ：在翻译过程中保持正确的 Markdown 语法。
• 图像文字翻译 : 支持提取并翻译图像中的文字。
• 集成 LLM 服务 : 利用 Azure AI 服务和先进的 LLM 技术，保证翻译的高质量。
• 轻松集成 ：无缝集成到您现有的项目设置中。
• 简化本地化 ：简化将项目本地化为国际市场的流程。

工作原理

picture.image

从项目文件夹中的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资源信息。

picture.image

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]

picture.image

如果要将项目翻译成多种语言（如西班牙语、英语和德语），可使用此命令：


 
 
 
 
   
(.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方式运行，就可以看到详细的处理日志了。

picture.image

除了命令行方式，如果你使用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