Hello world

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

Hola mundo

\"\n```\n\nHTML翻訳はすべてのタグ、属性、構造を維持しながら、テキストコンテンツのみを翻訳します。\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 // 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 // エラーを適切に処理する\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// 戻り値: \"

Hola mundo