Hello world

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

Hola mundo

\"\n```\n\nتحافظ ترجمة HTML على جميع العلامات والسمات والهيكل مع ترجمة محتوى النص فقط.\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, // Auto-detect\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, // 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**حجم الدفعة** يتحكم في عدد العناصر المرسلة في كل طلب 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, // Prioritize speed over quality\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 // Update UI progress bar\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\nتتضمن مجموعة أدوات التطوير (SDK) إعادة المحاولات التلقائية لمشاكل الشبكة، ولكن تظل معالجة الأخطاء على مستوى التطبيق مهمة.\n","content","\nتوفر **واجهة برمجة تطبيقات جافاسكريبت من Lingo.dev** ترجمة فورية مدعومة بالذكاء الاصطناعي للتطبيقات الإلكترونية، وخوادم Node.js، وأطر عمل الواجهة الأمامية. تتعامل واجهة برمجة التطبيقات مع المحتوى الديناميكي مثل رسائل الدردشة، وتعليقات المستخدمين، والبيانات المباشرة التي تحتاج إلى ترجمة فورية.\n\nعلى عكس توطين الملفات الثابتة باستخدام **واجهة سطر الأوامر من Lingo.dev**، تعالج واجهة برمجة التطبيقات المحتوى عند الطلب، مما يجعلها مثالية لتطبيقات الدردشة، وعملاء البريد الإلكتروني، وأدوات وسائل التواصل الاجتماعي حيث يتغير المحتوى باستمرار.\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// Returns: \"¡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// Returns: ['¡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// Returns: { 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// Returns translated conversation with same structure\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