> 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/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 kontrolowana za pomocą następujących zmiennych środowiskowych:

* `OVERLEAF_TEMPLATE_GALLERY`: Ustaw na `true` aby włączyć Galerię szablonów.
* `OVERLEAF_TEMPLATE_CATEGORIES`: Opcjonalna lista od zera do wielu kluczy kategorii szablonów, rozdzielona białymi znakami. Prawidłowe klucze obejmują:

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

  Specjalny klucz *`all`* jest automatycznie dołączany. 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 łącznik (`-`), zamień go na podkreślnik (`_`) w nazwach zmiennych środowiskowych.
* `ENABLE_CONVERSIONS`: Musi być ustawione na `true` aby włączyć generowanie miniatur i podglądów dla szablonów.

### Uprawnienia do publikowania

Administratorzy mogą publikować szablony. Możesz też 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 menu po lewej stronie edytora wybierz **Opublikuj jako szablon**.
3. W formularzu, który się pojawi, wprowadź szczegóły szablonu:
   * Pole *Tytuł* musi być unikalne.
   * Pole *Opis* pole obsługuje formatowanie Markdown.
   * Pole *Autor* pole akceptuje linki w formacie Markdown.

Po przesłaniu szczegóły szablonu można edytować, a sam 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
#################
#   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=Artykuły do czasopism
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. Odpowiednie do użycia w pracach naukowych, pracach dyplomowych 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, strony 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 w różnych formatach dla stanowisk naukowych, branżowych i kreatywnych.

TEMPLATE_FORMAL_LETTER_NAME=Pisma formalne
TEMPLATE_FORMAL_LETTER_DESCRIPTION=Szablony profesjonalnych pism, takich jak listy motywacyjne, listy polecające i korespondencja urzędowa.

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

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

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

TEMPLATE_PRESENTATION_NAME=Prezentacje
TEMPLATE_PRESENTATION_DESCRIPTION=Szablony dla 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 rysunki, tabele i odwołania.

TEMPLATE_THESIS_NAME=Prace dyplomowe
TEMPLATE_THESIS_DESCRIPTION=Szablony do pisania prac dyplomowych i rozpraw, zgodne z zasadami formatowania i cytowania obowiązującymi w instytucji.

TEMPLATE_ALL_NAME=Wszystkie szablony
TEMPLATE_ALL_DESCRIPTION=Przeglądaj kolekcję wszystkich dostępnych szablonów LaTeX, podzielonych 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 zautomatyzowanego sposobu na zintegrowanie [overleaf.com](https://www.overleaf.com/) szablonów z galerii z Twoją lokalną instalacją; można to jednak zrobić ręcznie dla każdego szablonu osobno.

Domyślnie Overleaf Pro jest skonfigurowany do używania podstawowej wersji schematu TeX Live do kompilacji. Ta podstawowa wersja jest lekka i zawiera tylko bardzo ograniczony podzbiór pakietów LaTeX, co najprawdopodobniej spowoduje błędy braku pakietów u Twoich użytkowników podczas próby korzystania z 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, w Server Pro dostępne jest konfigurowalne ustawienie, które pozwoli Twoim użytkownikom kompilować projekty z dostępem do większej liczby pakietów, i to w bezpieczniejszy sposób. Ta funkcja nazywa się [Kompilacje w piaskownicy](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) (znane również jako Sibling Containers).

Aby zapewnić zgodność pobranych szablonów z Twoją lokalną instancją Server Pro, zdecydowanie zalecamy włączenie [Kompilacje w piaskownicy](https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/sandboxed-compiles) tej funkcji, ponieważ zapewni ona Twoim użytkownikom dostęp do tego samego środowiska TeX Live co to 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 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 [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 [Galerii szablonów](https://www.overleaf.com/latex/templates) na [overleaf.com](https://www.overleaf.com/) i znajdź wymagany szablon, na przykład [Szablon artykułu do IEEE Photonics Journal - przykładowe zgłoszenie](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 w lokalnej instalacji
5. Kliknij **Nowy projekt** przycisk w panelu 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 korzystać z tego nowo przesłanego szablonu na swoim koncie, a 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, tworzymy migawkę projektu i zapisujemy projekt jako plik ZIP w momencie publikacji. Dzięki temu nawet jeśli usuniesz projekt odpowiadający szablonowi, sam szablon nie zostanie naruszony.

Zapiszemy również ProjectID powiązany z tym szablonem, co ułatwi Ci późniejszą aktualizację szablonu.

Jeśli usuniesz powiązany projekt, nie zobaczysz przycisku „Administrator: projekt źródłowy” 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 publikowanie szablonu trwa tak długo?</summary>

**Odpowiedź:** Gdy publikujesz szablon, zapisujemy projekt jako plik ZIP i PDF, co zwykle trwa krótko. Musimy jednak również wygenerować miniatury dla pliku PDF, aby można je było wyświetlić w szczegółach szablonu.

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

Jeśli jednak pierwsza strona pliku PDF zawiera dużo tekstu, konwertowanie miniatur może zająć 40 sekund lub nawet więcej, prosimy o cierpliwość. Oto przykład dużego plakatu — zajmie to 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://ayakaleaf-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.
