Aller au contenu
Aller au contenu
verbatra

Documentation

Configure verbatra et garde chaque locale à jour.

Guides et référence pour la CLI, le SDK, Studio et le serveur MCP : commence par le démarrage rapide ou laisse ton agent de code configurer verbatra.

Pars de ton objectif

Choisis ce que tu veux faire ; chaque carte ouvre la page qui le montre.

Traduire un projetInstalle la CLI, prévisualise l'exécution sans clé, puis traduis ton premier fichier.Démarrage rapideProtéger les pull requestsFais échouer une pull request quand une locale dérive, avec une sortie JSON pour les scripts.CI et codes de sortieConfier à des traducteursExporte un classeur qu'une personne traduit, puis réimporte-le.Traduction humaine

Choisis ta stack

Une carte marquée Démarrage rapide ouvre un guide pas à pas pour cette stack ; toute autre carte ouvre sa commande init et son organisation de fichiers.

Chaque exécution est un diff, pas une réécriture.

Ce qui se passe quand tu lances verbatra translate.

Maintenir à la main une seule locale source signifie que tous les autres fichiers de locale dérivent : les nouvelles clés manquent dans les cibles, les chaînes modifiées laissent derrière elles des traductions périmées, et les clés supprimées traînent en orphelines. verbatra comble cet écart en comparant chaque cible à un fichier de verrouillage commité, verbatra.lock.json, et en n'envoyant que ce qui a changé au fournisseur que tu configures ; une deuxième exécution sans rien de nouveau à traduire ne fait aucun appel au fournisseur. Chaque résultat est vérifié avant d'être écrit, donc un placeholder cassé est retenu et retenté, jamais livré. Voir Comment ça marche pour le pipeline complet.

  1. 1. Vérifier

    verbatra check compare la source, les cibles et le fichier de verrouillage. Il n’appelle aucun fournisseur et n’a besoin d’aucune clé.

  2. 2. Traduire

    verbatra translate n’envoie que les clés manquantes ou modifiées et refuse tout résultat aux placeholders divergents, au balisage inline cassé ou à la syntaxe ICU invalide.

  3. 3. Bloquer en CI

    La GitHub Action exécute check sur chaque pull request et la fait échouer tant qu’une locale n’est pas synchronisée.

verbatra lit et écrit les formats de fichiers de locale courants, du JSON et du YAML au XLIFF, à gettext et aux catalogues Android et Apple, et traduit via n'importe quel fournisseur pris en charge, LLM ou service de traduction automatique, derrière une seule interface (ou aucun, pour un flux 100 % humain), et un format qu'il n'embarque pas peut être ajouté comme adaptateur personnalisé. Les listes complètes sont dans Formats et Fournisseurs.

Les paquets

Un moteur, quatre façons de le piloter.

@verbatra/cli0.13.6

Le binaire verbatra : toutes les commandes, de init et extract à translate, check, export et studio, comme une fine couche au-dessus du SDK. Commence ici.

@verbatra/sdk0.13.6

Le moteur en dessous : translate, watch, check, diff, doctor, extract, pseudo-localisation, génération de types, et les allers-retours Excel et TMX, le tout depuis le code.

@verbatra/studio0.7.7

Un tableau de bord local avec édition en place, une file de relecture, un Overview de la couverture et des exécutions et des outils pour agents navigateur. La dépense fournisseur reste désactivée tant que tu ne l'actives pas.

@verbatra/mcp0.4.6

Un serveur MCP en stdio qui expose le statut de traduction, le glossaire et les outils d'édition à Claude Code, Cursor ou tout client MCP.