Godot - Lingo.dev CLI

ما هو Godot؟

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

ما هو Lingo.dev CLI؟

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

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

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

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

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

keys,en
WELCOME,"Hello, world"

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

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

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

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

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

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

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

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

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

سجل للحصول على حساب Lingo.dev.
سجل الدخول إلى Lingo.dev عبر CLI:
```
npx lingo.dev@latest login
```
شغل خط أنابيب الترجمة:
```
npx lingo.dev@latest run
```

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

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

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

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

عناصر التحكم في واجهة المستخدم

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

GDScript

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

tr("WELCOME")

C#

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

Tr("WELCOME")

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

انتقل إلى Project > Project Settings.
فعّل Advanced Settings.
انتقل إلى Internationalization > Locale.
في حقل Test، أدخل رمز اللغة (على سبيل المثال، "es").
شغّل اللعبة.

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

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

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

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