> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ar/althyeh/overleaf-toolkit/templates.md).

# القوالب

{% hint style="info" %}
تم تطوير هذه الميزة في البداية بواسطة [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep)، ثم تم تعديلها وتحسينها بواسطة [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/59eba97826d772eb39206f8e122f887ac0067204" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/6999420383f0be3220b80b3ba8b6274621c99bc0" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### الإعدادات

تتم إدارة ميزة معرض القوالب باستخدام متغيرات البيئة التالية:

* `OVERLEAF_TEMPLATE_GALLERY`: يجب ضبطه على `true` لتمكين معرض القوالب.
* `OVERLEAF_TEMPLATE_CATEGORIES`: قائمة اختيارية مفصولة بمسافات تحتوي على صفر أو أكثر من مفاتيح فئات القوالب. تشمل المفاتيح الصالحة ما يلي:

  * *`academic-journal`*
  * *`book`*
  * *`presentation`*
  * *`poster`*
  * *`cv`*
  * *`homework`*
  * *`bibliography`*
  * *`calendar`*
  * *`formal-letter`*
  * *`report`*
  * *`thesis`*
  * *`newsletter`*

  المفتاح الخاص *`all`* يُضاف تلقائيًا. ويمثل هذا المفتاح فئةً تشمل جميع القوالب.

  بالنسبة إلى كل مفتاح فئة، يمكن تعيين متغيرات البيئة الاختيارية التالية:

  * `TEMPLATE_<KEY>_NAME`: الاسم المعروض لفئة القالب.
  * `TEMPLATE_<KEY>_DESCRIPTION`: وصف قصير للفئة.

  إذا كان مفتاح الفئة يحتوي على شرطة وصل (`-` )، فاستبدلها بشرطة سفلية (`_` ) في أسماء متغيرات البيئة.
* `ENABLE_CONVERSIONS`: يجب ضبطه على `true` لتمكين إنشاء الصور المصغرة والمعاينات للقوالب.

### أذونات النشر

يمكن للمشرفين نشر القوالب. يمكنك أيضًا تعيين مستخدم غير مشرف لإدارة القوالب المنسقة المعروضة في معرضك المحلي على `/templates`.

للقيام بذلك، ستحتاج إلى تعيين متغير البيئة `OVERLEAF_TEMPLATES_USER_ID` في `toolkit/config/variables.env` إلى `معرّف` المستخدم الذي سيكون مسؤولًا عن إدارة القوالب داخل مثيلك، على سبيل المثال:

```dotenv
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

### نشر القوالب

لكل قالب تريد رفعه:

1. أنشئ مشروعًا يحتوي على الشيفرة المصدرية للقالب وتأكد من أنه يُجمَّع بنجاح.
2. في القائمة اليسرى للمحرر، اختر **نشر كقالب**.
3. في النموذج الذي يظهر، أدخل تفاصيل القالب:
   * يجب أن يكون *العنوان* فريدًا.
   * يجب أن يكون *الوصف* يدعم هذا الحقل تنسيق Markdown.
   * يجب أن يكون *المؤلف* يقبل هذا الحقل روابط بتنسيق Markdown.

بعد الإرسال، يمكن تعديل تفاصيل القالب، أو حذف القالب عبر صفحة معرض القوالب. يمكن للمستخدمين إدارة قوالبهم الخاصة؛ ويمكن للمشرفين إدارة أي قالب.

إليك مثالًا:

{% code overflow="wrap" expandable="true" %}

```dotenv
#################
#   القوالب   #
#################

ENABLE_CONVERSIONS=true

OVERLEAF_TEMPLATE_GALLERY=true
OVERLEAF_TEMPLATE_CATEGORIES=academic-journal book presentation poster cv homework bibliography calendar formal-letter report thesis newsletter

TEMPLATE_ACADEMIC_JOURNAL_NAME=مقالات المجلات
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=قوالب لإرسال المقالات إلى المجلات الأكاديمية، بما في ذلك التنسيقات الخاصة بالناشرين الرئيسيين وخوادم ما قبل الطباعة.

TEMPLATE_BIBLIOGRAPHY_NAME=المراجع
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=أنماط لإنشاء وإدارة قوائم المراجع باستخدام BibTeX أو BibLaTeX. مناسبة للاستخدام في الأوراق الأكاديمية والأطروحات والتقارير.

TEMPLATE_BOOK_NAME=الكتب
TEMPLATE_BOOK_DESCRIPTION=قوالب لكتابة الكتب أو المستندات الطويلة، بما في ذلك هيكلة الفصول، والمقدمات، والفهرسة.

TEMPLATE_CALENDAR_NAME=التقاويم
TEMPLATE_CALENDAR_DESCRIPTION=قوالب لإنشاء تقاويم سنوية أو شهرية أو أسبوعية. مفيدة للمخططات الشخصية أو جدولة الفعاليات.

TEMPLATE_CV_NAME=السير الذاتية والملخصات
TEMPLATE_CV_DESCRIPTION=قوالب للسير الذاتية والملخصات بتنسيقات مختلفة للمناصب الأكاديمية والصناعية والإبداعية.

TEMPLATE_FORMAL_LETTER_NAME=الرسائل الرسمية
TEMPLATE_FORMAL_LETTER_DESCRIPTION=قوالب لرسائل مهنية، مثل رسائل التغطية، ورسائل التوصية، والمراسلات الرسمية.

TEMPLATE_HOMEWORK_NAME=الواجبات
TEMPLATE_HOMEWORK_DESCRIPTION=قوالب للواجبات الدراسية، والأعمال الدراسية، ومجموعات المسائل. مصممة لتكون نظيفة ومنظمة جيدًا للطلاب والمعلمين.

TEMPLATE_NEWSLETTER_NAME=النشرات الإخبارية
TEMPLATE_NEWSLETTER_DESCRIPTION=قوالب لإنشاء النشرات الإخبارية بتنسيقات للتواصل الأكاديمي أو المؤسسي أو المجتمعي.

TEMPLATE_POSTER_NAME=الملصقات
TEMPLATE_POSTER_DESCRIPTION=قوالب للملصقات العلمية والأكاديمية، المستخدمة عادة في المؤتمرات والعروض البحثية.

TEMPLATE_PRESENTATION_NAME=العروض التقديمية
TEMPLATE_PRESENTATION_DESCRIPTION=قوالب لـ Beamer وغيرها من صيغ العروض التقديمية، مصممة للمحاضرات والعروض الأكاديمية.

TEMPLATE_REPORT_NAME=التقارير
TEMPLATE_REPORT_DESCRIPTION=قوالب للتقارير الفنية أو المخبرية أو تقارير المشاريع. تتضمن أقسامًا للأشكال والجداول والمراجع.

TEMPLATE_THESIS_NAME=الأطروحات
TEMPLATE_THESIS_DESCRIPTION=قوالب لكتابة الأطروحات والرسائل الجامعية، وفقًا لإرشادات التنسيق والاستشهاد المؤسسية.

TEMPLATE_ALL_NAME=جميع القوالب
TEMPLATE_ALL_DESCRIPTION=تصفح مجموعة من جميع قوالب LaTeX المتاحة، المصنفة حسب نوع المستند والنمط والغرض.

```

{% endcode %}

### نقل القوالب من overleaf.com <a href="#transferring-templates-from-overleaf.com" id="transferring-templates-from-overleaf.com"></a>

نظرًا لأن Overleaf Pro صُمِّم للعمل دون اتصال، فلا توجد طريقة آلية لدمج [overleaf.com](https://www.overleaf.com/) قوالب المعرض في تثبيتك المحلي داخل المؤسسة، إلا أنه يمكن القيام بذلك يدويًا لكل قالب على حدة.

افتراضيًا، يتم إعداد Overleaf Pro لاستخدام إصدار مخطط أساسي من TeXLive أثناء عمليات التجميع. هذا الإصدار الأساسي خفيف الوزن ولا يحتوي إلا على مجموعة فرعية محدودة جدًا من حزم LaTeX، مما سيؤدي على الأرجح إلى أخطاء تتعلق بالحزم المفقودة لدى المستخدمين عند محاولة استخدام القوالب من [overleaf.com](https://www.overleaf.com/) في مثيلك المحلي داخل المؤسسة.

للأسف، رغم عدم وجود طريقة تلقائية لتثبيت الحزم المفقودة، لدينا إعداد قابل للتهيئة داخل Server Pro يتيح لمستخدميك تجميع المشاريع مع الوصول إلى مزيد من الحزم، وبطريقة أكثر أمانًا. وتُسمّى هذه الميزة [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (المعروفة أيضًا باسم الحاويات الشقيقة).

لضمان توافق القوالب التي تم تنزيلها مع مثيل Server Pro المحلي داخل المؤسسة، نوصي بشدة بتمكين [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) لأن هذه الميزة ستمنح مستخدميك الوصول إلى نفس بيئة TeX Live الموجودة على [overleaf.com](https://www.overleaf.com/). تحتوي هذه الصور على أشهر الحزم والخطوط، وقد تم اختبارها بالفعل مع قوالب معرضنا.

يمكنك العثور على معلومات إضافية حول إعداد إصدارات TeX Live التي يمكن للمستخدمين الاختيار من بينها داخل مشاريعهم، بالإضافة إلى تعيين إصدار صورة TeX Live الافتراضي للمشاريع الجديدة، في [تغيير صورة TeX Live](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) في قسم الوثائق الخاص بنا.

1. انتقل إلى [معرض القوالب](https://www.overleaf.com/latex/templates) على [overleaf.com](https://www.overleaf.com/) وابحث عن القالب المطلوب، على سبيل المثال [قالب ورقة IEEE Photonics Journal - إرسال تجريبي](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. انقر على **فتح كقالب** الزر
3. انقر على قائمة المشروع واختر **تنزيل المصدر**
4. بعد ذلك، سجّل الدخول إلى حساب Server Pro المحلي داخل المؤسسة
5. انقر على **مشروع جديد** من لوحة معلومات المشاريع واختر **رفع مشروع**
6. انقر على **حدّد ملف .zip** واختر ملف القالب المضغوط zip الذي تم تنزيله

يمكن للمستخدم بعد ذلك استخدام هذا القالب الذي تم رفعه حديثًا ضمن حسابه الخاص، أو يمكنك، بصفتك مستخدم القوالب، نشره ليستخدمه مستخدمون آخرون.

### الأسئلة والأجوبة

<details>

<summary>هل يمكنني حذف المشروع بعد نشر القالب المقابل؟</summary>

**الإجابة:** نعم، لكننا لا نوصي بذلك. عند نشر قالب، نلتقط لقطة للمشروع ونحفظ المشروع كملف zip في وقت النشر. وهذا يضمن أنه حتى إذا حذفت المشروع المقابل للقالب، فلن يتأثر القالب.

ومع ذلك، سنسجل أيضًا معرّف المشروع ProjectID المرتبط بهذا القالب، مما يسهل عليك تحديث القالب في المستقبل.

إذا حذفت المشروع المقابل، فلن ترى زر "Admin: Source Project" في صفحة تفاصيل القالب (انظر الصورة أدناه).

<figure><img src="/files/34cc1b9db74b46d57e034ad3e122a46100e38aa4" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>بالنسبة لبعض المشاريع، لماذا يستغرق نشر قالب وقتًا طويلًا إلى هذا الحد؟</summary>

**الإجابة:** عند نشر القالب، نحفظ المشروع كملف zip وملف pdf، وهذا يكون عادةً سريعًا. ومع ذلك، نحتاج أيضًا إلى إنشاء صور مصغرة لملف PDF حتى يمكن عرضها في تفاصيل القالب.

يعتمد وقت إنشاء الصور المصغرة عادةً على محتوى الصفحة الأولى من ملف PDF. ولتحقيق توازن بين جودة العرض ووقت التحويل، نختار قيمة متوسطة للعرض.

ومع ذلك، إذا كانت الصفحة الأولى من ملف PDF تحتوي على الكثير من النص، فقد يستغرق تحويل الصور المصغرة 40 ثانية أو أكثر، لذا يُرجى التحلي بالصبر. إليك مثالًا على ملصق كبير، وسيستغرق وقتًا أطول.

<figure><img src="/files/b9681ff093d43dd93668fce2c2c17a0f5199e98f" alt="" width="188"><figcaption><p>ملصق كبير</p></figcaption></figure>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ar/althyeh/overleaf-toolkit/templates.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.