> 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/ru/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 %}
{% endcolumn %} {% column %}
{% 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__NAME`: Отображаемое имя категории шаблонов. * `TEMPLATE__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 Поскольку Overleaf Pro спроектирован для работы в автономном режиме, автоматического способа интеграции [overleaf.com](https://www.overleaf.com/) шаблонов из галереи в вашу локальную установку нет, однако это можно сделать вручную для каждого шаблона отдельно. По умолчанию Overleaf Pro настроен на использование базовой версии схемы TeXLive для компиляции. Эта базовая версия является лёгкой и содержит лишь очень ограниченный набор пакетов LaTeX, что, скорее всего, приведёт к ошибкам отсутствующих пакетов у ваших пользователей при попытке использовать шаблоны с [overleaf.com](https://www.overleaf.com/) в вашем локальном экземпляре, развёрнутом на собственной инфраструктуре. К сожалению, автоматического способа установки отсутствующих пакетов нет, однако в 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-файл шаблона После этого пользователь может использовать этот недавно загруженный шаблон в своей учётной записи или, будучи пользователем шаблонов, вы можете опубликовать его для использования другими пользователями. ### Вопросы и ответы
Можно ли удалить проект после публикации соответствующего шаблона? **Ответ:** Да, но мы не рекомендуем этого делать. Когда вы публикуете шаблон, мы создаём снимок проекта и сохраняем проект в ZIP-файл на момент публикации. Это гарантирует, что даже если вы удалите проект, соответствующий шаблону, шаблон не будет затронут. Однако мы также сохраняем ProjectID, связанный с этим шаблоном, что упрощает обновление шаблона в будущем. Если вы удалите соответствующий проект, на странице сведений о шаблоне не будет отображаться кнопка «Администратор: исходный проект» (см. изображение ниже).
Почему для некоторых проектов публикация шаблона занимает так много времени? **Ответ:** Когда вы публикуете шаблон, мы сохраняем проект как ZIP- и PDF-файл, что обычно происходит быстро. Однако нам также необходимо создать миниатюры для PDF-файла, чтобы они могли отображаться в сведениях о шаблоне. Время создания миниатюр обычно зависит от содержимого первой страницы вашего PDF-файла. Чтобы сбалансировать качество отображения и время конвертации, мы выбираем среднюю ширину. Однако если первая страница PDF содержит много текста, преобразование миниатюр может занять 40 секунд или даже больше — пожалуйста, подождите. Вот пример большого постера: это займёт больше времени.

Большой постер

--- # 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/ru/konfiguraciya/overleaf-toolkit/templates.md?ask=&goal= ``` `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.