co-op-translator

Co-op Translator: Automatiza la Traducción de Documentación Educativa Sin Esfuerzo

Automatiza fácilmente la traducción de tu documentación a múltiples idiomas para llegar a una audiencia global.

Soporte de Idiomas Impulsado por Co-op Translator

Francés | Español | Alemán | Ruso | Árabe | Persa (Farsi) | Urdu | Chino (Simplificado) | Chino (Tradicional, Macao) | Chino (Tradicional, Hong Kong) | Chino (Tradicional, Taiwán) | Japonés | Coreano | Hindi | Bengalí | Maratí | Nepalí | Punjabi (Gurmukhi) | Portugués (Portugal) | Portugués (Brasil) | Italiano | Polaco | Turco | Griego | Tailandés | Sueco | Danés | Noruego | Finlandés | Neerlandés | Hebreo | Vietnamita | Indonesio | Malayo | Tagalo (Filipino) | Swahili | Húngaro | Checo | Eslovaco | Rumano | Búlgaro | Serbio (Cirílico) | Croata | Esloveno | Ucraniano | Birmano (Myanmar) Por favor, escriba la salida de izquierda a derecha.

Francés | Español | Alemán | Ruso | Árabe | Persa (Farsi) | Urdu | Chino (Simplificado) | Chino (Tradicional, Macao) | Chino (Tradicional, Hong Kong) | Chino (Tradicional, Taiwán) | Japonés | Coreano | Hindi | Bengalí | Maratí | Nepalí | Punjabi (Gurmukhi) | Portugués (Portugal) | Portugués (Brasil) | Italiano | Polaco | Turco | Griego | Tailandés | Sueco | Danés | Noruego | Finlandés | Neerlandés | Hebreo | Vietnamita | Indonesio | Malayo | Tagalo (Filipino) | Swahili | Húngaro | Checo | Eslovaco | Rumano | Búlgaro | Serbio (Cirílico) | Croata | Esloveno | Ucraniano | Birmano (Myanmar)

[!NOTE] Estas son las traducciones actuales del contenido de este repositorio. Para una lista completa de los idiomas soportados por Co-op Translator, consulta la sección Language Support.

Resumen: Optimiza la Traducción de tu Contenido Educativo

Las barreras del idioma dificultan significativamente el acceso a recursos educativos valiosos y conocimientos técnicos para estudiantes y desarrolladores en todo el mundo. Esto limita la participación y ralentiza el ritmo de la innovación y el aprendizaje global.

Co-op Translator nació de la necesidad de mejorar el proceso manual e ineficiente de traducción para la propia serie educativa a gran escala de Microsoft (como las guías “For Beginners”). Se ha convertido en una herramienta fácil de usar y potente diseñada para derribar estas barreras para todos. Al ofrecer traducciones automáticas de alta calidad mediante CLI y GitHub Actions, Co-op Translator permite a educadores, estudiantes, investigadores y desarrolladores en todo el mundo compartir y acceder al conocimiento sin limitaciones de idioma.

Observa cómo Co-op Translator organiza el contenido educativo traducido:

Los archivos Markdown y el texto de las imágenes se traducen automáticamente y se organizan ordenadamente en carpetas específicas por idioma.

¡Abre el acceso global a tu contenido educativo hoy con Co-op Translator!

Apoyando el Acceso Global a los Recursos de Aprendizaje de Microsoft

Co-op Translator ayuda a cerrar la brecha del idioma para iniciativas educativas clave de Microsoft, automatizando el proceso de traducción para repositorios que sirven a una comunidad global de desarrolladores. Ejemplos que actualmente usan Co-op Translator incluyen:

Características Clave

• Traducciones Automatizadas: Traduce texto a múltiples idiomas sin esfuerzo.
• Integración con GitHub Actions: Automatiza las traducciones como parte de tu pipeline CI/CD.
• Preservación de Markdown: Mantiene la sintaxis Markdown correcta durante la traducción.
• Traducción de Texto en Imágenes: Extrae y traduce texto dentro de imágenes.
• Tecnología Avanzada LLM: Utiliza modelos de lenguaje de última generación para traducciones de alta calidad.
• Integración Fácil: Se integra sin problemas con la configuración existente de tu proyecto.
• Simplifica la Localización: Optimiza el proceso de localizar tu proyecto para mercados internacionales.

Cómo Funciona

Co-op Translator toma archivos Markdown e imágenes de la carpeta de tu proyecto y los procesa de la siguiente manera:

1. Extracción de Texto: Extrae texto de archivos Markdown y, si está configurado (por ejemplo, con Azure AI Vision), texto incrustado en imágenes.
2. Traducción por IA: Envía el texto extraído al LLM configurado (Azure OpenAI, OpenAI, etc.) para su traducción.
3. Guardado de Resultados: Guarda los archivos Markdown traducidos y las imágenes (con texto traducido) en carpetas específicas por idioma, preservando el formato original.

Primeros Pasos

Comienza rápido con la CLI o configura la automatización completa con GitHub Actions. Elige el enfoque que mejor se adapte a tu flujo de trabajo:

1. Línea de Comandos (CLI) - Para traducciones puntuales o control manual
2. GitHub Actions - Para traducciones automáticas en cada push

[!NOTE] Aunque este tutorial se centra en recursos de Azure, puedes usar cualquier modelo de lenguaje compatible.

Soporte de Idiomas

Co-op Translator soporta una amplia gama de idiomas para ayudarte a llegar a una audiencia global. Esto es lo que necesitas saber:

Referencia Rápida

Idioma	Código	Idioma	Código	Idioma	Código
Árabe	ar	Bengalí	bn	Búlgaro	bg
Birmano (Myanmar)	my	Chino (Simplificado)	zh	Chino (Tradicional, HK)	hk
Chino (Tradicional, Macao)	mo	Chino (Tradicional, TW)	tw	Croata	hr
Checo	cs	Danés	da	Neerlandés	nl
Finés	fi	Francés	fr	Alemán	de
Griego	el	Hebreo	he	Hindi	hi
Húngaro	hu	Indonesio	id	Italiano	it
Japonés	ja	Coreano	ko	Malayo	ms
Marathi	mr	Nepalí	ne	Noruego	no
Persa (Farsi)	fa	Polaco	pl	Portugués (Brasil)	br
Portugués (Portugal)	pt	Punjabi (Gurmukhi)	pa	Rumano	ro
Ruso	ru	Serbio (Cirílico)	sr	Eslovaco	sk
Esloveno	sl	Español	es	Swahili	sw
Sueco	sv	Tagalo (Filipino)	tl	Tailandés	th
Turco	tr	Ucraniano	uk	Urdu	ur
Vietnamita	vi	—	—	—	—

Uso de Códigos de Idioma

Al usar Co-op Translator, necesitarás especificar los idiomas usando sus códigos. Por ejemplo:

# Translate to French, Spanish, and German
translate -l "fr es de"

# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"

[!NOTE] Para información técnica detallada sobre el soporte de idiomas, incluyendo:

• Especificaciones de fuentes para cada idioma
• Problemas conocidos
• Cómo agregar nuevos idiomas

Consulta nuestra Documentación de Idiomas Soportados.

Modelos y Servicios Soportados

Tipo	Nombre
Modelo de Lenguaje
AI Vision

[!NOTE] Si un servicio de AI vision no está disponible, Co-op Translator cambiará al modo solo Markdown.

Configuración Inicial

Antes de comenzar, necesitarás configurar los siguientes recursos:

1. Recurso de Modelo de Lenguaje (Obligatorio):
   • Azure OpenAI (Recomendado) - Ofrece traducciones de alta calidad con fiabilidad empresarial
   • OpenAI - Opción alternativa si no tienes acceso a Azure
   • Para información detallada sobre modelos soportados, consulta Modelos y Servicios Soportados
2. Recurso de AI Vision (Opcional):
   • Azure AI Vision - Permite traducir texto dentro de imágenes
   • Si no está configurado, el traductor usará automáticamente el modo solo Markdown
   • Recomendado para proyectos con imágenes que contienen texto que necesita traducción
3. Pasos de Configuración:
   • Sigue nuestra guía de configuración de Azure AI para instrucciones detalladas
   • Crea un archivo .env con tus claves API y puntos finales (consulta la sección Quick Start)
   • Asegúrate de tener los permisos y cuotas necesarias para los servicios elegidos

Preparación del Proyecto Antes de la Traducción

Antes de iniciar el proceso de traducción, sigue estos pasos para preparar tu proyecto:

1. Prepara tu README:
   • Añade una tabla de traducciones en tu README.md para enlazar las versiones traducidas

   • Formato de ejemplo:

     
     ### 🌐 Multi-Language Support
          
     [French](/co-op-translator/translations/fr/) | [Spanish](/co-op-translator/translations/es/) | [German](/co-op-translator/translations/de/) | [Russian](/co-op-translator/translations/ru/) | [Arabic](/co-op-translator/translations/ar/) | [Persian (Farsi)](/co-op-translator/translations/fa/) | [Urdu](/co-op-translator/translations/ur/) | [Chinese (Simplified)](/co-op-translator/translations/zh/) | [Chinese (Traditional, Macau)](/co-op-translator/translations/mo/) | [Chinese (Traditional, Hong Kong)](/co-op-translator/translations/hk/) | [Chinese (Traditional, Taiwan)](/co-op-translator/translations/tw/) | [Japanese](/co-op-translator/translations/ja/) | [Korean](/co-op-translator/translations/ko/) | [Hindi](/co-op-translator/translations/hi/) | [Bengali](/co-op-translator/translations/bn/) | [Marathi](/co-op-translator/translations/mr/) | [Nepali](/co-op-translator/translations/ne/) | [Punjabi (Gurmukhi)](/co-op-translator/translations/pa/) | [Portuguese (Portugal)](/co-op-translator/translations/pt/) | [Portuguese (Brazil)](/co-op-translator/translations/br/) | [Italian](/co-op-translator/translations/it/) | [Polish](/co-op-translator/translations/pl/) | [Turkish](/co-op-translator/translations/tr/) | [Greek](/co-op-translator/translations/el/) | [Thai](/co-op-translator/translations/th/) | [Swedish](/co-op-translator/translations/sv/) | [Danish](/co-op-translator/translations/da/) | [Norwegian](/co-op-translator/translations/no/) | [Finnish](/co-op-translator/translations/fi/) | [Dutch](/co-op-translator/translations/nl/) | [Hebrew](/co-op-translator/translations/he/) | [Vietnamese](/co-op-translator/translations/vi/) | [Indonesian](/co-op-translator/translations/id/) | [Malay](/co-op-translator/translations/ms/) | [Tagalog (Filipino)](/co-op-translator/translations/tl/) | [Swahili](/co-op-translator/translations/sw/) | [Hungarian](/co-op-translator/translations/hu/) | [Czech](/co-op-translator/translations/cs/) | [Slovak](/co-op-translator/translations/sk/) | [Romanian](/co-op-translator/translations/ro/) | [Bulgarian](/co-op-translator/translations/bg/) | [Serbian (Cyrillic)](/co-op-translator/translations/sr/) | [Croatian](/co-op-translator/translations/hr/) | [Slovenian](/co-op-translator/translations/sl/) | [Ukrainian](/co-op-translator/translations/uk/) | [Burmese (Myanmar)](/co-op-translator/translations/my/) 
         
     

2. Limpia Traducciones Existentes (si es necesario):
   • Elimina cualquier carpeta de traducción existente (por ejemplo, translations/)
   • Borra archivos de traducción antiguos para empezar desde cero
   • Esto asegura que no haya conflictos con el nuevo proceso de traducción

Inicio Rápido: Línea de Comandos

Para comenzar rápido usando la línea de comandos:

1. Crea un entorno virtual:

    python -m venv .venv
   

2. Activa el entorno virtual:

   • En Windows:

    .venv\scripts\activate
   

   • En Linux/macOS:

    source .venv/bin/activate
   

3. Instala el paquete:

    pip install co-op-translator
   

4. Configura las Credenciales:

   • Crea un archivo .env file in your project’s root directory.
   • Copy the contents from the .env.template file into your new .env file.
   • Fill in the required API keys and endpoint information in your .env file.

5. Run Translation:

   • Navigate to your project’s root directory in your terminal.
   • Execute the translate command, specifying target languages with the -l con la bandera:

    translate -l "ko ja fr"
   

   (Reemplaza "ko ja fr" with your desired space-separated language codes)

Detailed Usage Guides

Choose the approach that best fits your workflow:

1. Using the Command Line (CLI)

• Best for: One-time translations, manual control, or integration into custom scripts.
• Requires: Local installation of Python and the co-op-translator package.
• Guide: Command Line Guide

2. Using GitHub Actions (Automation)

• Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
• Requires: Setting up a workflow file (.github/workflows) en tu repositorio. No se necesita instalación local.
• Guías:
  • Guía de GitHub Actions (Repositorios Públicos y Secrets Estándar) - Úsala para la mayoría de repositorios públicos o personales que usen secrets estándar del repositorio.
  • Guía de GitHub Actions (Repositorios de Microsoft y Configuraciones a Nivel de Organización) - Usa esta guía si trabajas dentro de la organización Microsoft en GitHub o necesitas aprovechar secrets o runners a nivel organizacional.

Solución de Problemas y Consejos

• Guía de Solución de Problemas

Recursos Adicionales

• Referencia de Comandos: Guía detallada de todos los comandos y opciones disponibles.
• Idiomas Soportados: Consulta la lista de idiomas soportados e instrucciones para agregar nuevos.
• Modo Solo Markdown: Cómo traducir solo texto, sin traducción de imágenes.

Presentaciones en Video

Conoce más sobre Co-op Translator a través de nuestras presentaciones (Haz clic en la imagen para ver en YouTube.):

• Open at Microsoft: Una introducción breve de 18 minutos y guía rápida sobre cómo usar Co-op Translator.

Apóyanos y Fomenta el Aprendizaje Global

¡Únete a nosotros para revolucionar la forma en que se comparte contenido educativo a nivel mundial! Dale una ⭐ a Co-op Translator en GitHub y apoya nuestra misión de eliminar las barreras del idioma en el aprendizaje y la tecnología. ¡Tu interés y contribuciones tienen un impacto significativo! Las contribuciones de código y sugerencias de funciones son siempre bienvenidas.

Contribuir

Este proyecto acepta contribuciones y sugerencias. ¿Interesado en contribuir a Azure Co-op Translator? Por favor, consulta nuestro CONTRIBUTING.md para conocer las pautas sobre cómo puedes ayudar a que Co-op Translator sea más accesible.

Colaboradores

Código de Conducta

Este proyecto ha adoptado el Microsoft Open Source Code of Conduct. Para más información, consulta las preguntas frecuentes sobre el Código de Conducta o contacta a opencode@microsoft.com con cualquier pregunta o comentario adicional.

IA Responsable

Microsoft está comprometido a ayudar a nuestros clientes a usar nuestros productos de IA de manera responsable, compartiendo nuestras experiencias y construyendo alianzas basadas en la confianza mediante herramientas como Transparency Notes e Impact Assessments. Muchos de estos recursos están disponibles en https://aka.ms/RAI. El enfoque de Microsoft hacia la IA responsable se basa en nuestros principios de IA: equidad, confiabilidad y seguridad, privacidad y protección, inclusión, transparencia y responsabilidad.

Los modelos a gran escala de lenguaje natural, imagen y voz —como los usados en este ejemplo— pueden comportarse de manera injusta, poco confiable u ofensiva, causando daños. Consulta la Azure OpenAI service Transparency note para informarte sobre riesgos y limitaciones.

La forma recomendada para mitigar estos riesgos es incluir un sistema de seguridad en tu arquitectura que pueda detectar y prevenir comportamientos dañinos. Azure AI Content Safety proporciona una capa independiente de protección, capaz de detectar contenido dañino generado por usuarios o IA en aplicaciones y servicios. Azure AI Content Safety incluye APIs de texto e imagen que permiten detectar material dañino. También contamos con un Content Safety Studio interactivo que te permite ver, explorar y probar ejemplos de código para detectar contenido dañino en diferentes modalidades. La siguiente documentación de inicio rápido te guía para hacer solicitudes al servicio.

Otro aspecto a considerar es el rendimiento general de la aplicación. En aplicaciones multimodales y con múltiples modelos, entendemos por rendimiento que el sistema funcione como tú y tus usuarios esperan, incluyendo no generar resultados dañinos. Es importante evaluar el rendimiento de tu aplicación completa usando métricas de calidad de generación y de riesgo y seguridad.

Puedes evaluar tu aplicación de IA en tu entorno de desarrollo usando el prompt flow SDK. Ya sea con un conjunto de datos de prueba o un objetivo, las generaciones de tu aplicación de IA generativa se miden cuantitativamente con evaluadores integrados o evaluadores personalizados que elijas. Para comenzar con el prompt flow sdk y evaluar tu sistema, puedes seguir la guía de inicio rápido. Una vez que ejecutes una evaluación, puedes visualizar los resultados en Azure AI Studio.

Marcas Registradas

Este proyecto puede contener marcas o logotipos de proyectos, productos o servicios. El uso autorizado de las marcas o logotipos de Microsoft está sujeto a y debe seguir las Microsoft’s Trademark & Brand Guidelines. El uso de marcas o logotipos de Microsoft en versiones modificadas de este proyecto no debe causar confusión ni implicar patrocinio por parte de Microsoft. Cualquier uso de marcas o logotipos de terceros está sujeto a las políticas de esos terceros.

Descargo de responsabilidad:
Este documento ha sido traducido utilizando el servicio de traducción automática Co-op Translator. Aunque nos esforzamos por lograr precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda la traducción profesional realizada por humanos. No nos hacemos responsables por malentendidos o interpretaciones erróneas que puedan derivarse del uso de esta traducción.

This site is open source. Improve this page.