> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-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) (також відомі як Sibling Containers).

Щоб завантажені шаблони були сумісні з вашим локальним екземпляром 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://overleaf-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.
