Hello world

;\n}\n```\n\n**جعل النصوص الحرفية قابلة للترجمة:**\n\nيمكنك جعل النصوص الحرفية قابلة للترجمة عن طريق تغليفها في أجزاء JSX:\n\n```tsx\n// قبل: غير قابل للترجمة\nconst message = \"Hello world\";\n\n// بعد: قابل للترجمة باستخدام الأجزاء\nconst message = <>Hello world;\n\n// الاستخدام في المكون الخاص بك\nfunction Component() {\n return

{message}

;\n}\n```\n\n**نهج بديل:**\n\n```tsx\n// للرسائل الديناميكية\nfunction getLocalizedMessage() {\n return <>Something went wrong;\n}\n\n// للنص المشروط\nconst statusText = isError ? <>Error occurred : <>Success;\n```\n\nتضمن هذه الاتفاقية سلوك ترجمة متسق مع الحفاظ على حدود واضحة بين المحتوى القابل للترجمة وغير القابل للترجمة.\n\nنحن نستكشف طرقًا لتوسيع هذا السلوك لدعم المزيد من حالات الاستخدام في المستقبل. [انضم إلى Discord الخاص بنا](https://lingo.dev/go/discord) لمناقشة الأنماط المحددة التي ترغب في رؤية دعمها.\n\n## ما هي الأطر المدعومة؟\n\nيدعم **مُجمِّع Lingo.dev** حاليًا أطر عمل React التالية:\n\n- **Next.js** (موجه التطبيق فقط)\n- **React Router** الإصدار 6+\n- **Remix** (أحدث إصدار)\n- **Vite + React**\n\nنرحب بالمساهمين المهتمين بتنفيذ دعم المُجمِّع لمنصات أخرى. [انضم إلى Discord الخاص بنا](https://lingo.dev/go/discord) لمناقشة استراتيجيات التنفيذ.\n\n## هل يمكنني إضافة المزيد من اللغات؟\n\nنعم! يمكنك توسيع دعم اللغة عن طريق تكوين نماذج مخصصة مباشرة في تكوين المُجمِّع الخاص بك:\n\n```ts\nconst compilerConfig = {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\", \"pt\", \"it\"],\n models: {\n \"*:pt\": \"mistral-saba-24b\",\n \"en:it\": \"meta-llama/llama-4-maverick-17b-128e-instruct\",\n \"*:*\": \"mistral-saba-24b\",\n },\n};\n\nlingoCompiler.next(compilerConfig)(nextConfig);\n```\n\nراجع [التكوين المتقدم](../configuration/advanced#custom-model-configuration) للحصول على التفاصيل.\n\n## هل يمكنني استخدام موجهات مخصصة؟\n\nنعم! يمكنك تخصيص موجهات الترجمة مباشرة في تكوين المترجم الخاص بك:\n\n```ts\nconst compilerConfig = {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\"],\n prompt:\n \"You are a professional translator specializing in technical documentation. Translate from {SOURCE_LOCALE} to {TARGET_LOCALE} while maintaining technical accuracy.\",\n};\n```\n\nللمسارد المخصصة، قم بتضمين تعريفات المصطلحات في الموجه الخاص بك. راجع [الموجه الافتراضي](https://github.com/lingodotdev/lingo.dev/blob/main/packages/compiler/src/lib/lcp/api/prompt.ts) للاطلاع على أفضل الممارسات.\n\n## هل يمكنني استخدام المزيد من مزودي نماذج اللغة الكبيرة (LLM)؟\n\nحاليًا، يتكامل مترجم Lingo.dev مع [GROQ](https://groq.com/)، لكننا نود دعم المزيد من مزودي نماذج اللغة الكبيرة قريبًا ([تحدث معنا](https://lingo.dev/go/discord) أو [أرسل لنا طلب سحب](https://github.com/lingodotdev/lingo.dev/)!).\n\n## هل أحتاج إلى مفتاح واجهة برمجة تطبيقات GROQ في CI/CD؟\n\nعادةً لا. إذا قمت ببناء تطبيقك محليًا، سيتم تخزين جميع الترجمات في دليل `lingo/`. لن يحتاج بناء CI/CD الخاص بك إلى استدعاء نموذج اللغة الكبير لترجمة أي نصوص.\n\nبدلاً من ذلك، يمكنك إضافة متغير `GROQ_API_KEY` إلى CI/CD الخاص بك وإجراء جميع الترجمات هناك أثناء البناء، ولكننا لا نوصي بهذا النهج للحفاظ على مزيد من التحكم في الترجمات النهائية.\n\n## هل يمكنني تعديل الترجمات؟\n\nنعم! يمكنك تعديل ملف `lingo/dictionary.js` يدويًا. يقوم بتصدير كائن يحتوي على ترجمات لجميع الملفات والإدخالات. يمكنك تعديل النص لكل لغة في خاصية `content`. سيتم الاحتفاظ بتعديلاتك حتى يتم تحديث النص المصدر في مكونات React.\n\n**لست من محبي تعديل كائنات JavaScript؟** نحن بصدد إطلاق محرر لتحسين تجربة التعديل قريبًا. [أخبرنا إذا كنت مهتمًا!](https://lingo.dev/go/discord)\n\n## كيف يمكنني إعادة ترجمة تطبيقي بالكامل أو ملف معين أو لغة معينة؟\n\nلإعادة ترجمة تطبيقك بالكامل، احذف ملف `dictionary.js` من دليل `lingo/`.\n\nلإعادة ترجمة ملفات محددة فقط، يمكنك حذف مفتاحها (اسم الملف) من `dictionary.js`.\n\nإذا كنت ترغب في إعادة ترجمة لغة محددة، فأنت بحاجة إلى حذف جميع السجلات الخاصة بتلك اللغة.\n\n## لماذا أحتاج إلى بناء التطبيق محليًا؟\n\nعمليات البناء المحلية تقوم بتطبيع ملفات الترجمة `lingo/` الخاصة بك عن طريق:\n\n- إزالة مفاتيح الترجمة غير المستخدمة\n- تحديث بصمات المحتوى\n- ضمان تنسيق متسق للملفات\n- التحسين للنشر في بيئة الإنتاج\n\nقم دائمًا بتشغيل `npm run build` قبل الالتزام بالتغييرات للحفاظ على ملفات الترجمة نظيفة.\n\n## هناك ترجمات مفقودة!\n\nإذا كانت هناك ترجمات مفقودة:\n\n1. **قم بالبناء محليًا** لتطبيع ملفات `lingo/` الخاصة بك:\n\n ```bash\n npm run build\n ```\n\n2. **تحقق من مفتاح API** الخاص بك تم تعيينه بشكل صحيح:\n\n ```bash\n # تحقق من أن ملف .env يحتوي على\n GROQ_API_KEY=gsk_...\n ```\n\n3. **التزم بالملفات المحدثة**:\n\n ```bash\n git add lingo/\n git commit -m \"Update translations\"\n ```\n\n4. **أعد تشغيل خادم التطوير** بعد التغييرات.\n\n## هل يمكنني إعداد مسرد مصطلحات مخصص؟\n\nنعم! استخدم المطالبات المخصصة لتحديد المصطلحات والمسارد مباشرة في تكوين المترجم الخاص بك:\n\n```ts\nconst compilerConfig = {\n sourceLocale: \"en\",\n targetLocales: [\"es\", \"fr\", \"de\"],\n prompt:\n \"You are a professional translator. Use these terms consistently: 'Dashboard' should be 'Tableau de bord' in French, 'Settings' should be 'Configuración' in Spanish. Translate from {SOURCE_LOCALE} to {TARGET_LOCALE}.\",\n};\n```\n\n## كيف يتعامل المُترجم البرمجي مع صيغ الجمع؟\n\nيتعامل المُترجم البرمجي تلقائيًا مع أنماط الجمع الأساسية، ولكن بالنسبة لقواعد الجمع المعقدة، قد تحتاج إلى هيكلة JSX الخاص بك وفقًا لذلك:\n\n```tsx\n// سيتعامل المُترجم مع هذا بشكل مناسب\n

{count === 1 ? <>1 item : <>{count} items}

\n```\n\n## ماذا عن الأداء في بيئة الإنتاج؟\n\nتم تحسين **مُترجم Lingo.dev** للإنتاج:\n\n- **تكلفة تشغيل صفرية** - يتم ترجمة الترجمات مسبقًا\n- **تقسيم الحزمة** - يتم تحميل اللغة النشطة فقط\n- **تقليم الشجرة** - تتم إزالة الترجمات غير المستخدمة\n- **متوافق مع CDN** - ملفات الترجمة الثابتة تخزن مؤقتًا بكفاءة\n\n## هل يمكنني استخدام هذا مع TypeScript؟\n\nنعم! يعمل المُترجم البرمجي بسلاسة مع مشاريع TypeScript. جميع مكونات React المقدمة مكتوبة بشكل كامل:\n\n```tsx\nimport { LocaleSwitcher } from \"lingo.dev/react/client\";\n\n// دعم كامل لـ TypeScript\nconst locales: string[] = [\"en\", \"es\", \"fr\"];\n;\n```\n\n## كيف يمكنني الإبلاغ عن الأخطاء أو طلب ميزات؟\n\n- **مشكلات GitHub**: [فتح مشكلة](https://github.com/lingodotdev/lingo.dev/issues)\n- **مجتمع Discord**: [انضم إلى Discord الخاص بنا](https://lingo.dev/go/discord)\n- **طلبات الميزات**: استخدم مناقشات GitHub لاقتراحات الميزات\n\n## الخطوات التالية\n\n- **ابدأ الآن**: [دليل البدء السريع](../quick-start)\n- **تكامل الإطارات البرمجية**: [Next.js](../frameworks/nextjs-app-router)، [React Router](../frameworks/react-router-v6)، [Vite](../frameworks/vite-react-ts)\n- **الميزات المتقدمة**: [خيارات التكوين](../configuration/advanced)\n","content","\nأسئلة وإجابات شائعة حول **مُجمِّع Lingo.dev**.\n\n## هل يمكنني ترجمة النصوص الحرفية؟\n\nيتبع **مُجمِّع Lingo.dev** اتفاقية أن كل شيء في JSX قابل للترجمة. النصوص الحرفية خارج مكونات JSX غير مترجمة بشكل مقصود.\n\n**السلوك الحالي:**\n\n```tsx\n// هذا لن يتم ترجمته\nconst message = \"Hello world\";\nconst errorText = \"Something went wrong\";\n\n// هذا سيتم ترجمته\nfunction Component() {\n return

Hello world

{message}

{count === 1 ? <>1 item : <>{count} items}

الأسئلة الشائعة