Migrar para a CLI atual

Substitua os buckets e as impressões digitais do conteúdo de origem da versão anterior, mantendo as traduções aceites e a aplicação a funcionar.

A @lingo.dev/cli atual utiliza operações de envio e obtenção no servidor e mantém o estado do projeto em .lingo. O pacote lingo.dev anterior utiliza processamento local de buckets, i18n.json e i18n.lock. Migrar significa manter o comportamento de que o projeto precisa, não apenas mudar o nome de um comando.

Manter um ponto de partida funcional #

Registe a versão instalada e guarde o conteúdo de origem, as traduções de destino aceites, a configuração e o Lockfile antigo no controlo de versões. Confirme que a aplicação carrega essas traduções. Mantenha o encaminhador, o fornecedor, o seletor de idioma e o carregador de catálogos da configuração de localização existente até ter uma alternativa funcional de âmbito delimitado.

Registe as versões da framework e do ambiente de execução, bem como os idiomas de origem, de destino e predefinido necessários. Teste rotas representativas com prefixo de idioma, a deteção inicial, o mecanismo de recurso e a mudança de idioma. Mantenha estas verificações da aplicação separadas da migração da tradução de ficheiros.

Reconfigurar a seleção de ficheiros #

Crie .lingo/config.json com os idiomas de origem e de destino e entradas explícitas para os ficheiros. Em seguida, associe a organização autorizada e o motor de localização. Não basta mudar o nome dos buckets e das impressões digitais da versão anterior para os adaptar a este esquema.

A configuração atual da CLI suporta 22 formatos, incluindo HTML (.html e .htm), texto simples (.txt, uma unidade por linha, como na v0), tabelas CSV com uma coluna por idioma num único ficheiro e ficheiros Java .properties (uma unidade por chave, como na v0, com lockedKeys, preservedKeys e ignoredKeys a seguirem as mesmas regras de correspondência da v0, e lockedPatterns em sintaxe RE2, que não suporta asserções de antecipação ou retrospetiva nem retrorreferências). Antes de mover um ficheiro de agrupamento csv da v0, compare-o com a estrutura CSV. Compare os caminhos de um agrupamento properties da v0 com as propriedades Java: um nome de ficheiro [locale] como messages_[locale].properties passa a ser um padrão de origem como messages_en.properties. Os agrupamentos CSV por idioma, MJML e outros disponíveis apenas na versão antiga exigem uma conversão verificada ou outra via de tradução. A secção Configuração apresenta os valores exatos da enumeração, as regras de correspondência e os modelos de saída. As definições de modelo, instruções e URL base para fornecedores diretos da v0 não se aplicam a este esquema de projeto.

Verifique um ficheiro de origem selecionado e os caminhos de destino gerados a partir dele antes de alargar a configuração. Para propriedades de formatos da família Markdown, utilize translateComponentProps.

Adotar e atualizar traduções #

O planeamento atual, de âmbito limitado ou de inicialização, permite adotar traduções de destino existentes. Verifique ficheiros representativos e alterações feitas por pessoas antes de estabelecer essa base de referência: a simples existência dos ficheiros não confirma que os valores correspondem à versão mais recente do conteúdo de origem.

O preenchimento retroativo cria os ficheiros normais em falta, enquanto a v0 preenche habitualmente as chaves em falta nos catálogos existentes. Para esse trabalho posterior, utilize as atualizações incrementais atuais do conteúdo de origem ou o mecanismo suportado de atualização de chaves. Uma chave JSON com um novo nome é tratada como novo trabalho baseado no caminho, mesmo que o seu texto seja igual ao de uma chave antiga; não conte com a reutilização após mudanças de nome que a v0 permitia através das impressões digitais do conteúdo.

As alterações às traduções de destino podem ser mantidas durante o trabalho incremental se as respetivas chaves não tiverem mudado. As regras explícitas de preservação de chaves acrescentam uma decisão independente sobre quem as controla. Nos formatos com ficheiros separados, forçar o processamento do ficheiro inteiro elimina o contexto da tradução de destino atual e pode substituir formulações aceites, pelo que não serve de atalho para a adoção.

Concluir a primeira execução com a CLI atual #

Siga o guia de início rápido atual até concluir o preenchimento retroativo e obter os ficheiros. Um primeiro envio simples, sem uma base de referência, guarda os bytes do conteúdo de origem em vez de pedir as traduções iniciais. Aguarde ou obtenha os ficheiros antes de dar o workflow de ficheiros por concluído.

Inclua no mesmo commit a origem, o destino e a configuração aceites, bem como o Lockfile atual. O apontador para a execução mais recente mantém-se apenas no diretório pessoal e não é transferido através do Git. Uma operação de pull posterior compara os hashes; incluir apenas uma alteração divergente num commit não resolve esse conflito. lingo check substitui a antiga verificação baseada num Lockfile congelado ao nível dos ficheiros: falha se uma origem tiver sido alterada desde .lingo/lock.json ou se faltar um ficheiro de destino, e nunca cria um Lockfile em falta. Sem um Lockfile incluído num commit, não consegue detetar alterações na origem e verifica apenas se os ficheiros de destino existem.

Migração de React #

O workflow atual de React extrai as chamadas com texto literal de origem e contexto para JSONC e declarações, traduz os catálogos selecionados e carrega depois um mapa de cadeias de texto em tempo de execução. Verifique o mecanismo de recurso, as variáveis, a mudança de idioma e as formulações aceites de um componente antes de alargar a alteração.

Consulte Migrar mensagens React existentes e React para o trabalho específico do pacote. O lingo guide migrate incluído reflete a versão instalada; não garante paridade com todas as configurações geradas anteriormente.