co-op-translator

Co-op Translator

Automatize facilmente a tradução do seu conteúdo educativo no GitHub para múltiplas línguas e alcance um público global.

🌐 Suporte Multilíngue

Suportado pelo Co-op Translator

Visão Geral

Co-op Translator ajuda a localizar o seu conteúdo educativo no GitHub em várias línguas de forma simples. Quando atualiza os seus ficheiros Markdown, imagens ou notebooks, as traduções mantêm-se automaticamente sincronizadas, garantindo que o seu conteúdo está sempre correto e atualizado para aprendizes em todo o mundo.

Exemplo de como o conteúdo traduzido é organizado:

Example

Início rápido

# Criar e ativar um ambiente virtual (recomendado)
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
# Instalar 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 ficheiro .env usando o modelo: .env.template
Configure um fornecedor LLM (Azure OpenAI ou OpenAI)
(Opcional) Para tradução de imagens (-img), configure o Azure AI Vision
(Recomendado) Limpe quaisquer traduções anteriores para evitar conflitos (ex.: translations/)
(Recomendado) Adicione uma secção de tradução ao seu README usando o modelo de línguas para README
Veja: Configurar Azure AI

Utilização

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 automática para Markdown, notebooks e imagens
Mantém as traduções sincronizadas com as alterações na origem
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 Microsoft

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

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

Apoie-nos e promova a aprendizagem global

Junte-se a nós para revolucionar a forma como o conteúdo educativo é partilhado globalmente! Dê uma ⭐ ao Co-op Translator no GitHub e apoie a nossa missão de derrubar barreiras linguísticas na aprendizagem e tecnologia. O 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 conteúdo educativo Microsoft na sua língua

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 sobre como usar o Co-op Translator.

Contribuir

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

Contribuidores

Código de Conduta

Este projeto adotou o Código de Conduta Open Source da Microsoft. Para mais informações, consulte as FAQ do Código de Conduta ou contacte opencode@microsoft.com para quaisquer dúvidas ou comentários adicionais.

IA Responsável

A Microsoft está comprometida em ajudar os seus clientes a usar os nossos produtos de IA de forma responsável, partilhando as nossas aprendizagens e construindo parcerias baseadas na confiança através de ferramentas como Notas de Transparência e Avaliações de Impacto. Muitos destes recursos podem ser encontrados em https://aka.ms/RAI. A abordagem da Microsoft à IA responsável baseia-se nos nossos princípios de IA: justiça, fiabilidade e segurança, privacidade e segurança, inclusão, transparência e responsabilidade.

Modelos de larga escala para linguagem natural, imagem e voz — como os usados neste exemplo — podem comportar-se de formas injustas, pouco fiáveis ou ofensivas, causando danos. Por favor, consulte a nota de transparência do serviço Azure OpenAI para estar informado sobre riscos e limitações. A abordagem recomendada para mitigar estes riscos é incluir um sistema de segurança na sua arquitetura que possa detetar e prevenir comportamentos prejudiciais. O Azure AI Content Safety fornece uma camada independente de proteção, capaz de detetar conteúdos prejudiciais gerados por utilizadores e por IA em aplicações e serviços. O Azure AI Content Safety inclui APIs de texto e imagem que permitem detetar material prejudicial. Também dispomos de um Content Safety Studio interativo que permite visualizar, explorar e experimentar código de exemplo para detetar conteúdos prejudiciais em diferentes modalidades. A seguinte documentação de início rápido orienta-o na realização de pedidos ao serviço.

Outro aspeto a ter em conta é o desempenho geral da aplicação. Em aplicações multimodais e com múltiplos modelos, consideramos desempenho como o facto do sistema funcionar conforme o esperado por si e pelos seus utilizadores, incluindo não gerar resultados prejudiciais. É importante avaliar o desempenho da sua aplicação global utilizando métricas de qualidade de geração e de risco e segurança.

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

Marcas Registadas

Este projeto pode conter marcas registadas ou logótipos de projetos, produtos ou serviços. O uso autorizado das marcas ou logótipos da Microsoft está sujeito e deve seguir as Diretrizes de Marcas e Identidade da Microsoft.
O uso de marcas ou logótipos 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 logótipos de terceiros está sujeito às políticas desses terceiros.

Obter Ajuda

Se ficar bloqueado ou tiver dúvidas sobre como criar aplicações de IA, junte-se a:

Se 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 automática Co-op Translator. Embora nos esforcemos para garantir a precisão, por favor tenha em conta que traduções automáticas podem conter erros ou imprecisões. O documento original na sua língua nativa deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações erradas decorrentes do uso desta tradução.

This site is open source. Improve this page.