GitHub (Strings)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Dica

Para obter informações sobre integração do GitHub no Phrase TMS, consulte GitHub (TMS).

Requisitos

O arquivo de configuração .phrase.yml deve estar presente na raiz do ramo a ser monitorado. O arquivo define quais arquivos importar (pull) ou exportar (push) do repositório.
O acesso à leitura e edição é necessário no repositório.
Arquivos de configuração com definição incorreta podem causar erros. Certifique-se de que o arquivo contenha pelo menos um destino de push e pull, os formatos de arquivo corretos e a configuração correta do parâmetro update_translations.
Token de acesso do GitHub:
- Tokens clássicos
  
  Exige o escopo do repositório (public_repo se sincronizado com um repositório público)
- Tokens de grãos finos
  
  Exige as seguintes permissões:
  - Conteúdo: Leitura e edição
  - Solicitações pull: Leitura e edição
Se o logon único estiver ativado no GitHub, ele também precisa estar ativado para o token de acesso.
O ramo phrase_translations não pode ser protegido.
Certifique-se de que as configurações do repositório não exigem confirmações assinadas.

Nota

Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.

Conectar repositórios

Ao encontrar o arquivo de configuração, para conectar um repositório, execute estas etapas:

Na página de Integrações role para baixo até o conector GitHub Sync e clique em configurar.

A página Sincronizações do Repositório é aberta.
Clique em Adicionar sincronização/GitHub.

A janela Sincronização GitHub configurações é aberta.
Selecione um projeto da lista suspensa.
Opcionalmente, selecione uma instância de host próprio e forneça o endpoint da API de host próprio do GitHub.
Forneça um token de acesso do repositório pessoal com um escopo de API.
Selecione um repositório GitHub a partir da lista suspensa.
Selecione um ramo repositório da lista suspensa para importar (push) e exportar (pull). Este é geralmente o ramo mestre.
Clique em Validar configuração para certificar-se de que o token de acesso e o arquivo de configuração estão corretos.
Opcionalmente selecione importar automaticamente para importar arquivos com cada confirmação para o ramo GitHub selecionado.
Clique em Gravar.

O projeto está agora conectado ao repositório GitHub selecionado e adicionado à lista.

Importar arquivos como

Certifique-se de que os comandos push estão configurados corretamente no arquivo de configuração .phrase.yml. As opções de push são as mesmas do endpoint da API uploads.

Para importar arquivos:

Na página Sincronização do Repositório, selecione um projeto e clique em Importar .

Arquivos de idioma (definidos como entradas de texto original push no arquivo de configuração) são importados no projeto.

Um local padrão deve estar presente.

Nota

Em caso de problemas ao importar, use o cliente CLI para testar o arquivo de configuração .phrase.yml localmente e verificar quaisquer mensagens de Erros.

Se necessário, entre em contato com o suporte técnico do phrase e anexe o arquivo de configuração .phrase.yml à solicitação de suporte.

Exportar arquivos

Certifique-se de que os comandos pull estão configurados corretamente no arquivo de configuração .phrase.yml. As opções pull (p.ex., parâmetro include_empty_translations) são as mesmas do endpoint da API locals download.

Para exportar arquivos:

Na página Sincronização do Repositório, selecione um projeto e clique em Exportar .

Os arquivos de idioma mais recentes no repositório são exportados como uma nova solicitação de pull.
Assim que os arquivos forem exportados, a solicitação de pull pode ser mesclada ou fechada no repositório e o ramo pode ser excluído.

Nota

Em caso de problemas ao exportar, use o cliente CLI para testar o arquivo de configuração .phrase.yml localmente e verificar quaisquer mensagens de Erros.

Se necessário, entre em contato com o suporte técnico do phrase e anexe o arquivo de configuração .phrase.yml à solicitação de suporte.

Histórico

Sincronizações do repositório mantêm um histórico das últimas importações e exportações para cada projeto Phrase Strings.

Para ver o histórico:

Na página Sincronização do Repositório, selecione um projeto e clique em de histórico.

O histórico de importar e exportar para o projeto é apresentado. As entradas exportadas no histórico incluem um link para a solicitação de merge correspondente.