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:
npm install -g lingo.devVerificar a instalação#
Confirme que a CLI foi instalada corretamente:
lingo --versionDeverá ver um resultado semelhante a este:
lingo.dev v0.133.9
Node.js v20.10.0Inicialize o seu projeto#
Vá até à pasta do seu projeto e execute:
cd my-project
lingo initEste comando interativo vai:
- Ligar à sua conta - Autenticar com a sua chave de API
- Selecionar um projeto - Escolher um projeto existente ou criar um novo
- Configurar idiomas - Selecionar os idiomas a suportar
- 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:
{
"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:
lingo runA 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:
lingo run --watchPrima Ctrl+C para sair do modo watch.
Obter ajuda#
Precisa de ajuda?
# Show help for all commands
lingo --help
# Show help for a specific command
lingo run --helpJunte-se à nossa comunidade no Discord para obter ajuda em tempo real!
