Migrar para o Weblate

Está a utilizar uma plataforma de tradução diferente e está a considerar mudar para o Weblate? Este guia fornece um processo rápido, passo a passo para ajudá-lo a migrar o seu projeto de tradução de plataformas como Transifex, Crowdin, Lokalise, ou serviços semelhantes.

O Weblte é desenhado em torno de tradução contínua com integração Git na sua essência, fazendo-o ideal para equipas que pretendam manter traduções perto do seu fluxo de trabalho de desenvolvimento.

Veja também

• Começar com a internacionalização para escolher a estrutura de internacionalização correta

• Integrando com Weblate para opções de integração detalhadas

• Tradução contínua para configurar fluxos de trabalho automatizados

Pré-requisitos

Antes de começar a sua migração, certifique-se que tem:

Na sua plataforma de tradução:

• Aceda para exportar os seus ficheiros de tradução

• Lista de tradutores e os seus papéis/permissões

• Compreender o seu fluxo de trabalho atual (processo de revisão, automação, etc.)

Para o Weblate:

• Uma instância Weblate (ou Hosted Weblate ou self-hosted)

• Permissões de administrador ou de criação de projeto na sua instância Weblate

Prepare os seus ficheiros de tradução

Exporte traduções da sua plataforma atual

A maior parte das plataformas de tradução permite-lhe exportar todas as traduções de uma só vez:

• Transifex: Utilize a ferramenta CLI deles ou descarregue traduções a partir da interface web

• Crowdin: Exporte todas as traduções enquanto um ficheiro ZIP nas definições de projeto

• Lokalise: Utilize a funcionalidade de exportação em massa

• Phrase: Descarregue todas as traduções do painel do projeto

Dica

Mantenha os seus ficheiros de tradução no formato nativo da sua estrutura de internacionalização (PO, XLIFF, JSON, etc.) em vez de convertê-los. O Weblate suporta vários formatos.

Enviar traduções para o seu repositório Git

Dica

Se prefere não armazenar traduções em um repositório Git externo, pode ignorar este passo e usar a opção Enviar ficheiros de tradução ao criar um componente.

Se as suas traduções ainda não estão no Git:

1. Criar um repositório Git ou utilizar o seu repositório de projeto existente

2. Organiza ficheiros de tradução que seguindo a sua estrutura do projeto

3. Dê commit e push dos ficheiros para o seu serviço de alojamento Git (GitHub, GitLab, Bitbucket, etc.)

git add locales/
git commit -m "Add translation files for Weblate migration"
git push origin main

Veja também

• Tradução contínua para estrutura de repositório ótima

• Integração de controlo de versões suportado para sistemas de controlo de versão

Importe o seu projeto para o Weblate

Criar um projeto

1. Navegue à sua instância do Weblate.

2. Clique Adicionar novo projeto de tradução no menu +.

3. Preencha os detalhes do seu projeto:

   • Nome do projeto: O nome da aplicação ou projeto

   • URL abreviado: Identificador curto (p.ex., myapp)

   • Website do projeto: A sua página inicial do projeto (opcional)

Veja também

Adicionar projetos e componentes de tradução para instruções de criação de projeto detalhada

Um componente adicionado a partir do seu repositório Git

1. Após criar o projeto, clique em Adicionar novo componente de tradução

2. Selecionar A partir de controlo de versão

3. Configure o seu componente:

   • Nome do componente: p.ex., «Cadeias de carateres da aplicação», «Website», «Documentação»

   • URL de repositório: O seu URL do repositório Git (HTTPS ou SSH)

   • Ramo do repositório: Opcional: Especifica o ramo de repositório (o Weblate deteta automaticamente o ramo padrão se não for especificado)

4. O Weblate detetará automaticamente:

   • Formato de ficheiro de tradução

   • Idiomas disponíveis

   • Idioma fonte

5. Analise e confirme as cadeias de carateres detetadas

Nota

Se o seu repositório contém uma .tx/config Transifex, o Weblate analisa-o usando o localizador de traduções e oferece configurações correspondentes de componente durante a descoberta. Isto apenas cobre configurações relacionadas a ficheiros, tais como máscaras de ficheiros e ficheiros fonte. Outras definições de projeto da plataforma prévia, incluindo fluxos de trabalho, permissões e aliases de idiomas, ainda precisam de ser configurado manualmente no Weblate.

Alias de idiomas normalmente não são precisos porque o Weblate já reconhece e normaliza variante de código de idioma comuns ao analisar ficheiros de tradução. Veja Analisando códigos de idioma; configure Aliases do idioma apenas se o seu repositório utiliza códigos que o Weblate não consegue mapear conforme previsto.

Dica

Para repositórios com múltiplos componentes de tradução (p.ex., ficheiros separados para backend, frontend, documentação), crie um componente Weblate separado para cada.

Pode acelerar isto usando A partir de componente existente para repositórios partilhados ou Descoberta de componentes para criá-los automaticamente.

Veja também

• Configuração de componente para todas as opções de configuração

• Formatos bilíngues e monolíngues para perceber formatos monolingues vs. bilingues

• Descoberta de componentes

Configure o seu fluxo de trabalho

Definir controlo de acesso

Escolha a visibilidade e nível de acesso do projeto:

1. Vá às suas definições de projeto: separador Operations → Settings → Access

2. Selecione o controlo de acesso apropriado:

   • Public: Projetos de código aberto, qualquer pessoa pode contribuir

   • Protegido: Visíveis para todos, mas apenas utilizadores convidados podem traduzir

   • Privado: Apenas utilizadores convidados podem visualizar e traduzir

Veja também

Gerir controlo de acesso por projeto para configuração de controlo de acesso detalhada

Definir tradução contínua

Ativa atualizações automáticas e commits:

1. Configurar repositório de integração:

   • Pull changes: Defina um webhook para que o Weblate atualize quando o seu código fonte muda

   • Enviar mudanças: Configure Fazendo push das alterações do Weblate para que traduções sejam enviadas de volta para o seu repositório

2. Ativa ações automática nas definições de componente:

   • Dar push ao dar commit: Automaticamente envia traduções para o seu repositório

   • Intervalo de commit: Defina o quão frequente traduções pendentes são enviadas (p.ex., a cada 24 horas)

Veja também

Tradução contínua para automação de fluxo de trabalho completo

Configura verificações de qualidade e fluxos de trabalho

Personalizar controlos de qualidade de tradução:

1. Ativar verificações: Reveja Verificações de qualidade e ative as verificações de qualidade opcionais que precisa.

2. Definir fluxo de trabalho de revisão: Ative Activar revisões se quer um processo de aprovação.

3. Adicionar verificações obrigatórias: Configura quais verificações de qualidade devem bloquear traduções.

Opcional: Ativa extras

O Weblate oferece Extensões para automatizar tarefas comuns:

• Atualizar ficheiros PO para coincidir com POT (msgmerge): Atualiza automaticamente ficheiros PO a partir de modelos POT

• Limpeza de ficheiros de tradução: Remove cadeias de carateres inutilizadas

• Squash de commits git: Dá squash aos commits antes de enviar para o seu repositório

• Descoberta de componentes: Agora descobre automaticamente novos ficheiros de tradução

Veja também

Extensões para todos os extras disponíveis

Testar e verificar

Antes de anunciar a migração para os seus tradutores:

1. Teste o fluxo de trabalho:

   • Criar uma tradução teste

   • Verifique que a mesma aparece no seu repositório Git

   • Testa o obter de mudanças a partir do seu repositório para o Weblate

2. Importar quaisquer memória de tradução existente (opcional):

   • Utilize Memória de Tradução para importar traduções prévias

   • Isto ajuda com consistência e acelera tradução

3. Configurar notificações:

   • Configure Notificações para eventos de tradução

   • Configure Hooks de notificação de repositório para o seu serviço de alojamento Git

Veja também

Memória de Tradução para gestão de memória de tradução

Convidar e gerir utilizadores

Convidar tradutores

Para projetos Protegidos e Privados:

1. Navegue para Operações → Utilizadores no seu projeto

2. Utilize Adicionar utilizador para convidar tradutores

3. Atribua-os a equipas adequadas:

   • Tradutores: Podem traduzir cadeias de carateres

   • Revisores: Podem analisar e aprovar traduções

   • Gestores: Podem gerir definições de projeto

Para projetos Públicos, utilizadores podem começar a contribuir imediatamente após inscreverem-se.

Dica

Envie aos seus tradutores uma mensagem de boas vindas acolhedora com:

• Link para o seu projeto no Weblate

• Sinopse de qualquer terminologia específica ao projeto ou guias de estilo

• Informação sobre o seu processo de revisão

Veja também

• Gerir controlo de acesso por projeto para gestão de equipas

• Controlo de acesso para configuração de permissão avançada

Próximos passos

Após completar a migração:

• Anunciar a tradutores: Informe a sua equipa de tradução sobre a migração com instruções claras

• Monitorizar utilização inicial: Esteja atento a quaisquer problemas durante os primeiros dias

• Recolher feedback: Peça aos tradutores sobre a sua experiência comparada à plataforma prévia

• Otimizar fluxo de trabalho: Ajuste definições baseadas nas necessidades da sua equipa

• Remover plataforma prévia: Quando a migração for completada, lembre-se de revogar acesso garantida à plataforma prévia.

Dica

Durante a migração, pode executar ambas as plataformas em paralelo para um período de transição para certificar-se que tudo funciona conforme esperado antes de mudar completamente.

Recursos adicionais

• Integrando com Weblate - Padrões de integração detalhados

• Fluxos de trabalho de tradução - Diferentes configurações de fluxo de trabalho

• Tradução contínua - Tradução contínua automática

• API REST do Weblate - API para automação e integrações

• Relatório de progresso da tradução - Configurar relatórios de progresso de tradução

• Perguntas Mais Frequentes - Perguntas frequentemente colocadas

Dica

Junte-se à comunidade Weblate se quiser ajudar durante a sua migração. A comunidade é ativa e útil!