Dica
Para obter informações sobre a integração do GitHub no Phrase TMS, consulte GitHub (TMS).
Pré-requisitos
-
O
.phrase.ymlconfiguração file deve estar presente na raiz da ramificação a ser monitorada. O arquivo define quais arquivos importar (pull) ou exportar (push) do repositório. -
O acesso de leitura e gravação é necessário para o repositório.
-
Arquivos de configuração definidos incorretamente podem causar erros. Certifique-se de que o arquivo contenha pelo menos um destino de envio e um destino de pull, os formatos de arquivo corretos e a configuração correta do
update_translationsparâmetro. -
-
Tokens clássicos
Requer o escopo do repositório (
public_repose estiver sincronizando com um repositório público) -
Tokens refinados
Requer as seguintes permissões:
-
Conteúdo: Leitura e edição
-
Solicitações de pull: Leitura e edição
-
-
-
Se o SSO estiver habilitado no GitHub, ele também deverá ser habilitado para o token de acesso.
-
O phrase_translations branch não pode ser protegido.
-
Certifique-se de que as configurações do repositório não exijam confirmações assinadas.
Nota
Devido a melhorias contínuas, a interface do usuário pode não ser exatamente a mesma apresentada no vídeo.
Depois que o arquivo de configuração estiver em vigor, para conectar um repositório, siga estas etapas:
-
Do , role para baixo até a página conector e clique em Configurar.
O é aberta.
-
Clique Adicionar sincronização/GitHub.
O A janela Configurações é aberta.
-
Selecione um projeto na lista suspensa.
-
Opcionalmente, selecione e fornecer o GitHub auto-hospedado .
-
Selecione um na lista suspensa.
-
Selecione um na lista suspensa para importar (push) e exportar (pull) de. Este é geralmente o ramo mestre.
-
Clique Validar configuração para garantir que o token de acesso e o arquivo de configuração estejam corretos.
-
Opcionalmente, selecione para importar arquivos com cada commit para o branch GitHub selecionado.
-
Clique em Salvar.
O projeto agora está conectado ao repositório GitHub selecionado e adicionado à lista.
Certifique-se de que os comandos push estejam configurados corretamente no.phrase.yml configuração arquivo. As opções de push são as mesmas doUploadsPonto de extremidade da API.
Para importar arquivos:
-
Do , selecione um projeto e clique em Importação
.
Os arquivos de idioma (definidos como entradas de origem push no arquivo de configuração) são importados para o projeto.
Uma localidade padrão deve estar presente.
Nota
Em caso de problemas na importação, use o CLI cliente para testar o
.phrase.ymllocalmente e verifique se há mensagens de erro.Se necessário, entre em contato com o suporte técnico da Phrase e anexe o
.phrase.ymlarquivo de configuração para a solicitação de suporte.
Certifique-se de que os comandos pull estejam configurados corretamente no.phrase.yml configuração arquivo. Opções de puxar (por exemplo, include_empty_translations parâmetro) são os mesmos que para o parâmetrolocales baixarPonto de extremidade da API.
Para exportar arquivos:
-
Do , selecione um projeto e clique em Exportação
.
Os arquivos de idioma mais recentes no repositório são exportados como uma nova solicitação de pull.
-
Depois que os arquivos são exportados, a solicitação de pull pode ser mesclada ou fechada no repositório e a ramificação pode ser excluída.
Nota
Em caso de problemas na exportação, use o botão CLI cliente para testar o .phrase.yml localmente e verifique se há mensagens de erro.
Se necessário, entre em contato com o suporte técnico da Phrase e anexe o.phrase.ymlarquivo de configuração para a solicitação de suporte.
As sincronizações de repositório mantêm um histórico das importações e exportações mais recentes para cada projeto de Strings de Frase.
Para visualizar o histórico: