|Labs
Agende uma demoPlataforma
React (Lingo Compiler)
Alpha
React (MCP)React (i18n)CLI legado (v0)
Descontinuado

Lingo.dev CLI

  • Como funciona
  • Configuração
  • Guia rápido
  • Monorepos

Configuração

  • Formatos compatíveis
  • i18n.json
  • i18n.lock
  • Idiomas compatíveis

Recursos

  • Traduções existentes
  • Adicionar idiomas
  • Sobrescritas
  • Notas do tradutor
  • Chaves de tradução
  • Renomeação de chaves
  • Bloqueio de chaves
  • Ignorar chaves
  • Preservação de chaves
  • Extraia chaves com IA

Desempenho

  • Projetos de grande porte
  • Processamento paralelo
  • Estimativa de custo

Retradução

  • Retradução automática
  • Retradução
  • Remover traduções

Esta documentação cobre o CLI legado (v0) e foi descontinuada. A versão atual do CLI é a v1. Veja a documentação do CLI atual

Guia rápido

Comece a usar a CLI em menos de 5 minutos.

Pré-requisitos

Certifique-se de ter o Node.js 18.0 ou superior instalado. Execute node --version para verificar.

Instalação#

Instale a CLI globalmente usando o gerenciador de pacotes que preferir:

bash
npm install -g lingo.dev

Verifique a instalação#

Confirme se a CLI foi instalada corretamente:

bash
lingo --version

Você deverá ver uma saída como esta:

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

Inicialize seu projeto#

Acesse o diretório do seu projeto e execute:

bash
cd my-project
lingo init

Este comando interativo vai:

  1. Conectar à sua conta - Autenticar com sua chave de API
  2. Selecionar um projeto - Escolher um projeto existente ou criar um novo
  3. Configurar idiomas - Selecionar quais idiomas terão suporte
  4. Definir a estrutura de arquivos - Escolher onde armazenar os arquivos de tradução

Configuração criada

A CLI cria um arquivo i18n.json com suas configurações. Você pode editar esse arquivo depois, se precisar.

Sua primeira tradução#

Crie um arquivo de tradução simples:

json
{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

Execute as traduções#

Traduza seu conteúdo para todos os idiomas de destino configurados:

bash
lingo run

A CLI vai:

  • ✅ Encontrar seus arquivos de origem
  • ✅ Calcular um delta em relação ao lockfile
  • ✅ Enviar o conteúdo alterado para seu backend de tradução
  • ✅ Salvar as traduções em disco

Modo watch (desenvolvimento)#

Durante o desenvolvimento, ative o modo watch para retraduzir automaticamente sempre que os arquivos de origem mudarem:

bash
lingo run --watch

Pressione Ctrl+C para sair do modo watch.

Ajuda#

Precisa de ajuda?

bash
# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

Entre na nossa comunidade no Discord para receber suporte em tempo real!

Próximos passos#

Extraia chaves com IA
Configure seu i18n com ajuda de IA
Chaves de tradução
Bloqueie, ignore e renomeie chaves
Idiomas compatíveis
Mais de 100 idiomas e variantes
Formatos compatíveis
JSON, YAML, Markdown e muito mais

Esta página foi útil?

Max PrilutskiyMax Prilutskiy·Atualizado há 5 dias·2 min de leitura