الانتقال إلى المحتوى الرئيسي

إعداد i18 في Overleaf

يصف هذا المستند كيفية إعداد التدويل (i18n) لنسخة Overleaf مستضافة ذاتيًا.
تُرجمت Overleaf إلى لغات متعددة. ومع الإعداد المناسب، يمكنك:
  • تشغيل نسخة Overleaf الخاصة بك بلغة واحدة ثابتة، أو
  • تفعيل لغات متعددة، مما يتيح للمستخدمين تبديل اللغة ديناميكيًا، على غرار www.overleaf.com.

إعداد لغة واحدة

تُضبط لغة الموقع باستخدام متغير البيئة OVERLEAF_SITE_LANGUAGE. تشمل رموز اللغات المدعومة:
  • en - الإنجليزية (الافتراضية)
  • es - الإسبانية
  • pt - البرتغالية
  • de - الألمانية
  • fr - الفرنسية
  • cs - التشيكية
  • nl - الهولندية
  • sv - السويدية
  • it - الإيطالية
  • tr - التركية
  • zh-CN - الصينية (المبسطة)
  • no - النرويجية
  • da - الدنماركية
  • ru - الروسية
  • ko - الكورية
  • ja - اليابانية
  • pl - البولندية
  • fi - الفنلندية
الإنجليزية هي اللغة الافتراضية. لتغيير لغة الواجهة (على سبيل المثال، إلى الصينية المبسطة)، أضف السطر التالي إلى config/variables.env:
config/variables.env
ثم طبّق الإعداد:
بعد إعادة تشغيل الخدمات، يُفترض أن تعكس لغة الواجهة في قوائم واجهة الويب الإعداد الجديد.

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

للسماح للمستخدمين بتبديل اللغة دون تسجيل الخروج، يجب إعداد نسخة Overleaf لتقديم لغات مختلفة بناءً على أسماء النطاقات. يفترض هذا القسم ما يلي:
  • نطاقك الأساسي هو overleaftest.com
  • لديك شهادة TLS عامة (wildcard) (مثل *.overleaftest.com)
  • أنك لا تستخدم localhost (لأنه لا يدعم توجيه اللغات المعتمد على النطاقات الفرعية)
للاختبار المحلي، يمكنك استخدام نطاق مثل dev-overleaf.com.
1

إعداد وكيل TLS (Nginx)

يجب أن يمرّر الوكيل العكسي لـ TLS ترويسة Host الأصلية حتى تتمكن Overleaf من تحديد نطاق اللغة الذي وصل إليه المستخدم.تأكد من وجود التوجيه التالي:
فيما يلي مثال على إعداد Nginx:
2

إعداد نطاق ملفات تعريف الارتباط

لمنع تسجيل خروج المستخدمين عند تبديل اللغة، يجب مشاركة ملفات تعريف الارتباط (cookies) عبر النطاقات الفرعية للغات.أضف السطر التالي إلى config/variables.env:
config/variables.env
يضمن ذلك أن تكون ملفات تعريف الارتباط الخاصة بالمصادقة صالحة لجميع النطاقات الفرعية ضمن overleaftest.com.
3

ربط اللغات بالنطاقات

بعد ذلك، حدّد كيفية ربط رموز اللغات بالنطاقات الفرعية باستخدام
OVERLEAF_LANG_DOMAIN_MAPPING.

مثال على الإعداد

config/variables.env
مع هذا الإعداد:
  • https://www.overleaftest.com ← واجهة باللغة الإنجليزية
  • https://cn.overleaftest.com ← واجهة باللغة الصينية المبسطة
يمكنك توسيع هذا الربط بلغات ونطاقات فرعية إضافية حسب الحاجة.
نوصي بتقديم الموقع الرئيسي على www وتضمين المفتاح www دائمًا: اضبط OVERLEAF_SITE_URL على عنوان www (على سبيل المثال https://www.overleaftest.com)، ووجّه المفتاح www إليه، وأعد توجيه النطاق الأساسي إليه كما هو موضح أدناه. المفتاح www هو الموقع الرئيسي ويمكنه استخدام أي لغة. بدونه، يبقى الإدخال الافتراضي www، ويعرض منتقي اللغة عنصرًا إضافيًا للغة الإنجليزية يشير إلى http://127.0.0.1:3000.
4

إعادة توجيه النطاق الأساسي

أخيرًا، أعد توجيه النطاق الأساسي (overleaftest.com) إلى نطاق اللغة الافتراضية (www.overleaftest.com).

أسئلة وأجوبة

الإجابة: يوجد زر اللغة (أيقونة الترجمة) في تذييل الصفحة، على سبيل المثال أسفل قائمة المشاريع. ولا يظهر في المحرر.لا يظهر الزر إلا عندما يربط OVERLEAF_LANG_DOMAIN_MAPPING لغتين أو أكثر، كما هو موضح في إعداد لغات متعددة. عند ضبط OVERLEAF_SITE_LANGUAGE فقط، يستخدم الموقع بأكمله تلك اللغة الواحدة ولا يظهر أي زر.يؤدي اختيار لغة إلى فتح الصفحة نفسها على نطاق تلك اللغة، على سبيل المثال cn.overleaftest.com. ولا يُحفظ الاختيار كإعداد للمستخدم.
الإجابة: لا يحتوي OVERLEAF_LANG_DOMAIN_MAPPING على المفتاح www. يُدمج الربط مع الربط الافتراضي، الذي يحتوي على إدخال www للغة الإنجليزية بالعنوان الداخلي http://127.0.0.1:3000. إذا كان ربطك يستخدم مفاتيح أخرى فقط، مثل cn وen، فسيبقى ذلك الإدخال الافتراضي ويظهر في المنتقي.أضف المفتاح www بعنوان OVERLEAF_SITE_URL، واحذف أي إدخال ثانٍ للغة نفسها، ثم شغّل bin/up -d:
آخر تعديل في ٢ نوفمبر ٢٠٢٦