إعداد i18 في Overleaf
يصف هذا المستند كيفية إعداد التدويل (i18n) لنسخة 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 ترويسة فيما يلي مثال على إعداد Nginx:
Host الأصلية حتى تتمكن Overleaf من تحديد نطاق اللغة الذي وصل إليه المستخدم.تأكد من وجود التوجيه التالي: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← واجهة باللغة الصينية المبسطة
4
إعادة توجيه النطاق الأساسي
أخيرًا، أعد توجيه النطاق الأساسي (
overleaftest.com) إلى نطاق اللغة الافتراضية (www.overleaftest.com).أسئلة وأجوبة
أين يوجد زر تبديل اللغة؟
أين يوجد زر تبديل اللغة؟
الإجابة: يوجد زر اللغة (أيقونة الترجمة) في تذييل الصفحة، على سبيل المثال أسفل قائمة المشاريع. ولا يظهر في المحرر.لا يظهر الزر إلا عندما يربط
OVERLEAF_LANG_DOMAIN_MAPPING لغتين أو أكثر، كما هو موضح في إعداد لغات متعددة. عند ضبط OVERLEAF_SITE_LANGUAGE فقط، يستخدم الموقع بأكمله تلك اللغة الواحدة ولا يظهر أي زر.يؤدي اختيار لغة إلى فتح الصفحة نفسها على نطاق تلك اللغة، على سبيل المثال cn.overleaftest.com. ولا يُحفظ الاختيار كإعداد للمستخدم.لماذا تفتح إحدى اللغات في المنتقي العنوان http://127.0.0.1:3000؟
لماذا تفتح إحدى اللغات في المنتقي العنوان http://127.0.0.1:3000؟
الإجابة: لا يحتوي
OVERLEAF_LANG_DOMAIN_MAPPING على المفتاح www. يُدمج الربط مع الربط الافتراضي، الذي يحتوي على إدخال www للغة الإنجليزية بالعنوان الداخلي http://127.0.0.1:3000. إذا كان ربطك يستخدم مفاتيح أخرى فقط، مثل cn وen، فسيبقى ذلك الإدخال الافتراضي ويظهر في المنتقي.أضف المفتاح www بعنوان OVERLEAF_SITE_URL، واحذف أي إدخال ثانٍ للغة نفسها، ثم شغّل bin/up -d:
