Hello world

\";\n\nconst translated = await lingoDotDev.localizeHtml(html, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Retourne : \"

Hola mundo

\"\n```\n\nLa traduction HTML maintient tous les tags, attributs et la structure tout en traduisant uniquement le contenu textuel.\n\n## Détection de langue\n\n**Détecter automatiquement la langue source :**\n\n```javascript\nconst locale = await lingoDotDev.recognizeLocale(\"Bonjour le monde\");\n// Retourne : 'fr'\n```\n\n**Utilisation avec détection automatique :**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Bonjour le monde\", {\n sourceLocale: null, // Détection automatique\n targetLocale: \"en\",\n});\n// Retourne : \"Hello world\"\n```\n\nLa détection de langue ajoute du temps de traitement, donc ne l'utilisez que lorsque la langue source est inconnue.\n\n## Options de configuration\n\n**Configurer le comportement du SDK :**\n\n```javascript\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n batchSize: 100, // Nombre maximum d'éléments par requête API (défaut : 50, max : 250)\n idealBatchItemSize: 1000, // Nombre cible de mots par lot (défaut : 500, max : 2500)\n});\n```\n\n**La taille du lot** contrôle combien d'éléments sont envoyés dans chaque requête API. Des valeurs plus élevées réduisent les appels API mais augmentent la taille des requêtes.\n\n**La taille idéale d'élément par lot** contrôle le nombre cible de mots pour une efficacité de traitement optimale.\n\n## Paramètres de traduction\n\n**Contrôle vitesse vs qualité :**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello world\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n fast: true, // Prioriser la vitesse plutôt que la qualité\n});\n```\n\nLe paramètre `fast` permet des traductions plus rapides avec une qualité potentiellement réduite pour les applications sensibles au temps.\n\n## Suivi de progression\n\n**Surveiller les tâches de traduction volumineuses :**\n\n```javascript\nawait lingoDotDev.localizeObject(\n largeObject,\n { sourceLocale: \"en\", targetLocale: \"es\" },\n (progress) => {\n console.log(`Progression de la traduction : ${progress}%`);\n // Mettre à jour la barre de progression de l'interface utilisateur\n },\n);\n```\n\nLes callbacks de progression fournissent un retour en temps réel pour les opérations de traduction volumineuses, utile pour les mises à jour d'interface utilisateur.\n\n## Gestion des erreurs\n\n**Implémentez une gestion d'erreurs appropriée :**\n\n```javascript\ntry {\n const result = await lingoDotDev.localizeText(\"Hello\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n });\n} catch (error) {\n console.error(\"Translation failed:\", error.message);\n // Handle error appropriately\n}\n```\n\nLe SDK inclut des mécanismes automatiques de nouvelles tentatives en cas de problèmes réseau, mais la gestion des erreurs au niveau de l'application reste importante.\n","content","\nLe **SDK JavaScript Lingo.dev** ajoute la traduction en temps réel propulsée par l'IA aux applications web, aux serveurs Node.js et aux frameworks frontend. Le SDK gère le contenu dynamique comme les messages de chat, les commentaires des utilisateurs et les données en direct nécessitant une traduction instantanée.\n\nContrairement à la localisation de fichiers statiques avec **Lingo.dev CLI**, le SDK traite le contenu à la demande, ce qui le rend idéal pour les applications de chat, les clients de messagerie et les outils de médias sociaux où le contenu change constamment.\n\n## Installation\n\n```bash\nnpm install lingo.dev\n```\n\n## Configuration de base\n\n```javascript\nimport { LingoDotDevEngine } from \"lingo.dev/sdk\";\n\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n});\n```\n\n## Traduction de texte\n\n**Traduire du texte simple :**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Retourne : \"¡Hola Mundo!\"\n```\n\n**Traduire vers plusieurs langues :**\n\n```javascript\nconst results = await lingoDotDev.batchLocalizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\"],\n});\n// Retourne : ['¡Hola Mundo!', 'Bonjour le monde!', 'Hallo Welt!']\n```\n\n## Traduction d'objets\n\n**Traduire des données structurées :**\n\n```javascript\nconst content = {\n greeting: \"Hello\",\n farewell: \"Goodbye\",\n message: \"Welcome to our platform\",\n};\n\nconst translated = await lingoDotDev.localizeObject(content, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Retourne : { greeting: \"Hola\", farewell: \"Adiós\", message: \"Bienvenido a nuestra plataforma\" }\n```\n\nCette méthode gère les objets imbriqués et préserve la structure originale tout en traduisant les valeurs textuelles.\n\n## Traduction de chat\n\n**Traduire des tableaux de conversation :**\n\n```javascript\nconst conversation = [\n { name: \"Alice\", text: \"Hello!\" },\n { name: \"Bob\", text: \"How are you?\" },\n { name: \"Alice\", text: \"I'm doing well, thanks!\" },\n];\n\nconst translated = await lingoDotDev.localizeChat(conversation, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Retourne la conversation traduite avec la même structure\n```\n\nLa méthode de chat préserve les métadonnées comme les noms d'utilisateurs tout en traduisant uniquement le contenu textuel.\n\n## Traduction HTML\n\n**Traduire du HTML tout en préservant le balisage :**\n\n```javascript\nconst html = \"

Hello world

\";\n\nconst translated = await lingoDotDev.localizeHtml(html, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Retourne : \"

Hola mundo