Guia rápido

Max PrilutskiyCEO e cofundadorAtualizado em: há 3 meses · 2 min de leitura

Obsoleto

Esta documentação cobre o CLI legado (v0). O CLI atual é o v1. Veja a documentação atual da CLI

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#