Início rápido

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

Descontinuado

Esta documentação abrange a CLI antiga (v0). A versão atual da CLI é a v1. Ver a documentação atual da CLI

Comece a usar a CLI em menos de 5 minutos.

Pré-requisitos

Certifique-se de que tem o Node.js 18.0 ou superior instalado. Execute node --version para confirmar.

Instalação#

Instale a CLI globalmente com o gestor de pacotes que preferir:

bash
npm install -g lingo.dev

Verificar a instalação#

Confirme que a CLI foi instalada corretamente:

bash
lingo --version

Deverá ver um resultado semelhante a este:

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

Inicialize o seu projeto#

Vá até à pasta do seu projeto e execute:

bash
cd my-project
lingo init

Este comando interativo vai:

  1. Ligar à sua conta - Autenticar com a sua chave de API
  2. Selecionar um projeto - Escolher um projeto existente ou criar um novo
  3. Configurar idiomas - Selecionar os idiomas a suportar
  4. Configurar a estrutura de ficheiros - Escolher onde guardar os ficheiros de tradução

Configuração criada

A CLI cria um ficheiro i18n.json com as suas definições. Pode alterá-lo mais tarde, se necessário.

A sua primeira tradução#

Crie um ficheiro de tradução simples:

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

Executar traduções#

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

bash
lingo run

A CLI vai:

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

Modo watch (desenvolvimento)#

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

bash
lingo run --watch

Prima Ctrl+C para sair do modo watch.

Obter ajuda#

Precisa de ajuda?

bash
# Show help for all commands
lingo --help

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

Junte-se à nossa comunidade no Discord para obter ajuda em tempo real!

Próximos passos#