Mintlify

ما هو Mintlify؟

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

ما هو 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.8,
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "mdx": {
      "include": ["[locale]/*.mdx", "[locale]/*/*.mdx"]
    }
  }
}

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

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

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

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

• [locale] هو عنصر نائب يتم استبداله في وقت التشغيل باللغات المكونة. عند استخدام حاوية MDX، يجب تضمين العنصر النائب في جميع أنماط include المكونة.
• لا يدعم Lingo.dev CLI أنماط glob المتكررة. ستحتاج إلى إنشاء أنماط include إضافية إذا قمت بإنشاء محتوى في دلائل أعمق.

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

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

1. قم بالتسجيل للحصول على حساب Lingo.dev.

2. قم بتسجيل الدخول إلى Lingo.dev عبر واجهة سطر الأوامر:

   npx lingo.dev@latest login
   

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

   npx lingo.dev@latest run
   

   ستقوم واجهة سطر الأوامر بإنشاء دليل 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.

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

   mint dev
   

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

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

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

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

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