> 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/pl/konfiguracja/overleaf-toolkit/templates.md).

# Szablony

{% hint style="info" %}
Ta funkcja została początkowo opracowana przez [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), a następnie zmodyfikowana i zoptymalizowana przez [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/b817be67b1c61525c59e07f9e0edfe14e0267265" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/77b8973a1c7381424220fadb7479994da393f1e5" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Konfiguracja

Funkcja Galerii szablonów jest नियंत्रowana za pomocą następujących zmiennych środowiskowych:

* `OVERLEAF_TEMPLATE_GALLERY`: Ustaw na `true` aby włączyć Galerię szablonów.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Opcjonalna lista oddzielona białymi znakami, zawierająca zero lub więcej kluczy kategorii szablonów. Prawidłowe klucze obejmują:

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

  Specjalny klucz *`all`* jest automatycznie dopisywany. Ten klucz reprezentuje kategorię obejmującą wszystkie szablony.

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

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

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

### Uprawnienia do publikowania

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

Aby to zrobić, musisz ustawić zmienną środowiskową `OVERLEAF_TEMPLATES_USER_ID` w `toolkit/config/variables.env` na `ID` użytkownika, który będzie odpowiedzialny za zarządzanie szablonami w Twojej instancji, na przykład:

```dotenv
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 lewym menu edytora wybierz **Opublikuj jako szablon**.
3. W formularzu, który się pojawi, wprowadź szczegóły szablonu:
   * Pole *Tytuł* musi być unikalny.
   * Pole *Opis* obsługuje formatowanie Markdown.
   * Pole *Autor* przyjmuje linki sformatowane w Markdown.

Po przesłaniu szczegóły szablonu można edytować lub szablon można usunąć za pośrednictwem strony Galerii szablonów. Użytkownicy mogą zarządzać własnymi szablonami; administratorzy mogą zarządzać dowolnym szablonem.

Oto przykład:

{% code overflow="wrap" expandable="true" %}

```dotenv
#################
#   SZABLONY   #
#################

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=Artykuły naukowe
TEMPLATE_ACADEMIC_JOURNAL_DESCRIPTION=Szablony do zgłoszeń do czasopism naukowych, obejmujące formaty dla głównych wydawców i serwerów preprintów.

TEMPLATE_BIBLIOGRAPHY_NAME=Bibliografie
TEMPLATE_BIBLIOGRAPHY_DESCRIPTION=Style do tworzenia i zarządzania bibliografiami za pomocą BibTeX lub BibLaTeX. Nadają się do użycia w pracach naukowych, rozprawach i raportach.

TEMPLATE_BOOK_NAME=Książki
TEMPLATE_BOOK_DESCRIPTION=Szablony do pisania książek lub długich dokumentów, obejmujące strukturę rozdziałów, materiały wstępne i indeksowanie.

TEMPLATE_CALENDAR_NAME=Kalendarze
TEMPLATE_CALENDAR_DESCRIPTION=Szablony do tworzenia kalendarzy rocznych, miesięcznych lub tygodniowych. Przydatne do osobistych planerów lub planowania wydarzeń.

TEMPLATE_CV_NAME=CV i życiorysy
TEMPLATE_CV_DESCRIPTION=Szablony CV i życiorysów z różnymi formatami dla stanowisk naukowych, branżowych i kreatywnych.

TEMPLATE_FORMAL_LETTER_NAME=Listy formalne
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Szablony listów profesjonalnych, takich jak listy motywacyjne, listy rekomendacyjne i oficjalna korespondencja.

TEMPLATE_HOMEWORK_NAME=Zadania domowe
TEMPLATE_HOMEWORK_DESCRIPTION=Szablony do prac domowych, zajęć i zestawów zadań. Zaprojektowane tak, aby były przejrzyste i dobrze uporządkowane dla uczniów i nauczycieli.

TEMPLATE_NEWSLETTER_NAME=Biuletyny
TEMPLATE_NEWSLETTER_DESCRIPTION=Szablony do tworzenia biuletynów w formatach do komunikacji akademickiej, firmowej lub społecznościowej.

TEMPLATE_POSTER_NAME=Postery
TEMPLATE_POSTER_DESCRIPTION=Szablony plakatów naukowych i akademickich, zwykle używane na konferencjach i w prezentacjach badawczych.

TEMPLATE_PRESENTATION_NAME=Prezentacje
TEMPLATE_PRESENTATION_DESCRIPTION=Szablony Beamera i innych formatów prezentacji, dostosowane do wystąpień akademickich i wykładów.

TEMPLATE_REPORT_NAME=Raporty
TEMPLATE_REPORT_DESCRIPTION=Szablony raportów technicznych, laboratoryjnych lub projektowych. Zawierają sekcje na ilustracje, tabele i odwołania.

TEMPLATE_THESIS_NAME=Prace dyplomowe
TEMPLATE_THESIS_DESCRIPTION=Szablony do pisania prac dyplomowych i rozpraw, zgodne z wymogami instytucjonalnego formatowania i zasad cytowania.

TEMPLATE_ALL_NAME=Wszystkie szablony
TEMPLATE_ALL_DESCRIPTION=Przeglądaj kolekcję wszystkich dostępnych szablonów LaTeX, pogrupowanych według typu dokumentu, stylu i przeznaczenia.

```

{% endcode %}

### Przenoszenie szablonów z overleaf.com <a href="#transferring-templates-from-overleaf.com" id="transferring-templates-from-overleaf.com"></a>

Ponieważ Overleaf Pro został zaprojektowany do pracy offline, nie ma automatycznego sposobu integracji [overleaf.com](https://www.overleaf.com/) szablonów z galerii z Twoją instalacją lokalną on-premise, jednak można to zrobić ręcznie, osobno dla każdego szablonu.

Domyślnie Overleaf Pro jest skonfigurowany tak, aby do kompilacji używać podstawowej wersji schematu TeXLive. Ta podstawowa wersja jest lekka i zawiera tylko bardzo ograniczony zestaw pakietów LaTeX, co najprawdopodobniej spowoduje błędy brakujących pakietów u Twoich użytkowników podczas próby użycia szablonów z [overleaf.com](https://www.overleaf.com/) w Twojej lokalnej instancji on-premise.

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

Aby upewnić się, że pobrane szablony są zgodne z Twoją lokalną instancją Server Pro on-premise, zdecydowanie zalecamy włączenie [Sandbox Compiles](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) ponieważ ta funkcja zapewni Twoim użytkownikom dostęp do tego samego środowiska TeX Live jak na [overleaf.com](https://www.overleaf.com/). Te obrazy zawierają najpopularniejsze pakiety i czcionki oraz zostały już przetestowane z naszymi szablonami galerii.

Dodatkowe informacje o konfiguracji wersji TeX Live, spośród których użytkownicy mogą wybierać w swoim projekcie, a także o ustawieniu domyślnej wersji obrazu TeX Live dla nowych projektów znajdziesz w [Zmiana obrazu TeX Live](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles#changing-the-tex-live-image) sekcji naszej dokumentacji.

1. Przejdź do [Galeria 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 **Otwórz jako szablon** przycisk
3. Kliknij menu projektu i wybierz **Pobierz źródło**
4. Następnie zaloguj się na konto Server Pro on-premise
5. Kliknij **Nowy projekt** przycisk na pulpicie projektów i wybierz **Prześlij projekt**
6. Kliknij **Wybierz plik .zip** przycisk i wybierz pobrany plik ZIP szablonu

Użytkownik może następnie używać tego nowo przesłanego szablonu w swoim koncie lub, jako użytkownik szablonów, możesz go opublikować, aby inni użytkownicy mogli z niego korzystać.

### Pytania i odpowiedzi

<details>

<summary>Czy mogę usunąć projekt po opublikowaniu odpowiadającego mu szablonu?</summary>

**Odpowiedź:** Tak, ale nie zalecamy tego robić. Gdy publikujesz szablon, wykonujemy migawkę projektu i zapisujemy projekt jako plik ZIP w momencie publikacji. Dzięki temu nawet jeśli usuniesz projekt odpowiadający szablonowi, szablon nie zostanie naruszony.

Jednak zapisujemy również ProjectID powiązany z tym szablonem, co ułatwia późniejszą aktualizację szablonu.

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

<figure><img src="/files/5396a9c853e4b457b01c27afdd837923910f4241" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Dlaczego w przypadku niektórych projektów opublikowanie szablonu trwa tak długo?</summary>

**Odpowiedź:** Gdy publikujesz szablon, zapisujemy projekt jako plik ZIP i plik PDF, co zwykle przebiega szybko. Jednak musimy też wygenerować miniatury dla pliku PDF, aby można je było wyświetlić w szczegółach szablonu.

Czas generowania miniaturek zwykle zależy od zawartości pierwszej strony pliku PDF. Aby zrównoważyć jakość wyświetlania i czas konwersji, wybieramy pośrednią wartość jako szerokość.

Jeśli jednak pierwsza strona pliku PDF zawiera dużo tekstu, konwersja miniaturek może zająć 40 sekund lub nawet więcej, prosimy o cierpliwość. Oto przykład dużego plakatu, który będzie wymagał więcej czasu.

<figure><img src="/files/901b5ce914839ec94449eb87d94721a230ff73b1" alt="" width="188"><figcaption><p>Duży plakat</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/pl/konfiguracja/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.
