> 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/uk/konfiguraciya/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/7cca5423eb6de52eb2f9080b18e2d34078c86b9c" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/dc59536ee8bddf3e281c291f1175899cf8d7d0a8" 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` на `ID` користувача, який відповідатиме за керування шаблонами у вашому екземплярі, наприклад:

```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=CV та резюме
TEMPLATE_CV_DESCRIPTION=Шаблони для CV та резюме з різними форматами для академічних, промислових і творчих посад.

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/) у вашому локальному екземплярі on-premise.

На жаль, хоча автоматичного способу встановлення відсутніх пакетів немає, у Server Pro є налаштовуваний параметр, який дозволить вашим користувачам компілювати проєкти з доступом до більшої кількості пакетів і безпечнішим способом. Ця функція називається [Ізольовані компіляції](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (також відомі як дочірні контейнери).

Щоб забезпечити сумісність завантажених шаблонів із вашим локальним екземпляром Server Pro, наполегливо рекомендуємо ввімкнути [Ізольовані компіляції](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, пов’язаний із цим шаблоном, що спростить оновлення шаблону в майбутньому.

Якщо ви видалите відповідний проєкт, на сторінці відомостей про шаблон не відображатиметься кнопка «Адміністратор: вихідний проєкт» (див. зображення нижче).

<figure><img src="/files/d1217067c88133c638584f42d20dcd75d0082d11" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Чому для деяких проєктів публікація шаблону займає так багато часу?</summary>

**Відповідь:** Коли ви публікуєте шаблон, ми зберігаємо проєкт як ZIP- і PDF-файл, що зазвичай відбувається швидко. Однак нам також потрібно створити мініатюри для PDF, щоб їх можна було відображати у відомостях про шаблон.

Час створення мініатюр зазвичай залежить від вмісту першої сторінки вашого PDF. Щоб збалансувати якість відображення та час перетворення, ми вибираємо середню ширину.

Однак, якщо перша сторінка PDF містить багато тексту, перетворення мініатюр може зайняти 40 секунд або навіть більше, будь ласка, зачекайте. Ось приклад великого постера — це займе більше часу.

<figure><img src="/files/d41dd8df5289ec15aeb313aec03168bfa956fd04" 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/uk/konfiguraciya/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.
