co-op-translator

Co-op Translator

Automação fácil da tradução do seu conteúdo educacional no GitHub para múltiplos idiomas, alcançando um público global.

🌐 Suporte Multilíngue

Suportado pelo Co-op Translator

Visão Geral

Co-op Translator ajuda você a localizar seu conteúdo educacional no GitHub em vários idiomas de forma simples. Quando você atualiza seus arquivos Markdown, imagens ou notebooks, as traduções permanecem automaticamente sincronizadas, garantindo que seu conteúdo esteja sempre preciso e atualizado para aprendizes ao redor do mundo.

Exemplo de como o conteúdo traduzido é organizado:

Example

Início rápido

# Crie e ative um ambiente virtual (recomendado)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Instale o pacote
pip install co-op-translator
# Traduzir
translate -l "ko ja fr" -md

Docker:

# Puxe a imagem pública do GHCR
docker pull ghcr.io/azure/co-op-translator:latest
# Execute com a pasta atual montada e .env fornecido (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md

Configuração mínima

Crie um arquivo .env usando o modelo: .env.template
Configure um provedor LLM (Azure OpenAI ou OpenAI)
(Opcional) Para tradução de imagens (-img), configure o Azure AI Vision
(Recomendado) Limpe traduções anteriores para evitar conflitos (ex.: translations/)
(Recomendado) Adicione uma seção de tradução ao seu README usando o modelo de idiomas para README
Veja: Configurar Azure AI

Uso

Traduza todos os tipos suportados:

translate -l "ko ja"

Apenas Markdown:

translate -l "de" -md

Markdown + imagens:

translate -l "pt" -md -img

Apenas notebooks:

translate -l "zh" -nb

Mais flags: Referência de comandos

Funcionalidades

Tradução automatizada para Markdown, notebooks e imagens
Mantém traduções sincronizadas com as alterações na fonte
Funciona localmente (CLI) ou em CI (GitHub Actions)
Usa Azure OpenAI ou OpenAI; Azure AI Vision opcional para imagens
Preserva a formatação e estrutura do Markdown

Documentação

Guia específico para Microsoft

[!NOTE] Apenas para mantenedores dos repositórios “For Beginners” da Microsoft.

Atualizando a lista de “outros cursos” (apenas para repositórios MS Beginners)

Apoie-nos e promova o aprendizado global

Junte-se a nós para revolucionar a forma como o conteúdo educacional é compartilhado globalmente! Dê uma ⭐ no Co-op Translator no GitHub e apoie nossa missão de derrubar barreiras linguísticas no aprendizado e na tecnologia. Seu interesse e contribuições fazem uma grande diferença! Contribuições de código e sugestões de funcionalidades são sempre bem-vindas.

Explore o conteúdo educacional da Microsoft no seu idioma

Apresentações em vídeo

👉 Clique na imagem abaixo para assistir no YouTube.

Open at Microsoft: Uma breve introdução de 18 minutos e guia rápido de como usar o Co-op Translator.

Contribuindo

Este projeto aceita contribuições e sugestões. Interessado em contribuir para o Azure Co-op Translator? Por favor, veja nosso CONTRIBUTING.md para orientações sobre como ajudar a tornar o Co-op Translator mais acessível.

Colaboradores

Código de Conduta

Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para mais informações, veja as Perguntas Frequentes sobre o Código de Conduta ou entre em contato pelo e-mail opencode@microsoft.com para dúvidas ou comentários adicionais.

IA Responsável

A Microsoft está comprometida em ajudar nossos clientes a usar nossos produtos de IA de forma responsável, compartilhando nossos aprendizados e construindo parcerias baseadas na confiança por meio de ferramentas como Notas de Transparência e Avaliações de Impacto. Muitos desses recursos podem ser encontrados em https://aka.ms/RAI. A abordagem da Microsoft para IA responsável está fundamentada em nossos princípios de IA: justiça, confiabilidade e segurança, privacidade e segurança, inclusão, transparência e responsabilidade.

Modelos de linguagem natural, imagem e fala em larga escala — como os usados neste exemplo — podem se comportar de maneiras injustas, não confiáveis ou ofensivas, causando danos. Por favor, consulte a nota de transparência do serviço Azure OpenAI para se informar sobre riscos e limitações. A abordagem recomendada para mitigar esses riscos é incluir um sistema de segurança em sua arquitetura que possa detectar e prevenir comportamentos prejudiciais. Azure AI Content Safety oferece uma camada independente de proteção, capaz de detectar conteúdo prejudicial gerado por usuários e por IA em aplicações e serviços. O Azure AI Content Safety inclui APIs de texto e imagem que permitem detectar material nocivo. Também temos um Content Safety Studio interativo que permite visualizar, explorar e testar códigos de exemplo para detectar conteúdo prejudicial em diferentes modalidades. A seguinte documentação de início rápido orienta você a fazer requisições ao serviço.

Outro aspecto a ser considerado é o desempenho geral da aplicação. Em aplicações multimodais e com múltiplos modelos, consideramos desempenho como o sistema funcionando conforme você e seus usuários esperam, incluindo não gerar saídas prejudiciais. É importante avaliar o desempenho da sua aplicação como um todo usando métricas de qualidade de geração, risco e segurança.

Você pode avaliar sua aplicação de IA no seu ambiente de desenvolvimento usando o prompt flow SDK. Dado um conjunto de dados de teste ou um alvo, as gerações da sua aplicação de IA generativa são medidas quantitativamente com avaliadores integrados ou avaliadores personalizados de sua escolha. Para começar a usar o prompt flow sdk para avaliar seu sistema, você pode seguir o guia de início rápido. Depois de executar uma avaliação, você pode visualizar os resultados no Azure AI Studio.

Marcas Registradas

Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado das marcas ou logotipos da Microsoft está sujeito e deve seguir as Diretrizes de Marca e Marca Registrada da Microsoft.
O uso de marcas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão nem implicar patrocínio da Microsoft.
Qualquer uso de marcas ou logotipos de terceiros está sujeito às políticas desses terceiros.

Obter Ajuda

Se você ficar preso ou tiver dúvidas sobre como construir aplicativos de IA, participe:

Se você tiver feedback sobre o produto ou encontrar erros durante o desenvolvimento, visite:

Aviso Legal:
Este documento foi traduzido utilizando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos para garantir a precisão, esteja ciente de que traduções automáticas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.

This site is open source. Improve this page.