lingo.dev/readme/fr.md at main · lingodotdev/lingo.dev

Lingo.dev - Boîte à outils i18n open-source pour la localisation assistée par LLM

Démarrage rapide

Outil	Cas d'usage	Commande rapide
MCP	Configuration i18n assistée par IA pour apps React	Prompt : `Set up i18n`
CLI	Traduction de fichiers JSON, YAML, markdown, CSV, PO	`npx lingo.dev@latest run`
CI/CD	Pipeline de traduction automatisé dans GitHub Actions	`uses: lingodotdev/lingo.dev@main`
SDK	Traduction à l'exécution pour contenu dynamique	`npm install lingo.dev`
Compilateur	Localisation React au moment de la compilation sans wrappers i18n	Plugin `withLingo()`

Lingo.dev MCP

La configuration de l'i18n dans les applications React est notoirement sujette aux erreurs, même pour les développeurs expérimentés. Les assistants de codage IA aggravent la situation : ils hallucinent des API inexistantes, oublient les configurations de middleware, cassent le routage ou implémentent une demi-solution avant de se perdre. Le problème est que la configuration i18n nécessite une séquence précise de modifications coordonnées sur plusieurs fichiers (routage, middleware, composants, configuration), et les LLM ont du mal à maintenir ce contexte.

Lingo.dev MCP résout ce problème en donnant aux assistants IA un accès structuré aux connaissances i18n spécifiques aux frameworks. Au lieu de deviner, votre assistant suit des modèles d'implémentation vérifiés pour Next.js, React Router et TanStack Start.

IDE pris en charge :

Claude Code
Cursor
GitHub Copilot Agents
Codex (OpenAI)

Frameworks pris en charge :

Next.js (App Router & Pages Router v13-16)
TanStack Start (v1)
React Router (v7)

Utilisation :

Après avoir configuré le serveur MCP dans votre IDE (voir les guides de démarrage rapide), demandez à votre assistant :

Set up i18n with the following locales: en, es, and pt-BR. The default locale is 'en'.

L'assistant va :

Configurer le routage basé sur les locales (par ex. /en, /es, /pt-BR)
Mettre en place des composants de changement de langue
Implémenter la détection automatique de locale
Générer les fichiers de configuration nécessaires

Remarque : la génération de code assistée par IA est non déterministe. Vérifiez le code généré avant de le commiter.

Lire la documentation →

CLI Lingo.dev

Maintenir les traductions synchronisées est fastidieux. Vous ajoutez une nouvelle chaîne, oubliez de la traduire, et livrez une interface cassée aux utilisateurs internationaux. Ou vous envoyez des fichiers JSON aux traducteurs, attendez des jours, puis fusionnez manuellement leur travail. Passer à 10+ langues signifie gérer des centaines de fichiers qui dérivent constamment.

Le CLI Lingo.dev automatise cela. Pointez-le vers vos fichiers de traduction, exécutez une commande, et chaque locale se met à jour. Un fichier de verrouillage suit ce qui est déjà traduit, vous ne payez donc que pour le contenu nouveau ou modifié. Prend en charge les fichiers JSON, YAML, CSV, PO et markdown.

Configuration :

# Initialize project
npx lingo.dev@latest init

# Run translations
npx lingo.dev@latest run

Fonctionnement :

Extrait le contenu traduisible des fichiers configurés
Envoie le contenu au fournisseur LLM pour traduction
Écrit le contenu traduit dans le système de fichiers
Crée un fichier i18n.lock pour suivre les traductions terminées (évite le traitement redondant)

Configuration :

La commande init génère un fichier i18n.json. Configurez les locales et les buckets :

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}

Le champ provider est optionnel (par défaut Lingo.dev Engine). Pour les fournisseurs LLM personnalisés :

{
  "provider": {
    "id": "openai",
    "model": "gpt-4o-mini",
    "prompt": "Translate from {source} to {target}"
  }
}

Fournisseurs LLM pris en charge :

Lingo.dev Engine (recommandé)
OpenAI
Anthropic
Google
Mistral
OpenRouter
Ollama

Lire la documentation →

Lingo.dev CI/CD

Les traductions sont la fonctionnalité qui est toujours "presque terminée". Les ingénieurs fusionnent le code sans mettre à jour les locales. L'assurance qualité détecte les traductions manquantes en staging - ou pire, les utilisateurs les détectent en production. La cause profonde : la traduction est une étape manuelle facile à ignorer sous la pression des délais.

Lingo.dev CI/CD rend les traductions automatiques. Chaque push déclenche la traduction. Les chaînes manquantes sont complétées avant que le code n'atteigne la production. Aucune discipline requise - le pipeline s'en charge.

Plateformes prises en charge :

GitHub Actions
GitLab CI/CD
Bitbucket Pipelines

Configuration GitHub Actions :

Créez .github/workflows/translate.yml :

name: Translate
on:
  push:
    branches: [main]
permissions:
  contents: write
jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Lingo.dev
        uses: lingodotdev/lingo.dev@main
        with:
          api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Prérequis de configuration :

Ajoutez LINGODOTDEV_API_KEY aux secrets du dépôt (Settings > Secrets and variables > Actions)
Pour les workflows PR : activez "Allow GitHub Actions to create and approve pull requests" dans Settings > Actions > General

Options de workflow :

Commiter les traductions directement :

uses: lingodotdev/lingo.dev@main
with:
  api-key: ${{ secrets.LINGODOTDEV_API_KEY }}

Créer des pull requests avec les traductions :

uses: lingodotdev/lingo.dev@main
with:
  api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
  pull-request: true
env:
  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Entrées disponibles :

Entrée	Défaut	Description
`api-key`	(requis)	Clé API Lingo.dev
`pull-request`	`false`	Créer une PR au lieu de commiter directement
`commit-message`	`"feat: update translations via @LingoDotDev"`	Message de commit personnalisé
`pull-request-title`	`"feat: update translations via @LingoDotDev"`	Titre de PR personnalisé
`working-directory`	`"."`	Répertoire d'exécution
`parallel`	`false`	Activer le traitement parallèle

Lire la documentation →

SDK Lingo.dev

Les fichiers de traduction statiques fonctionnent pour les libellés d'interface, mais qu'en est-il du contenu généré par les utilisateurs ? Messages de chat, descriptions de produits, tickets de support - le contenu qui n'existe pas au moment de la compilation ne peut pas être pré-traduit. Vous êtes obligé d'afficher du texte non traduit ou de créer un pipeline de traduction personnalisé.

Le SDK Lingo.dev traduit le contenu à l'exécution. Transmettez n'importe quel texte, objet ou HTML et obtenez une version localisée. Fonctionne pour le chat en temps réel, les notifications dynamiques ou tout contenu qui arrive après le déploiement. Disponible pour JavaScript, PHP, Python et Ruby.

Installation :

npm install lingo.dev

Utilisation :

import { LingoDotDevEngine } from "lingo.dev/sdk";

const lingoDotDev = new LingoDotDevEngine({
  apiKey: process.env.LINGODOTDEV_API_KEY,
});

// Translate objects (preserves structure)
const translated = await lingoDotDev.localizeObject(
  { greeting: "Hello", farewell: "Goodbye" },
  { sourceLocale: "en", targetLocale: "es" },
);
// { greeting: "Hola", farewell: "Adiós" }

// Translate text
const text = await lingoDotDev.localizeText("Hello!", {
  sourceLocale: "en",
  targetLocale: "fr",
});

// Translate to multiple languages at once
const results = await lingoDotDev.batchLocalizeText("Hello!", {
  sourceLocale: "en",
  targetLocales: ["es", "fr", "de"],
});

// Translate chat (preserves speaker names)
const chat = await lingoDotDev.localizeChat(
  [{ name: "Alice", text: "Hello!" }],
  { sourceLocale: "en", targetLocale: "es" },
);

// Translate HTML (preserves markup)
const html = await lingoDotDev.localizeHtml("<h1>Welcome</h1>", {
  sourceLocale: "en",
  targetLocale: "de",
});

// Detect language
const locale = await lingoDotDev.recognizeLocale("Bonjour le monde");
// "fr"

SDK disponibles :

SDK JavaScript - Applications web, Node.js
SDK PHP - PHP, Laravel
SDK Python - Django, Flask
SDK Ruby - Rails

Lire la documentation →

Compilateur Lingo.dev

L'i18n traditionnelle est invasive. Vous enveloppez chaque chaîne dans des fonctions t(), inventez des clés de traduction (home.hero.title.v2), maintenez des fichiers JSON parallèles et regardez vos composants gonfler avec du code passe-partout de localisation. C'est tellement fastidieux que les équipes retardent l'internationalisation jusqu'à ce qu'elle devienne une refonte massive.

Lingo.dev Compiler élimine les formalités. Écrivez des composants React avec du texte en anglais simple. Le compilateur détecte les chaînes traduisibles au moment de la compilation et génère automatiquement des variantes localisées. Pas de clés, pas de fichiers JSON, pas de fonctions wrapper - juste du code React qui fonctionne dans plusieurs langues.

Installation :

pnpm install @lingo.dev/compiler

Authentification :

# Recommended: Sign up at lingo.dev and login
npx lingo.dev@latest login

# Alternative: Add API key to .env
LINGODOTDEV_API_KEY=your_key_here

# Or use direct LLM providers (Groq, OpenAI, Anthropic, Google)
GROQ_API_KEY=your_key

Configuration (Next.js) :

// next.config.ts
import type { NextConfig } from "next";
import { withLingo } from "@lingo.dev/compiler/next";

const nextConfig: NextConfig = {};

export default async function (): Promise<NextConfig> {
  return await withLingo(nextConfig, {
    sourceRoot: "./app",
    sourceLocale: "en",
    targetLocales: ["es", "fr", "de"],
    models: "lingo.dev",
    dev: { usePseudotranslator: true },
  });
}

Configuration (Vite) :

// vite.config.ts
import { lingoCompilerPlugin } from "@lingo.dev/compiler/vite";

export default defineConfig({
  plugins: [
    lingoCompilerPlugin({
      sourceRoot: "src",
      sourceLocale: "en",
      targetLocales: ["es", "fr", "de"],
      models: "lingo.dev",
      dev: { usePseudotranslator: true },
    }),
    react(),
  ],
});

Configuration du provider :

// app/layout.tsx (Next.js)
import { LingoProvider } from "@lingo.dev/compiler/react";

export default function RootLayout({ children }) {
  return (
    <LingoProvider>
      <html>
        <body>{children}</body>
      </html>
    </LingoProvider>
  );
}

Sélecteur de langue :

import { useLocale, setLocale } from "@lingo.dev/compiler/react";

export function LanguageSwitcher() {
  const locale = useLocale();
  return (
    <select value={locale} onChange={(e) => setLocale(e.target.value)}>
      <option value="en">English</option>
      <option value="es">Español</option>
    </select>
  );
}

Développement : npm run dev (utilise le pseudotraducteur, aucun appel API)

Production : définissez usePseudotranslator: false, puis next build

Commitez le répertoire .lingo/ dans le contrôle de version.

Fonctionnalités clés :

Aucun coût de performance à l'exécution
Pas de clés de traduction ni de fichiers JSON
Pas de fonctions t() ni de composants wrapper <T>
Détection automatique du texte traduisible dans JSX
Support TypeScript
ICU MessageFormat pour les pluriels
Remplacements manuels via l'attribut data-lingo-override
Widget d'éditeur de traduction intégré

Modes de compilation :

pseudotranslator : mode développement avec traductions placeholder (aucun coût API)
real : génère les traductions réelles en utilisant les LLM
cache-only : mode production utilisant les traductions pré-générées depuis la CI (aucun appel API)

Frameworks supportés :

Next.js (App Router avec React Server Components)
Vite + React (SPA et SSR)

Support de frameworks supplémentaires prévu.

Lire la documentation →

Contribuer

Les contributions sont les bienvenues. Veuillez suivre ces directives :

Issues : Signaler des bugs ou demander des fonctionnalités
Pull Requests : Soumettre des modifications
- Chaque PR nécessite un changeset : pnpm new (ou pnpm new:empty pour les modifications sans release)
- Assurez-vous que les tests passent avant de soumettre
Développement : Il s'agit d'un monorepo pnpm + turborepo
- Installer les dépendances : pnpm install
- Exécuter les tests : pnpm test
- Build : pnpm build

Support : Communauté Discord

Historique des étoiles

Si vous trouvez Lingo.dev utile, donnez-nous une étoile et aidez-nous à atteindre 10 000 étoiles !

[

](https://www.star-history.com/#lingodotdev/lingo.dev&Date)

Documentation localisée

Traductions disponibles :

English • 中文 • 日本語 • 한국어 • Español • Français • Русский • Українська • Deutsch • Italiano • العربية • עברית • हिन्दी • Português (Brasil) • বাংলা • فارسی • Polski • Türkçe • اردو • भोजपुरी • অসমীয়া • ગુજરાતી • मराठी • ଓଡ଼ିଆ • ਪੰਜਾਬੀ • සිංහල • தமிழ் • తెలుగు

Ajouter une nouvelle langue :

Ajouter le code de locale à i18n.json en utilisant le format BCP-47
Soumettre une pull request

Format de locale BCP-47 : language[-Script][-REGION]

language : ISO 639-1/2/3 (minuscules) : en, zh, bho
Script : ISO 15924 (casse de titre) : Hans, Hant, Latn
REGION : ISO 3166-1 alpha-2 (majuscules) : US, CN, IN
Exemples : en, pt-BR, zh-Hans, sr-Cyrl-RS

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Démarrage rapide

Lingo.dev MCP

CLI Lingo.dev

Lingo.dev CI/CD

SDK Lingo.dev

Compilateur Lingo.dev

Contribuer

Historique des étoiles

Documentation localisée

FilesExpand file tree

fr.md

Latest commit

History

fr.md

File metadata and controls

Démarrage rapide

Lingo.dev MCP

CLI Lingo.dev

Lingo.dev CI/CD

SDK Lingo.dev

Compilateur Lingo.dev

Contribuer

Historique des étoiles

Documentation localisée