> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# استخدام GitHub Codespace

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

<Warning>
  عند تشغيل حاويات Docker باستخدام GitHub Codespaces، لن يتوقف Codespace تلقائيًا وسيستمر **احتساب التكلفة** عليه. لمعرفة قواعد الفوترة في GitHub Codespaces، يُرجى الرجوع إلى [قواعد فوترة github codespaces](https://docs.github.com/en/billing/concepts/product-billing/github-codespaces).

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

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

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

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

ميزات المزامنة مع GitHub وLDAP وOAuth وSSO والتكامل مع Zotero وغيرها ***غير مُكوَّنة*** في بيئة التجربة هذه. يمكنك الرجوع إلى [إعدادات toolkit](/ar/on-premises/configuration/overleaf-toolkit/toolkit-settings) لمزيد من التفاصيل حول كيفية تكوين هذه الميزات في عملية النشر الخاصة بك.

<Steps>
  <Step title="أنشئ GitHub Codespace الخاص بك">
    انقر على الزر التالي لإنشاء GitHub Codespace الخاص بك. من حيث تكوين الخادم، تكفي عادةً **نواتان مع 8 جيجابايت من ذاكرة RAM** لحالة تجريبية. إذا كنت تخطط لاستخدام [**TeX Live Full**](https://github.com/ayaka-notes/texlive-full)، فنوصي باختيار تكوين بـ **8 أنوية و64 جيجابايت**.

    [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/ayaka-notes/ayakaleaf-pro-playground)
  </Step>

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

    ```bash title="bash" theme={null}
    ./init.sh
    ```

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

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-26.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=8566b61de0757c1b270e7e5011d48a3e" alt="" width="1181" height="626" data-path="images/on-premises/image-26.png" />
    </Frame>
  </Step>

  <Step title="اجعل المنفذ 80 متاحًا">
    انتقل إلى علامة التبويب **Ports**، ثم اتبع هذه الخطوات لجعل المنفذ 80 عامًا.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/img-db37d3e4.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=81e5a18f3aebbd396a57d163a2460739" alt="" width="1452" height="694" data-path="images/on-premises/img-db37d3e4.png" />
    </Frame>

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

  <Step title="أنشئ حساب المسؤول">
    أدخل اسم حساب المسؤول وكلمة المرور، ثم انقر على زر Register.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-1ae40ae0.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=82d769561891fd4b4566ee2ad9c48065" alt="" width="2736" height="1798" data-path="images/on-premises/img-1ae40ae0.png" />
    </Frame>
  </Step>

  <Step title="استمتع بالكتابة">
    حان الوقت الآن للاستمتاع بالكتابة باستخدام $\LaTeX$!

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-25.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=1d4e1fac863cbee906d9d3ad2f3c08d7" alt="" width="2104" height="1415" data-path="images/on-premises/image-25.png" />
    </Frame>
  </Step>
</Steps>

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

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

```dotenv wrap theme={null}
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.

```bash theme={null}
cd toolkit && bin/up -d
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.