> ## 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.

# القوالب

<Info>
  طُوّرت هذه الميزة في الأصل بواسطة [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep)، ثم عُدّلت وحُسّنت بواسطة [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro).
</Info>

<Info>
  افتراضيًا، لا يمكن إلا للمستخدمين المسجلين دخولهم تصفح المعرض وفتح روابط القوالب. لمشاركة القوالب مع الزوار غير المسجلين، اضبط أيضًا `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`، راجع [الوصول إلى الصفحات](/ar/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention"). يتطلب إنشاء مشروع من قالب تسجيل الدخول دائمًا.
</Info>

<Columns cols={2}>
  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-31.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=5a12bd99f99c99910e7eae3d1b5f010c" alt="" width="3078" height="2405" data-path="images/on-premises/image-31.png" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-32.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=c71bb498c75535f0d2569d55625b31bc" alt="" width="3078" height="2405" data-path="images/on-premises/image-32.png" />
    </Frame>
  </Column>
</Columns>

### الإعداد

بدءًا من الإصدار 6.3.0، يُجري المعرض الترقيم والبحث والفرز على الخادم. ولا يلزم أي ترحيل. وبالنسبة للمعارض الكبيرة، راجع [فهارس MongoDB الاختيارية](/ar/on-premises/release-notes/release-notes-6.x.x#feature-04-template-pagination "mention") في ملاحظات الإصدار.

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

* `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` على `ID` المستخدم الذي سيكون مسؤولًا عن إدارة القوالب داخل نسختك، على سبيل المثال:

```dotenv theme={null}
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

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

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

1. أنشئ مشروعًا يحتوي على الشيفرة المصدرية للقالب وتأكد من أنه يُترجم بنجاح.
2. في المحرر، اختر **File** > **Manage Template**.
3. في النموذج الذي يظهر، أدخل تفاصيل القالب:
   * يجب أن يكون *العنوان* (Title) فريدًا.
   * يدعم حقل *الوصف* (Description) تنسيق Markdown.
   * يقبل حقل *المؤلف* (Author) روابط بتنسيق Markdown.

بعد الإرسال، يمكن تعديل تفاصيل القالب أو حذف القالب عبر صفحة معرض القوالب. ويمكن للمسؤولين ولمستخدم القوالب (`OVERLEAF_TEMPLATES_USER_ID`) إدارة أي قالب.

فيما يلي مثال:

```dotenv wrap expandable theme={null}
#################
#   TEMPLATES   #
#################

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=Journal articles
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Templates for academic journal submissions, including formats for major publishers and preprint servers.

TEMPLATE_BIBLIOGRAPHY_NAME=Bibliographies
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Styles for creating and managing bibliographies with BibTeX or BibLaTeX. Suitable for use in academic papers, theses, and reports.

TEMPLATE_BOOK_NAME=Books
TEMPLATE_BOOK_DESCRIPTION=Templates for writing books or long-form documents, including chapter structuring, front matter, and indexing.

TEMPLATE_CALENDAR_NAME=Calendars
TEMPLATE_CALENDAR_DESCRIPTION=Templates to create yearly, monthly, or weekly calendars. Useful for personal planners or event scheduling.

TEMPLATE_CV_NAME=CVs and résumés
TEMPLATE_CV_DESCRIPTION=Templates for CVs and résumés with various formats for academic, industry, and creative positions.

TEMPLATE_FORMAL_LETTER_NAME=Formal letters
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Templates for professional letters, such as cover letters, recommendation letters, and official correspondence.

TEMPLATE_HOMEWORK_NAME=Assignments
TEMPLATE_HOMEWORK_DESCRIPTION=Templates for homework, coursework, and problem sets. Designed to be clean and well-structured for students and educators.

TEMPLATE_NEWSLETTER_NAME=Newsletters
TEMPLATE_NEWSLETTER_DESCRIPTION=Templates for creating newsletters with formats for academic, corporate, or community communications.

TEMPLATE_POSTER_NAME=Posters
TEMPLATE_POSTER_DESCRIPTION=Templates for scientific and academic posters, typically used in conferences and research presentations.

TEMPLATE_PRESENTATION_NAME=Presentations
TEMPLATE_PRESENTATION_DESCRIPTION=Templates for Beamer and other presentation formats, tailored for academic talks and lectures.

TEMPLATE_REPORT_NAME=Reports
TEMPLATE_REPORT_DESCRIPTION=Templates for technical, lab, or project reports. Includes sections for figures, tables, and references.

TEMPLATE_THESIS_NAME=Theses
TEMPLATE_THESIS_DESCRIPTION=Templates for writing theses and dissertations, following institutional formatting and citation guidelines.

TEMPLATE_ALL_NAME=All templates
TEMPLATE_ALL_DESCRIPTION=Browse a collection of all available LaTeX templates, categorized by document type, style, and purpose.

```

### نقل القوالب من overleaf.com

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

افتراضيًا، يُعدّ Overleaf Pro لاستخدام إصدار المخطط الأساسي (basic scheme) من 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) (وتُعرف أيضًا باسم Sibling Containers).

لضمان توافق القوالب التي تم تنزيلها مع نسخة 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 الافتراضي للمشاريع الجديدة، في قسم [Changing the TeX Live Image](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 Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. انقر على زر **Open as Template**
3. انقر على قائمة المشروع واختر **Download Source**
4. بعد ذلك، سجّل الدخول إلى حساب Server Pro المحلي
5. انقر على زر **New Project** من لوحة المشاريع واختر **Upload Project**
6. انقر على زر **Select a .zip file** واختر ملف zip الخاص بالقالب الذي تم تنزيله

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

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

<Accordion title="هل يمكنني حذف المشروع بعد نشر القالب المقابل له؟">
  <strong>الإجابة:</strong> نعم، لكننا لا نوصي بذلك. عند نشر قالب، نأخذ لقطة من المشروع ونحفظه كملف zip وقت النشر. يضمن ذلك عدم تأثر القالب حتى لو حذفت المشروع المقابل له.

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

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

  <Frame>
    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-30.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=2bc8ec10c24599e1a6d0b247aef23cc9" alt="" width="2720" height="1824" data-path="images/on-premises/image-30.png" />
  </Frame>
</Accordion>

<Accordion title="لماذا يستغرق نشر القالب وقتًا طويلًا جدًا لبعض المشاريع؟">
  <strong>الإجابة:</strong> عند نشر القالب، نحفظ المشروع كملف zip وملف pdf، وهو أمر سريع عادةً. لكننا نحتاج أيضًا إلى إنشاء صور مصغّرة لملف PDF حتى يمكن عرضها في تفاصيل القالب.

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

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

  <Frame caption="ملصق كبير">
    <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/preview.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=8fd572d5ef8b86ea6c62e16a6db8ec10" alt="" width="188" data-path="images/on-premises/preview.png" />
  </Frame>
</Accordion>


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