> ## 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.

# Szablony

<Info>
  Ta funkcja została pierwotnie opracowana przez [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), a następnie zmodyfikowana i zoptymalizowana przez [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro).
</Info>

<Info>
  Domyślnie tylko zalogowani użytkownicy mogą przeglądać galerię i otwierać linki do szablonów. Aby udostępniać szablony niezalogowanym odwiedzającym, ustaw również `OVERLEAF_ALLOW_PUBLIC_ACCESS=true`, zobacz [Dostęp do stron](/pl/on-premises/configuration/overleaf-toolkit/public-access#page-access "mention"). Tworzenie projektu z szablonu zawsze wymaga zalogowania.
</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>

### Konfiguracja

Począwszy od wersji 6.3.0 galeria wykonuje paginację, wyszukiwanie i sortowanie po stronie serwera. Migracja nie jest wymagana. W przypadku dużych galerii zapoznaj się z [opcjonalnymi indeksami MongoDB](/pl/on-premises/release-notes/release-notes-6.x.x#feature-04-template-pagination "mention") w informacjach o wydaniu.

Funkcją Galerii szablonów steruje się za pomocą następujących zmiennych środowiskowych:

* `OVERLEAF_TEMPLATE_GALLERY`: ustaw na `true`, aby włączyć Galerię szablonów.
* `OVERLEAF_TEMPLATE_CATEGORIES`: opcjonalna lista zera lub więcej kluczy kategorii szablonów, rozdzielonych białymi znakami. Prawidłowe klucze to:

  * *`academic-journal`*
  * *`book`*
  * *`presentation`*
  * *`poster`*
  * *`cv`*
  * *`homework`*
  * *`bibliography`*
  * *`calendar`*
  * *`formal-letter`*
  * *`report`*
  * *`thesis`*
  * *`newsletter`*

  Specjalny klucz *`all`* jest dodawany automatycznie. Reprezentuje on kategorię obejmującą wszystkie szablony.

  Dla każdego klucza kategorii można ustawić następujące opcjonalne zmienne środowiskowe:

  * `TEMPLATE_<KEY>_NAME`: wyświetlana nazwa kategorii szablonów.
  * `TEMPLATE_<KEY>_DESCRIPTION`: krótki opis kategorii.

  Jeśli klucz kategorii zawiera łącznik (`-`), w nazwach zmiennych środowiskowych zastąp go podkreślnikiem (`_`).
* `ENABLE_CONVERSIONS`: musi być ustawione na `true`, aby włączyć generowanie miniatur i podglądów szablonów.

### Uprawnienia do publikowania

Administratorzy mogą publikować szablony. Możesz także wyznaczyć użytkownika niebędącego administratorem do zarządzania wybranymi szablonami wyświetlanymi w lokalnej galerii pod adresem `/templates`.

W tym celu ustaw zmienną środowiskową `OVERLEAF_TEMPLATES_USER_ID` w pliku `toolkit/config/variables.env` na `ID` użytkownika, który będzie odpowiedzialny za zarządzanie szablonami w Twojej instancji, na przykład:

```dotenv theme={null}
OVERLEAF_TEMPLATES_USER_ID=56a8865231faeb5f07d69959
```

### Publikowanie szablonów

Dla każdego szablonu, który chcesz przesłać:

1. Utwórz projekt zawierający kod źródłowy szablonu i upewnij się, że się kompiluje.
2. W edytorze wybierz **File** > **Manage Template**.
3. W wyświetlonym formularzu wprowadź szczegóły szablonu:
   * *Tytuł* musi być unikalny.
   * Pole *Opis* obsługuje formatowanie Markdown.
   * Pole *Autor* akceptuje linki sformatowane w Markdown.

Po przesłaniu szczegóły szablonu można edytować, a sam szablon można usunąć na stronie Galerii szablonów. Administratorzy i użytkownik szablonów (`OVERLEAF_TEMPLATES_USER_ID`) mogą zarządzać dowolnym szablonem.

Oto przykład:

```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.

```

### Przenoszenie szablonów z overleaf.com

Ponieważ Overleaf Pro został zaprojektowany do pracy offline, nie istnieje zautomatyzowany sposób integracji szablonów z galerii [overleaf.com](https://www.overleaf.com/) z instalacją lokalną (on-premise). Można to jednak zrobić ręcznie, szablon po szablonie.

Domyślnie Overleaf Pro jest skonfigurowany do używania podstawowego schematu (basic scheme) TeXLive do kompilacji. Ta podstawowa wersja jest lekka i zawiera jedynie bardzo ograniczony podzbiór pakietów LaTeX, co najprawdopodobniej spowoduje u użytkowników błędy brakujących pakietów przy próbie użycia szablonów z [overleaf.com](https://www.overleaf.com/) w lokalnej instancji.

Niestety, choć nie ma automatycznego sposobu instalowania brakujących pakietów, Server Pro oferuje konfigurowalne ustawienie, które pozwala użytkownikom kompilować projekty z dostępem do większej liczby pakietów i w bezpieczniejszy sposób. Funkcja ta nazywa się [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (znana również jako Sibling Containers).

Aby zapewnić zgodność pobranych szablonów z lokalną instancją Server Pro, zdecydowanie zalecamy włączenie [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles), ponieważ funkcja ta zapewni użytkownikom dostęp do tego samego środowiska TeX Live co na [overleaf.com](https://www.overleaf.com/). Obrazy te zawierają najpopularniejsze pakiety i czcionki i zostały już przetestowane z szablonami z naszej galerii.

Dodatkowe informacje o konfigurowaniu wersji TeX Live, spośród których użytkownicy mogą wybierać w swoich projektach, a także o ustawianiu domyślnej wersji obrazu TeX Live dla nowych projektów, znajdziesz w sekcji [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) naszej dokumentacji.

1. Przejdź do [Galerii szablonów](https://www.overleaf.com/latex/templates) na [overleaf.com](https://www.overleaf.com/) i znajdź wymagany szablon, na przykład [IEEE Photonics Journal Paper Template - Example Submission](https://www.overleaf.com/latex/examples/ieee-photonics-journal-paper-template-example-submission/bsfjjfkdsjds)
2. Kliknij przycisk **Open as Template**
3. Kliknij menu projektu i wybierz **Download Source**
4. Następnie zaloguj się na konto w lokalnej instancji Server Pro
5. Na pulpicie projektów kliknij przycisk **New Project** i wybierz **Upload Project**
6. Kliknij przycisk **Select a .zip file** i wybierz pobrany plik zip z szablonem

Użytkownik może następnie korzystać z nowo przesłanego szablonu na własnym koncie, a Ty — jako użytkownik szablonów — możesz go opublikować, aby inni użytkownicy również mogli z niego korzystać.

### Pytania i odpowiedzi

<Accordion title="Czy mogę usunąć projekt po opublikowaniu odpowiadającego mu szablonu?">
  <strong>Odpowiedź:</strong> Tak, ale nie zalecamy tego. Podczas publikowania szablonu tworzymy migawkę projektu i zapisujemy go jako plik zip w stanie z chwili publikacji. Dzięki temu nawet jeśli usuniesz projekt odpowiadający szablonowi, nie wpłynie to na szablon.

  Zapisujemy jednak również ProjectID powiązany z tym szablonem, co ułatwia jego późniejszą aktualizację.

  Jeśli usuniesz odpowiedni projekt, na stronie szczegółów szablonu nie zobaczysz przycisku "Admin: Source Project" (patrz obraz poniżej).

  <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="Dlaczego w przypadku niektórych projektów publikowanie szablonu trwa tak długo?">
  <strong>Odpowiedź:</strong> Podczas publikowania szablonu zapisujemy projekt jako plik zip oraz plik pdf, co zwykle przebiega szybko. Musimy jednak również wygenerować miniatury PDF, aby można je było wyświetlić w szczegółach szablonu.

  Czas generowania miniatur zależy zazwyczaj od zawartości pierwszej strony pliku PDF. Aby zachować równowagę między jakością wyświetlania a czasem konwersji, wybieramy pośrednią szerokość.

  Jeśli jednak pierwsza strona pliku PDF zawiera dużo tekstu, konwersja miniatur może zająć 40 sekund lub nawet więcej — prosimy o cierpliwość. Oto przykład dużego plakatu, którego przetwarzanie potrwa dłużej.

  <Frame caption="Duży plakat">
    <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.