Intlayer وثائق

مرحبًا بكم في الوثائق الرسمية لـ Intlayer! هنا، ستجد كل ما تحتاجه لتكامل، تكوين، وإتقان Intlayer لجميع احتياجاتك في التدويل (i18n)، سواء كنت تعمل مع Next.js، React، Vite، Express، أو بيئة JavaScript أخرى.

المقدمة

ما هو Intlayer؟

Intlayer هو مكتبة تدويل مصممة خصيصًا لمطوري JavaScript. يتيح لك إعلان المحتوى الخاص بك في أي مكان في الكود الخاص بك. يقوم بتحويل إعلان المحتوى متعدد اللغات إلى قواميس منظمة لتتكامل بسهولة في الكود الخاص بك. باستخدام TypeScript، يجعل Intlayer تطويرك أقوى وأكثر كفاءة.

يوفر Intlayer أيضًا محررًا بصريًا اختياريًا يتيح لك تحرير وإدارة المحتوى الخاص بك بسهولة. هذا المحرر مفيد بشكل خاص للمطورين الذين يفضلون واجهة بصرية لإدارة المحتوى، أو للفرق التي تنشئ المحتوى دون الحاجة إلى القلق بشأن الكود.

مثال على الاستخدام

.└── Components    └── MyComponent        ├── index.content.ts        └── index.tsx

import { t, type Dictionary } from "intlayer";const componentContent = {  key: "component-key",  content: {    myTranslatedContent: t({      en: "Hello World",      fr: "Bonjour le monde",      es: "Hola Mundo",      ar: "مرحبًا بالعالم",    }),  },} satisfies Dictionary;export default componentContent;

import type { FC } from "react";import { useIntlayer } from "react-intlayer";export const MyComponent: FC = () => {  const { myTranslatedContent } = useIntlayer("component-key");  return <span>{myTranslatedContent}</span>;};

الميزات الرئيسية

يقدم Intlayer مجموعة متنوعة من الميزات المصممة لتلبية احتياجات تطوير الويب الحديث. فيما يلي الميزات الرئيسية، مع روابط إلى وثائق مفصلة لكل منها:

• دعم التدويل: عزز الوصول العالمي لتطبيقك مع دعم مدمج للتدويل.
• محرر بصري: حسن سير العمل الخاص بك مع إضافات المحرر المصممة لـ Intlayer. تحقق من دليل المحرر البصري.
• مرونة التكوين: قم بتخصيص الإعداد الخاص بك مع خيارات التكوين الشاملة المفصلة في دليل التكوين.
• أدوات CLI المتقدمة: قم بإدارة مشاريعك بكفاءة باستخدام واجهة سطر الأوامر الخاصة بـ Intlayer. استكشف الإمكانيات في وثائق أدوات CLI.

المفاهيم الأساسية

القاموس

نظم المحتوى متعدد اللغات الخاص بك بالقرب من الكود الخاص بك للحفاظ على كل شيء متسقًا وقابلًا للصيانة.

• ابدأ
  تعرف على أساسيات إعلان المحتوى في Intlayer.

• الترجمة
  فهم كيفية إنشاء الترجمات وتخزينها واستخدامها في تطبيقك.

• التعداد
  إدارة مجموعات البيانات المتكررة أو الثابتة بسهولة عبر لغات مختلفة.

• جلب الوظائف
  تعرف على كيفية جلب المحتوى ديناميكيًا باستخدام منطق مخصص ليتناسب مع سير عمل مشروعك.

البيئات والتكاملات

تم تصميم Intlayer مع مراعاة المرونة، مما يوفر تكاملًا سلسًا عبر الأطر الشائعة وأدوات البناء:

• Intlayer مع Next.js 15
• Intlayer مع Next.js 14 (App Router)
• Intlayer مع Next.js Page Router
• Intlayer مع React CRA
• Intlayer مع Vite + React
• Intlayer مع Express

يتضمن كل دليل تكامل أفضل الممارسات لاستخدام ميزات Intlayer—مثل التقديم من جانب الخادم، التوجيه الديناميكي، أو التقديم من جانب العميل—لذلك يمكنك الحفاظ على تطبيق سريع، صديق لمحركات البحث، وقابل للتوسع بشكل كبير.

المساهمة والتغذية الراجعة

نحن نقدر قوة المصادر المفتوحة والتطوير القائم على المجتمع. إذا كنت ترغب في اقتراح تحسينات، إضافة دليل جديد، أو تصحيح أي مشكلات في وثائقنا، فلا تتردد في تقديم طلب سحب أو فتح مشكلة في مستودع GitHub الخاص بنا.

هل أنت مستعد لترجمة تطبيقك بشكل أسرع وأكثر كفاءة؟ استعرض وثائقنا لبدء استخدام Intlayer اليوم. جرب نهجًا قويًا ومبسطًا للتدويل يحافظ على تنظيم المحتوى الخاص بك ويجعل فريقك أكثر إنتاجية.

ترجمة سعيدة!