استخدام GitHub Codespace

أسهل طريقة لتجربة Ayakaleaf Pro هي استخدام GitHub Codespace، حيث تكون جميع متغيرات البيئة مُكوَّنة مسبقًا لضمان إمكانية استخدامه مباشرةً دون أي إعداد.

عند تشغيل حاويات Docker باستخدام GitHub Codespaces، لن يتوقف Codespace تلقائيًا وسيستمر احتساب التكلفة عليه. لمعرفة قواعد الفوترة في GitHub Codespaces، يُرجى الرجوع إلى قواعد فوترة github codespaces.

لإدارة GitHub Codespaces الخاصة بك، يُرجى زيارة https://github.com/codespaces. وعندما لا تعود بحاجة إليه، يُرجى حذف Codespace في الوقت المناسب.

لقد قمنا مسبقًا بتكوين الميزات التالية:

• ترجمة LaTeX في بيئة معزولة باستخدام TeXLive Basic (2024-2026)
• الاستيراد/التصدير عبر Pandoc (من ميزات منصة SaaS)
• مشغّل سكربتات Python (من ميزات منصة SaaS)
• دعم Git-Bridge (من ميزات Server Pro)
• البحث المتقدم في المراجع (من ميزات منصة SaaS)
• لوحة الإدارة (إدارة شاملة للمستخدمين والمشاريع)
• تتبع التغييرات (مع لوحة المراجعة والتعليقات)
• سجل المشروع الكامل (مع الاستعادة والتنزيل)
• لوحة الرموز (من ميزات Server Pro/منصة SaaS)

توفر GitHub Codespaces القياسية مساحة تخزين قدرها 32 جيجابايت. وهذا غير كافٍ لتثبيت texlive-full. لتجربة الصورة الكاملة، قدّم تذكرة دعم إلى GitHub للحصول على Codespace بمشغّلات كبيرة (8 أنوية أو أكثر).

ميزات المزامنة مع GitHub وLDAP وOAuth وSSO والتكامل مع Zotero وغيرها غير مُكوَّنة في بيئة التجربة هذه. يمكنك الرجوع إلى إعدادات toolkit لمزيد من التفاصيل حول كيفية تكوين هذه الميزات في عملية النشر الخاصة بك.

1. أنشئ GitHub Codespace الخاص بك

   انقر على الزر التالي لإنشاء GitHub Codespace الخاص بك. من حيث تكوين الخادم، تكفي عادةً نواتان مع 8 جيجابايت من ذاكرة RAM لحالة تجريبية. إذا كنت تخطط لاستخدام TeX Live Full، فنوصي باختيار تكوين بـ 8 أنوية و64 جيجابايت.

   

2. تهيئة نسخة Overleaf

   عندما يصبح codespace جاهزًا، شغّل الأمر التالي في bash لتهيئة نسخة overleaf الخاصة بك.

   bash

   ./init.sh
   

   قد تحتاج إلى الانتظار 3 دقائق على الأقل حتى يتم سحب جميع صور docker التي تحتاجها.

   
3. اجعل المنفذ 80 متاحًا

   انتقل إلى علامة التبويب Ports، ثم اتبع هذه الخطوات لجعل المنفذ 80 عامًا.

   

   بعد ذلك، يمكنك النقر على Forwarded Address لزيارة نسخة overleaf الخاصة بك. قد تحتاج إلى إضافة /launchpad لزيارة صفحة الترحيب في overleaf.

4. أنشئ حساب المسؤول

   أدخل اسم حساب المسؤول وكلمة المرور، ثم انقر على زر Register.

   
5. استمتع بالكتابة

   حان الوقت الآن للاستمتاع بالكتابة باستخدام $\LaTeX$!

   

​

استخدام صورة TeXLive الكاملة

إذا كان لديك وصول إلى GitHub Codespaces بـ 8 أنوية/64 جيجابايت، فيمكنك استخدام صورة TeXLive Full في بيئة التجربة هذه. يمكنك تغيير متغيرات البيئة التالية في ملف toolkit/config/variables.env لاستخدام صورة TeXLive Full بدلًا من صورة TeXLive Basic.

ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1

بعد تغيير متغيرات البيئة، تحتاج إلى إعادة تشغيل toolkit لتطبيق التغييرات. يمكنك تشغيل الأمر التالي لإعادة تشغيل toolkit.

cd toolkit && bin/up -d