Godot

ترجمة ذكاء اصطناعي لـ Godot باستخدام واجهة سطر أوامر Lingo.dev

ما هي Godot؟

Godot هي محرك ألعاب مفتوح المصدر لإنشاء ألعاب ثنائية وثلاثية الأبعاد. تتضمن دعمًا مدمجًا للتدويل من خلال تنسيقات ملفات CSV وPO لإدارة ترجمات الألعاب.

ما هي واجهة سطر أوامر Lingo.dev؟

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

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

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

الخطوة 1. إعداد ملفات الترجمة

قم بإنشاء ملف CSV للنصوص القابلة للترجمة في لعبتك (مثل strings.csv):

keys,en
WELCOME,"Hello, world"

ستقوم Godot تلقائيًا بإنشاء ملفات .translation من ملف CSV هذا (مثل strings.en.translation، strings.es.translation).

ملاحظة: في Godot، من المتعارف عليه أن تكون المفاتيح بأحرف كبيرة، ولكن هذا ليس مطلوبًا بشكل صارم.

الخطوة 2. تكوين واجهة سطر الأوامر

في جذر مشروع Godot الخاص بك، قم بإنشاء ملف i18n.json:

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

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

  • ملفات CSV التي يجب على واجهة سطر أوامر Lingo.dev ترجمتها
  • اللغات المراد الترجمة بينها

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

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

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

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

    npx lingo.dev@latest login

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

    npx lingo.dev@latest run

    ستقوم واجهة سطر الأوامر بتحديث ملف CSV الخاص بك بالمحتوى المترجم وإنشاء ملف i18n.lock لتتبع ما تمت ترجمته (لمنع إعادة الترجمة غير الضرورية).

الخطوة 4. تكوين اللغات في Godot

  1. انتقل إلى Project > Project Settings.
  2. انتقل إلى علامة التبويب Localization.
  3. انقر على Add.
  4. حدد ملفات .translation التي تم إنشاؤها تلقائيًا.
  5. انقر على Open.

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

عناصر واجهة المستخدم

  1. حدد عقدة (مثل Button أو Label).
  2. افتح لوحة Inspector للعقدة.
  3. اضبط سمة Text على مفتاح من ملف الترجمة (مثل "WELCOME").
  4. تأكد من تمكين خيار Auto Translate. (وهو ممكّن افتراضيًا.)

GDScript

استخدم وظيفة tr للوصول إلى الترجمات:

tr("WELCOME")

C#

استخدم وظيفة Tr للوصول إلى الترجمات:

Tr("WELCOME")

الخطوة 6. اختبار الترجمات

  1. انتقل إلى Project > Project Settings.
  2. قم بتمكين Advanced Settings.
  3. انتقل إلى Internationalization > Locale.
  4. في حقل Test، أدخل لغة محلية (مثل "es").
  5. قم بتشغيل اللعبة.

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

  • رموز اللغات المحلية التي يدعمها Godot ليست مضمونة لتتطابق مع رموز اللغات المحلية التي تدعمها Lingo.dev. لمعرفة رموز اللغات المحلية المتاحة، راجع الوثائق الرسمية.

الخطوات التالية

لمعرفة المزيد عن نظام الترجمة في Godot، راجع: