Hello world

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

Hola mundo

\"\n```\n\nHTML 번역은 텍스트 내용만 번역하면서 모든 태그, 속성 및 구조를 유지합니다.\n\n## 언어 감지\n\n**소스 언어 자동 감지:**\n\n```javascript\nconst locale = await lingoDotDev.recognizeLocale(\"Bonjour le monde\");\n// Returns: 'fr'\n```\n\n**자동 감지와 함께 사용:**\n\n```javascript\nconst result = await lingoDotDev.localizeText(\"Bonjour le monde\", {\n sourceLocale: null, // 자동 감지\n targetLocale: \"en\",\n});\n// Returns: \"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(`Translation progress: ${progress}%`);\n // UI 진행 표시줄 업데이트\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 서버 및 프론트엔드 프레임워크에 실시간 AI 기반 번역 기능을 추가합니다. 이 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// Returns: \"

Hola mundo