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:
npm install -g lingo.devVerifique a instalação#
Confirme se a CLI foi instalada corretamente:
lingo --versionVocê deverá ver uma saída como esta:
lingo.dev v0.133.9
Node.js v20.10.0Inicialize seu projeto#
Acesse o diretório do seu projeto e execute:
cd my-project
lingo initEste comando interativo vai:
- Conectar à sua conta - Autenticar com sua chave de API
- Selecionar um projeto - Escolher um projeto existente ou criar um novo
- Configurar idiomas - Selecionar quais idiomas terão suporte
- 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:
{
"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:
lingo runA 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:
lingo run --watchPressione Ctrl+C para sair do modo watch.
Ajuda#
Precisa de ajuda?
# Show help for all commands
lingo --help
# Show help for a specific command
lingo run --helpEntre na nossa comunidade no Discord para receber suporte em tempo real!
