> 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/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=Journal articles TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Шаблоны для отправки в академические журналы, включая форматы для крупных издателей и серверов препринтов. TEMPLATE_BIBLIOGRAPHY_NAME=Bibliographies TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Стили для создания и управления библиографиями с помощью BibTeX или BibLaTeX. Подходит для использования в научных статьях, диссертациях и отчётах. TEMPLATE_BOOK_NAME=Books TEMPLATE_BOOK_DESCRIPTION=Шаблоны для написания книг или длинных документов, включая структуру глав, вступительные материалы и индексацию. TEMPLATE_CALENDAR_NAME=Calendars TEMPLATE_CALENDAR_DESCRIPTION=Шаблоны для создания годовых, месячных или недельных календарей. Полезны для личных планировщиков или расписания мероприятий. TEMPLATE_CV_NAME=CVs and résumés TEMPLATE_CV_DESCRIPTION=Шаблоны для CV и резюме в различных форматах для академических, отраслевых и творческих должностей. TEMPLATE_FORMAL_LETTER_NAME=Formal letters TEMPLATE_FORMAL_LETTER_DESCRIPTION=Шаблоны для профессиональных писем, таких как сопроводительные письма, рекомендательные письма и официальная корреспонденция. TEMPLATE_HOMEWORK_NAME=Assignments TEMPLATE_HOMEWORK_DESCRIPTION=Шаблоны для домашних заданий, курсовых работ и наборов задач. Созданы так, чтобы быть чистыми и хорошо структурированными для студентов и преподавателей. TEMPLATE_NEWSLETTER_NAME=Newsletters TEMPLATE_NEWSLETTER_DESCRIPTION=Шаблоны для создания информационных бюллетеней с форматами для академической, корпоративной или общественной коммуникации. TEMPLATE_POSTER_NAME=Posters TEMPLATE_POSTER_DESCRIPTION=Шаблоны для научных и академических постеров, обычно используемых на конференциях и в исследовательских презентациях. TEMPLATE_PRESENTATION_NAME=Presentations TEMPLATE_PRESENTATION_DESCRIPTION=Шаблоны для Beamer и других форматов презентаций, предназначенные для академических выступлений и лекций. TEMPLATE_REPORT_NAME=Reports TEMPLATE_REPORT_DESCRIPTION=Шаблоны для технических, лабораторных или проектных отчётов. Включают разделы для рисунков, таблиц и ссылок. TEMPLATE_THESIS_NAME=Theses TEMPLATE_THESIS_DESCRIPTION=Шаблоны для написания диссертаций и дипломных работ с соблюдением институциональных требований к форматированию и цитированию. TEMPLATE_ALL_NAME=All templates 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 есть настраиваемый параметр, который позволит вашим пользователям компилировать проекты с доступом к большему числу пакетов и более безопасным способом. Эта функция называется [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 по умолчанию для новых проектов можно найти в [Изменение образа 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://ayakaleaf-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.