Início rápido · Lingo.dev

Do início ao fim: instalar, autenticar, associar a um motor, fazer push das fontes e pull das traduções.

Pré-requisitos

Node.js 22+ (node -v para verificar). Depois de instalada, a CLI é executada como lingo.

Configuração#

Instalar

bash

npm install -g @lingo.dev/cli

Ou pnpm add -g @lingo.dev/cli / yarn global add @lingo.dev/cli / bun add -g @lingo.dev/cli.

Autenticar

bash

lingo login

Introduza o seu email; a CLI envia um código de utilização única e guarda um token de sessão em ~/.lingo/auth.json. Para contextos de CI / não interativos, utilize uma chave de API: lingo login --api-key lk_... (ou defina --api-key como flag global em qualquer comando).

Inicializar o projeto

Na raiz do projeto:

bash

lingo init

Pede o idioma de origem, os idiomas de destino e os padrões de ficheiros (globs que apontam para os ficheiros de origem). Escreve a secção de localização em .lingo/config.json. Faça commit deste ficheiro — é a fonte de verdade sobre o que é traduzido.

Associar a um motor

bash

lingo link

Escolha (ou crie) uma organização e um motor de localização. O motor armazena a configuração do seu modelo de IA, glossários, voz da marca e regras — configure-o uma vez na plataforma Lingo.dev e reutilize-o em vários projetos. link acrescenta orgId e engineId a .lingo/config.json (também com commit).

Primeiro push#

Com um ficheiro de origem não vazio no sítio certo (por exemplo, locales/en.json):

bash

lingo push --backfill-missing --wait

Traduz todos os destinos em falta em todos os padrões configurados. --wait mantém o CLI ligado até a execução terminar e, em seguida, escreve os resultados (locales/de.json, locales/fr.json, ...) no disco. Num checkout limpo, isto pode demorar desde alguns segundos (JSON pequenos) até vários minutos (grandes conjuntos de ficheiros markdown). Sem --wait, push termina assim que a execução é submetida e lingo pull escreve os resultados mais tarde.

Quando terminar:

text

✓ Run lrg_a8c... : localized 12 target file(s), uploaded 1 new artifact(s).

Execuções seguintes#

Depois de editar os ficheiros de origem, um simples lingo push traduz apenas o delta — os ficheiros cujo hash de origem não mudou são ignorados no servidor. As edições locais nos destinos são preservadas por predefinição; passe --force (com um âmbito) para substituir.

bash

lingo push                       # delta only
lingo push docs/en/**/*.md       # scoped: only this subtree
lingo push docs/en/about.md -f   # scoped + force: retranslate even if up to date

Cada um destes comandos termina assim que a execução é submetida — adicione --wait para escrever os resultados no mesmo comando ou obtenha-os com lingo pull.

Obter depois#

push regista o ID da execução em ~/.lingo/runs/<hash>.json (associado ao caminho absoluto do projeto). Mais tarde, na mesma máquina e a partir do mesmo checkout:

bash

lingo pull

…espera que o último push termine, se ainda estiver em execução, e depois escreve os respetivos resultados. Útil se fechar o terminal a meio da tradução. As outras máquinas recebem as traduções depois de as confirmar.

Para onde seguir#

Configuração — esquema de .lingo/config.json, lockfile, onde fica o estado da execução.
lingo push — padrões com âmbito, --force, semântica de repetição.
lingo pull — deteção de conflitos, --dry-run.