Pular para o conteúdo
Pular para o conteúdo

Docs / Guias

Página traduzida automaticamente

Esta página foi traduzida automaticamente, então pode ter erros ou soar um pouco estranha. A versão em inglês é a fonte da verdade. Ler o original em inglês.

Ver arquivos alterados no Studio

Veja quais arquivos de locale diferem do último commit do git e quais chaves mudaram em cada um, na página Overview do Verbatra Studio.

novo

Use isto antes de fazer commit de uma execução: o Studio mostra quais arquivos de locale uma execução de tradução ou uma edição tocou, e quais chaves mudaram em cada um, sem sair dele. Ele só lê; o Studio nunca coloca nada na área de stage, nunca faz commit e nunca restaura nada.

Abrir a seção Changes

Inicie o Studio (Revisar no Studio) e role a página Overview (visão geral) até Changes (alterações), abaixo da tabela de locales. Ela mostra o branch em checkout (ou Detached HEAD, o HEAD desanexado) e lista todos os arquivos que diferem do último commit, dez por vez, com Show all N files (mostrar todos os N arquivos) para o restante:

EstadoSignificado
Modifiedo arquivo difere do último commit
Addedo arquivo é novo e está na área de stage
Deletedo arquivo sumiu da árvore de trabalho ou do índice
Untrackedo git ainda não rastreia o arquivo
Conflictedo arquivo tem conflitos de merge não resolvidos
Matches last commitum arquivo que você abriu e que não difere mais, mantido no lugar até você fechá-lo

Seus arquivos de locale de origem e de destino aparecem na lista, assim como verbatra.lock.json e verbatra.provenance.json, que mostram um estado e nenhuma alteração de chave. Um projeto limpo informa que nenhum arquivo de locale difere.

Ler as alterações de chaves

Key changes (de) (alterações de chaves) abre o arquivo desse locale como chaves, comparado com o último commit: chaves Changed (alteradas) com o texto antigo e o novo lado a lado, chaves Added (adicionadas) e chaves Removed (removidas). Clique no botão de novo para fechar; só um locale fica aberto de cada vez. Uma chave alterada ou adicionada que a origem também tem leva à sua entrada na página Translations (traduções).

  • Um arquivo, vários locales: um catálogo como apple-xcstrings guarda todos os locales em um só arquivo, então tem um botão por locale. Cada um compara apenas aquele locale.
  • Listas longas: uma lista contém no máximo 500 chaves e cada texto é cortado em 2.000 caracteres. Quando isso acontece, o Studio avisa que a lista está incompleta e marca o texto cortado; o próprio git tem a diferença completa. Uma lista longa mostra 50 chaves por vez.
  • Só a ordem mudou: um arquivo alterado cujas chaves e textos são os mesmos informa isso.
  • Conflitos: um arquivo com conflitos de merge não resolvidos mostra seu estado e nenhuma alteração de chave. Resolva os conflitos no git primeiro.
  • Texto seguro: chaves e valores aparecem como texto simples, no idioma e na direção do próprio locale, nunca como marcação.

Quando não há nada para mostrar

Quando não consegue comparar, o Studio explica em vez de relatar um erro, por exemplo quando:

  • o projeto não está em um repositório git, ou o git não está instalado ou é mais antigo do que um clone parcial exige;
  • o git recusa a pasta porque outro usuário é o dono dela, ou a pasta está dentro de um repositório bare;
  • o repositório configura um filtro de conteúdo, que o Studio não executa;
  • um files.pattern coloca um arquivo de locale fora da pasta do projeto, por exemplo com ../, de modo que uma lista poderia deixar esse arquivo de fora.

Uma leitura que demorou demais ou falhou mostra o erro da página com seu botão Retry (tentar de novo). Um projeto com um formato custom: mostra seus arquivos alterados, mas nunca as alterações de chaves: o Studio compara o arquivo versionado apenas com os adaptadores de formato embutidos, que não conseguem executar um adaptador personalizado. Veja Escrever um adaptador de formato personalizado.

Saber o quão recente é

A seção lê de novo quando um arquivo de locale, de lock ou de procedência muda no disco, quando o índice do git ou o HEAD muda (um commit, uma troca de branch, um reset ou um git add) e quando você volta à aba ou à janela do Studio. Se uma leitura falha, o Studio mantém a última resposta e informa isso.

As mesmas leituras estão disponíveis para o seu próprio código como localeGitStatus e localeGitDiff, que listam todos os motivos pelos quais uma comparação pode ficar indisponível e as salvaguardas do git que elas aplicam.

Editar no GitHub

Nesta página