Mintlify

ما هو Mintlify؟

Mintlify هي منصة توثيق تنشئ مواقع توثيق جميلة وقابلة للتخصيص. توفر ميزات بحث وتحليلات وساحة تجريب API مدمجة لبناء توثيق حديث للمطورين.

ما هو Lingo.dev CLI؟

Lingo.dev هي منصة ترجمة مدعومة بالذكاء الاصطناعي. يقرأ Lingo.dev CLI الملفات المصدرية، ويرسل المحتوى القابل للترجمة إلى نماذج اللغة الكبيرة، ويكتب الملفات المترجمة مرة أخرى إلى مشروعك.

حول هذا الدليل

يشرح هذا الدليل كيفية إعداد Lingo.dev CLI في موقع توثيق Mintlify. ستتعلم كيفية إنشاء مشروع باستخدام Mintlify، وتكوين خط أنابيب الترجمة، وعرض النتائج.

الخطوة 1. إعداد مشروع Mintlify

1. قم بتثبيت Mintlify CLI:

   npm i -g mint
   

2. استنسخ قالب البداية الخاص بـ Mintlify:

   git clone https://github.com/mintlify/starter.git
   

3. انتقل إلى دليل المشروع:

   cd starter
   

الخطوة 2. إنشاء المحتوى المصدري

1. أنشئ دليلاً لتخزين التوثيق باللغة المصدرية:

   mkdir en
   

2. أنشئ ملفاً يحتوي على بعض محتوى التوثيق (مثل en/overview.mdx):

   ---
   title: "Introduction"
   description: "Welcome to the new home for your documentation"
   ---
   
   ## Getting started
   
   This documentation is automatically translated by Lingo.dev.
   
   ## Features
   
   Our product includes powerful capabilities for modern development.
   

الخطوة 3. تكوين CLI

في جذر المشروع، أنشئ ملف i18n.json:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "mdx": {
      "include": ["[locale]/*.mdx", "[locale]/*/*.mdx"]
    }
  }
}

يحدد هذا الملف:

• الملفات التي يجب على Lingo.dev CLI ترجمتها
• اللغات المراد الترجمة بينها

في هذه الحالة، يترجم التكوين ملفات MDX من الإنجليزية إلى الإسبانية.

من المهم ملاحظة أن:

• [locale] هو عنصر نائب يتم استبداله في وقت التشغيل. يضمن قراءة المحتوى من موقع واحد (مثل en/index.mdx) وكتابته إلى موقع مختلف (مثل es/index.mdx).
• لا يدعم Lingo.dev CLI أنماط glob العودية (مثل **/*.mdx). ستحتاج إلى إنشاء أنماط include إضافية لترجمة الملفات الموجودة داخل الدلائل المتداخلة.

لمعرفة المزيد، راجع تكوين i18n.json.

الخطوة 4. ترجمة المحتوى

1. سجل للحصول على حساب Lingo.dev.

2. سجل الدخول إلى Lingo.dev عبر CLI:

   npx lingo.dev@latest login
   

3. قم بتشغيل خط أنابيب الترجمة:

   npx lingo.dev@latest run
   

   سينشئ CLI دليل es/ لتخزين المحتوى المترجم وملف i18n.lock لتتبع ما تمت ترجمته (لمنع إعادة الترجمة غير الضرورية).

الخطوة 5. استخدام الترجمات

1. في ملف docs.json، أضف خاصية languages إلى كائن navigation:

   {
     "navigation": {
       "languages": []
     }
   }
   

2. لكل لغة مدعومة، أضف كائناً منفصلاً إلى المصفوفة:

   {
     "navigation": {
       "languages": [
         {
           "language": "en",
           "groups": [
             {
               "group": "Getting started",
               "pages": ["en/overview"]
             }
           ]
         },
         {
           "language": "es",
           "groups": [
             {
               "group": "Getting started",
               "pages": ["es/overview"]
             }
           ]
         }
       ]
     }
   }
   

   كن على علم بأن:

   • ستحتاج إلى تكرار بنية التنقل بالكامل بشكل منفصل لكل لغة.
   • يدعم Mintlify فقط مجموعة فرعية من اللغات التي يدعمها Lingo.dev CLI.

3. ابدأ خادم التطوير:

   mint dev
   

4. انتقل إلى http://localhost:3000. يجب أن ترى قائمة منسدلة للتبديل بين اللغات.

القيود المعروفة

• أي نص واجهة مستخدم محدد في ملف docs.json (مثل تسميات مجموعات الشريط الجانبي، نص العنصر النائب للبحث، إلخ) لن تتم ترجمته.

اللغات المدعومة

يدعم Mintlify فقط مجموعة فرعية من اللغات التي يدعمها Lingo.dev CLI. للحصول على القائمة الأكثر تحديثاً، راجع الوثائق الرسمية.