> ## 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/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
</Info>

<Info>
  За замовчуванням переглядати галерею й відкривати посилання на шаблони можуть лише користувачі, які ввійшли в систему. Щоб ділитися шаблонами з відвідувачами без входу, також встановіть `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, див. [Доступ до сторінок](/uk/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](/uk/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 налаштовано на використання базової схеми 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.