Hello world

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

Hola mundo

\"\n```\n\nDie HTML-Übersetzung behält alle Tags, Attribute und Strukturen bei, während nur der Textinhalt übersetzt wird.\n\n## Spracherkennung\n\n**Automatische Erkennung der Quellsprache:**\n\n```javascript\nconst locale = await lingoDotDev.recognizeLocale(\"Bonjour le monde\");\n// Returns: 'fr'\n```\n\n**Verwendung mit automatischer Erkennung:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Bonjour le monde\", {\n sourceLocale: null, // Auto-detect\n targetLocale: \"en\",\n});\n// Returns: \"Hello world\"\n```\n\nDie Spracherkennung erhöht die Verarbeitungszeit, daher sollte sie nur verwendet werden, wenn die Quellsprache unbekannt ist.\n\n## Konfigurationsoptionen\n\n**SDK-Verhalten konfigurieren:**\n\n```javascript\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n batchSize: 100, // Max items per API request (default: 50, max: 250)\n idealBatchItemSize: 1000, // Target word count per batch (default: 500, max: 2500)\n});\n```\n\n**Batch-Größe** steuert, wie viele Elemente in jeder API-Anfrage gesendet werden. Höhere Werte reduzieren API-Aufrufe, erhöhen jedoch die Anfragegröße.\n\n**Ideale Batch-Elementgröße** steuert die Zielwortanzahl für optimale Verarbeitungseffizienz.\n\n## Übersetzungsparameter\n\n**Geschwindigkeit vs. Qualitätskontrolle:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello world\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n fast: true, // Prioritize speed over quality\n});\n```\n\nDer Parameter `fast` ermöglicht schnellere Übersetzungen mit potenziell reduzierter Qualität für zeitkritische Anwendungen.\n\n## Fortschrittsverfolgung\n\n**Überwachung großer Übersetzungsaufträge:**\n\n```javascript\nawait lingoDotDev.localizeObject(\n largeObject,\n { sourceLocale: \"en\", targetLocale: \"es\" },\n (progress) => {\n console.log(`Translation progress: ${progress}%`);\n // Update UI progress bar\n },\n);\n```\n\nFortschritts-Callbacks bieten Echtzeit-Feedback für umfangreiche Übersetzungsvorgänge, was für Benutzeroberflächen-Updates nützlich ist.\n\n## Fehlerbehandlung\n\n**Implementieren Sie eine ordnungsgemäße Fehlerbehandlung:**\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\nDas SDK beinhaltet automatische Wiederholungsversuche bei Netzwerkproblemen, aber die Fehlerbehandlung auf Anwendungsebene bleibt wichtig.\n","content","\n**Lingo.dev JavaScript SDK** fügt Webanwendungen, Node.js-Servern und Frontend-Frameworks KI-gestützte Echtzeit-Übersetzung hinzu. Das SDK verarbeitet dynamische Inhalte wie Chat-Nachrichten, Benutzerkommentare und Live-Daten, die sofortige Übersetzung benötigen.\n\nIm Gegensatz zur statischen Datei-Lokalisierung mit **Lingo.dev CLI** verarbeitet das SDK Inhalte bei Bedarf, was es ideal für Chat-Anwendungen, E-Mail-Clients und Social-Media-Tools macht, bei denen sich Inhalte ständig ändern.\n\n## Installation\n\n```bash\nnpm install lingo.dev\n```\n\n## Grundlegende Einrichtung\n\n```javascript\nimport { LingoDotDevEngine } from \"lingo.dev/sdk\";\n\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n});\n```\n\n## Text-Übersetzung\n\n**Einfachen Text übersetzen:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Returns: \"¡Hola Mundo!\"\n```\n\n**In mehrere Sprachen übersetzen:**\n\n```javascript\nconst results = await lingoDotDev.batchLocalizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\"],\n});\n// Returns: ['¡Hola Mundo!', 'Bonjour le monde!', 'Hallo Welt!']\n```\n\n## Objekt-Übersetzung\n\n**Strukturierte Daten übersetzen:**\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// Returns: { greeting: \"Hola\", farewell: \"Adiós\", message: \"Bienvenido a nuestra plataforma\" }\n```\n\nDiese Methode verarbeitet verschachtelte Objekte und behält die ursprüngliche Struktur bei, während Textwerte übersetzt werden.\n\n## Chat-Übersetzung\n\n**Konversations-Arrays übersetzen:**\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// Returns translated conversation with same structure\n```\n\nDie Chat-Methode behält Metadaten wie Benutzernamen bei und übersetzt nur den Textinhalt.\n\n## HTML-Übersetzung\n\n**HTML übersetzen unter Beibehaltung der Markup-Struktur:**\n\n```javascript\nconst html = \"

Hello world

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

Hola mundo