Hello world

\";\n\nconst translated = await lingoDotDev.localizeHtml(html, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Возвращает: \"

Hola mundo

\"\n```\n\nПеревод HTML сохраняет все теги, атрибуты и структуру, переводя только текстовое содержимое.\n\n## Определение языка\n\n**Автоматическое определение исходного языка:**\n\n```javascript\nconst locale = await lingoDotDev.recognizeLocale(\"Bonjour le monde\");\n// Возвращает: 'fr'\n```\n\n**Использование с автоматическим определением:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Bonjour le monde\", {\n sourceLocale: null, // Автоопределение\n targetLocale: \"en\",\n});\n// Возвращает: \"Hello world\"\n```\n\nОпределение языка увеличивает время обработки, поэтому используйте его только в случае, если исходный язык неизвестен.\n\n## Настройки конфигурации\n\n**Настройка поведения SDK:**\n\n```javascript\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n batchSize: 100, // Максимальное количество элементов на один запрос API (по умолчанию: 50, максимум: 250)\n idealBatchItemSize: 1000, // Целевое количество слов на партию (по умолчанию: 500, максимум: 2500)\n});\n```\n\n**Размер партии** определяет, сколько элементов отправляется в каждом запросе API. Более высокие значения уменьшают количество вызовов API, но увеличивают размер запроса.\n\n**Целевой размер партии** определяет целевое количество слов для оптимальной эффективности обработки.\n\n## Параметры перевода\n\n**Контроль скорости и качества:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello world\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n fast: true, // Приоритет скорости над качеством\n});\n```\n\nПараметр `fast` позволяет ускорить перевод с возможным снижением качества для приложений, требующих быстрого выполнения.\n\n## Отслеживание прогресса\n\n**Мониторинг больших задач перевода:**\n\n```javascript\nawait lingoDotDev.localizeObject(\n largeObject,\n { sourceLocale: \"en\", targetLocale: \"es\" },\n (progress) => {\n console.log(`Прогресс перевода: ${progress}%`);\n // Обновление индикатора прогресса в пользовательском интерфейсе\n },\n);\n```\n\nОбратные вызовы прогресса предоставляют обратную связь в реальном времени для крупных операций перевода, что полезно для обновления пользовательского интерфейса.\n\n## Обработка ошибок\n\n**Реализуйте корректную обработку ошибок:**\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\nSDK включает автоматические повторные попытки в случае сетевых проблем, но обработка ошибок на уровне приложения остаётся важной.\n","content","\n**Lingo.dev JavaScript SDK** добавляет возможность перевода в реальном времени с использованием ИИ в веб-приложения, серверы Node.js и фронтенд-фреймворки. SDK обрабатывает динамический контент, такой как сообщения чата, комментарии пользователей и живые данные, которые требуют мгновенного перевода.\n\nВ отличие от статической локализации файлов с помощью **Lingo.dev CLI**, SDK обрабатывает контент по запросу, что делает его идеальным для чат-приложений, почтовых клиентов и инструментов социальных сетей, где контент постоянно меняется.\n\n## Установка\n\n```bash\nnpm install lingo.dev\n```\n\n## Базовая настройка\n\n```javascript\nimport { LingoDotDevEngine } from \"lingo.dev/sdk\";\n\nconst lingoDotDev = new LingoDotDevEngine({\n apiKey: \"your-api-key-here\",\n});\n```\n\n## Перевод текста\n\n**Перевод простого текста:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Возвращает: \"¡Hola Mundo!\"\n```\n\n**Перевод на несколько языков:**\n\n```javascript\nconst results = await lingoDotDev.batchLocalizeText(\"Hello, world!\", {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\"],\n});\n// Возвращает: ['¡Hola Mundo!', 'Bonjour le monde!', 'Hallo Welt!']\n```\n\n## Перевод объектов\n\n**Перевод структурированных данных:**\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// Возвращает: { greeting: \"Hola\", farewell: \"Adiós\", message: \"Bienvenido a nuestra plataforma\" }\n```\n\nЭтот метод обрабатывает вложенные объекты и сохраняет оригинальную структуру, переводя текстовые значения.\n\n## Перевод чатов\n\n**Перевод массивов с диалогами:**\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// Возвращает переведённый диалог с сохранением структуры\n```\n\nМетод для чатов сохраняет метаданные, такие как имена пользователей, переводя только текстовое содержимое.\n\n## Перевод HTML\n\n**Переводите HTML, сохраняя разметку:**\n\n```javascript\nconst html = \"

Hello world

\";\n\nconst translated = await lingoDotDev.localizeHtml(html, {\n sourceLocale: \"en\",\n targetLocale: \"es\",\n});\n// Возвращает: \"

Hola mundo