Localização do GitHub
Automatize a localização do GitHub integrando com a PTC. Receba pull requests automáticos contendo traduções com qualidade humana.
Como integrar o GitHub à PTC
A PTC se conecta ao seu repositório do GitHub e mantém seus arquivos de recursos traduzidos enquanto você trabalha. Faça o push das alterações no seu código e a PTC as detectará automaticamente, traduzirá as strings atualizadas e abrirá um pull request — tudo isso sem nenhuma etapa manual da sua parte.
A integração com Git é um recurso Pro. Ela fica disponível quando você ativa o Pay-As-You-Go.
Conecte seu repositório
Começar a usar a integração com o GitHub é fácil:
- Se você já tem uma conta na PTC e está criando um novo projeto, selecione Integração com Git no assistente de configuração.
- Se você começou com um upload manual de arquivos, pode mudar para um fluxo de trabalho contínuo baseado no Git a qualquer momento. Acesse Configurações → Merge Requests e clique em Add Git Integration.
Em ambos os casos, você verá uma tela onde poderá inserir o URL do seu projeto dentro do repositório. A PTC detectará automaticamente o serviço que você está usando.
Autentique-se no GitHub
Para dar à PTC acesso ao seu repositório, você pode usar um token de acesso (recomendado) ou fazer login com OAuth. Se você se conectar usando um token de acesso, certifique-se de que ele inclua os escopos corretos e o acesso ao repositório.
| Onde criá-lo | Proprietário do recurso | Permissões necessárias | Acesso ao repositório | |
|---|---|---|---|---|
| Personal Fine-Grained Token | Personal access tokens em Developer Settings | Sua conta de usuário do GitHub | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Escolha “Only select repositories” (recomendado) ou “All repositories” |
| Organization Fine-Grained Token | Personal access tokens em Developer Settings Importante: a criação de um token de acesso Fine-Grained pode ser restrita pelas políticas de acesso da sua organização. Se você não conseguir criar o token, peça a um administrador da organização para revisar as configurações de Personal Access Token Policy no GitHub. |
A organização do GitHub | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Escolha “Only select repositories” (recomendado) ou “All repositories” |
Armazene o token com segurança e adicione-o à PTC. Ela verificará suas permissões e solicitará que você escolha quais branches monitorar.
Traduza arquivos no seu repositório com a PTC
Assim que o seu repositório do GitHub estiver conectado à PTC, continue a configuração para adicionar idiomas e os detalhes do projeto.
Embora a PTC possa trabalhar com os arquivos de tradução existentes no seu repositório, traduzir todo o seu projeto com a PTC garante consistência em todos os idiomas.
Verifique os pull requests
A PTC normalmente leva apenas alguns minutos para traduzir os arquivos na branch selecionada do GitHub. Após a conclusão, a PTC enviará a você um e-mail com um link para o pull request.
Revise e aprove o pull request quando estiver pronto. As traduções da PTC têm qualidade de produção e podem passar por merge sem revisão manual.
Depois de fazer o merge das primeiras traduções, a PTC continua a monitorar seus arquivos de recursos e enviará novos pull requests com traduções atualizadas sempre que alterações forem detectadas.
Como gerar novos pull requests manualmente
Acesse a aba Translations na PTC para ver as traduções em cada idioma que você selecionou, organizadas em uma tabela. A partir desta página, você pode fazer edições ou pedir à PTC para retraduzir — por exemplo, quando as traduções excederem um limite de comprimento.
Clique em Create a merge request para enviar um novo pull request com as traduções atualizadas.
Adicione novos arquivos de recursos para tradução
Se você adicionar novos arquivos de recursos ao seu repositório após se conectar à PTC, poderá pedir à PTC para verificá-los.
- Acesse Configurações → Arquivos Monitorados e clique em Rescan your repository. A PTC escaneará o seu repositório e exibirá os arquivos recém-descobertos como rascunhos.
- Clique no ícone + ao lado de um arquivo descoberto para incluí-lo na tradução e, em seguida, clique em Save with translation para confirmar.
Marque a caixa de seleção Automatically include new translation files para que a PTC monitore e inclua arquivos de recursos recém-descobertos sem pedir confirmação a cada vez.
Por que localizar seus projetos do GitHub com a PTC
Conexão fácil ao seu repositório
A PTC se integra diretamente ao seu repositório do GitHub, eliminando uploads e downloads manuais de arquivos, ou a necessidade de executar scripts de tradução.
Sincronização em tempo real
A PTC monitora seu repositório do GitHub em busca de alterações nos arquivos de recursos, gera traduções automaticamente e as envia de volta via pull requests.
Localização mais rápida para mercados globais
A PTC acelera o processo de localização ao entregar traduções de alta qualidade automaticamente via pull requests. Adapte rapidamente seu software para os mercados globais e reduza seu tempo de lançamento no mercado.
Apenas o acesso ao repositório de que ela precisa
A PTC usa acesso de leitura para detectar alterações nos seus arquivos de recursos e acesso de gravação para entregar traduções via pull requests. A PTC interage apenas com os arquivos que gerencia para tradução e não faz alterações em nenhuma outra parte do seu repositório.
Uma localização que acompanha o seu ciclo de lançamento
A PTC foi projetada para equipes de desenvolvimento que desejam que a localização avance no mesmo ritmo que o seu código. A PTC monitora seu repositório em busca de strings novas ou atualizadas e entrega as traduções de volta automaticamente via pull request, para que a localização nunca se torne um gargalo no seu ciclo de lançamento.
Ela funciona com os formatos de arquivo comuns no desenvolvimento de software e aplicativos móveis, incluindo arquivos PO e arquivos JSON. Para mais informações sobre como a PTC se encaixa nesses fluxos de trabalho, consulte nossas páginas de localização de software e localização de aplicativos móveis.
Funciona com GitHub, GitLab e Bitbucket
Além do GitHub, a PTC se integra ao GitLab e ao Bitbucket, oferecendo os mesmos fluxos de trabalho e recursos de localização automatizada para cada plataforma.
Incluído sem custo extra
A integração com o GitHub está incluída sem custo extra. A PTC não tem taxas de assinatura ou cobranças por recurso. Você só paga pelas palavras que traduzir, e as primeiras 500 palavras de cada mês são gratuitas. Para ver todos os detalhes de preços, consulte a página de preços.