5. تخصيص نسختك

​

تخصيص نسختك

قبل تشغيل نسخة Overleaf الخاصة بك لأول مرة، حدّث ملف الإعداد config/variables.env بمعلوماتك المخصصة.

1. تحرير ملف المتغيرات

   افتح config/variables.env في محرر النصوص المفضل لديك وحدّث متغيرات البيئة أدناه بالقيم المطلوبة.

2. متغيرات البيئة المطلوبة

   حدّث المتغيرات التالية في config/variables.env:

   الاسم	الوصف	مثال
   OVERLEAF_SITE_URL	العنوان الذي تتوفر عليه نسخة Overleaf الخاصة بك للعامة. يُستخدم هذا في الروابط العامة وعند الاتصال عبر websockets، لذا يجب إعداده بشكل صحيح!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	سيُستخدم عنوان البريد الإلكتروني هذا كعنوان المرسل from لجميع رسائل البريد الإلكتروني الصادرة.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	عنوان البريد الإلكتروني الذي يمكن للمستخدمين من خلاله التواصل مع الشخص المسؤول عن تشغيل الموقع.	[e-mail]

   بعد تحديث متغيرات البيئة هذه، احفظ الملف واخرج.

3. إعداد Sandbox Compile

   بعد ذلك، قم بإعداد TeX Live Full من أجل sandboxed-compiles.md. افتح config/variables.env وحدّث متغيرات البيئة التالية:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. تشغيل نسختك

   لتشغيل نسختك، نفّذ:

   Start the instance

   bin/up
   

   سيقوم هذا الأمر بتنزيل الصور المطلوبة بما فيها texlive، وإنشاء الحاويات (باستخدام تخصيصاتك)، وتشغيل النسخة. ويُفترض أن ترى مخرجات السجلات من حاويات Docker المختلفة.

   لتشغيلها مرة أخرى لاحقًا (دون الارتباط بمخرجات السجلات)، نفّذ:

   Start without attaching to logs

   bin/start
   

تستخدم Toolkit الأمر docker compose لإدارة حاويات Overleaf في Docker. وتوفر Toolkit مجموعة من السكربتات التي تغلّف docker compose وتتولى معظم التفاصيل نيابةً عنك.

إذا سار كل شيء على ما يرام، فيُفترض أن تتمكن من عرض صفحة تسجيل الدخول لنسخة Overleaf الجديدة بالانتقال إلى http://127.0.0.1/ أو http://localhost/ في متصفحك.

بحسب إعدادات شبكتك ومكان استضافة نسخة Overleaf، قد تحتاج إلى إجراء تغييرات إضافية على الإعدادات. راجع إعدادات Toolkit لمزيد من التفاصيل: toolkit-settings.md