الانتقال إلى المحتوى الرئيسي
لا تحمّل الواجهة الأمامية إلا مفاتيح الترجمة المدرجة في services/web/frontend/extracted-translations.json (services/web/frontend/translations-loader.js). أما الواجهة الخلفية وقوالبها فتقرأ الملفات الكاملة في services/web/locales/. شغّل هذا في المجلد develop مرة واحدة بعد الإعداد الأول، ومرة أخرى بعد إضافة ترجمة أو تغيير الفرع:
يقوم bin/i18n بأمرين:
  1. يعيد services/web/locales/*.json إلى الملفات الملتزَم بها، ثم يطبّق تصحيحات اللغات بالطريقة نفسها التي تتبعها عمليات بناء الصورة: تحل ملفات أعلى مجلد locales_patches/v* محل ملفات اللغات، وتُدمج locales_patches/added/*.json فوقها مفتاحًا مفتاحًا.
  2. يشغّل yarn run extract-translations بصفته المستخدم node في الحاوية webpack، مما يعيد كتابة extracted-translations.json. وإذا كانت صورة webpack غير موجودة، فإنه يزامن أولًا yarn.lock باستخدام bin/sync ثم يبني الصورة.
يحتاج إلى jq على المضيف.
التغييرات التي يجريها bin/i18n على services/web/locales/*.json محلية فقط. لا تلتزم بها.
أعد استخدام مفتاح موجود كلما أمكن. تأتي ملفات اللغات من Overleaf الأصلي أو من موقع ترجمة تابع لجهة خارجية، لذا لا تعدّلها مباشرة. يوضع المفتاح الجديد في services/web/locales/locales_patches/added/، في ملف كل لغة دفعة واحدة (en.json وzh-CN.json وغيرهما).
آخر تعديل في ٢٠ نوفمبر ٢٠٢٦