> 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/latex/pl/baza-wiedzy/038-fixing-and-preventing-compile-timeouts.md).

# Naprawianie i zapobieganie przekroczeniom czasu kompilacji

Gdy klikniesz **Ponowna kompilacja** przycisk w swoim projekcie Overleaf, uruchamiasz proces, który odczytuje pliki projektu i konwertuje je do złożonego pliku PDF. Jeśli napotkasz błąd przekroczenia limitu czasu kompilacji, oznacza to, że proces kompilacji nie mógł zakończyć się w ramach [limitu czasu kompilacji dla Twojego planu Overleaf](/latex/pl/baza-wiedzy/119-overleaf-plan-limits.md).

Chociaż możliwe jest, że niektóre projekty są zbyt duże lub zbyt złożone, aby wygenerować PDF w dostępnym czasie, przekroczenia czasu kompilacji często da się naprawić lub im zapobiec.

## Kroki rozwiązywania przekroczeń czasu kompilacji

Wykonaj te kroki, aby zidentyfikować i naprawić typowe problemy powodujące przekroczenia czasu kompilacji:

1. [Sprawdź błędy kompilacji i napraw je, korzystając z **Zatrzymaj przy pierwszym błędzie** mode](#first-errors)
2. [Spróbuj **Fast\[draft\]** trybu i zoptymalizuj rozmiary obrazów](#second-images)
3. [Oceń swój projekt pod kątem zadań czasochłonnych](#third-assess)

Oprócz wykonania tych kroków, zapoznaj się również z sugestiami dotyczącymi tego, co zrobić w [określonych sytuacjach przekroczenia limitu czasu](#anchor-advice) a także z tym, [jakie najlepsze praktyki](#anchor-best) warto stosować, aby zapobiegać przekroczeniom czasu kompilacji.

Chociaż wiele projektów można skompilować w dostępnym czasie na bezpłatnym planie Overleaf, jeśli przygotowujesz duży lub złożony dokument, możesz potrzebować [wykupić plan premium](https://www.overleaf.com/user/subscription/plans) aby uzyskać więcej czasu kompilacji.

## Krok 1: Sprawdź błędy kompilacji i napraw je

Niektóre błędy kompilacji albo nagromadzenie się kilku błędów mogą całkowicie zablokować [latexmk build process](https://learn.overleaf.com/learn/Kb/How_does_Overleaf_compile_my_project%3F) i doprowadzić do przekroczenia czasu kompilacji. Aby znaleźć i naprawić błędy, włącz **Zatrzymaj przy pierwszym błędzie** tryb kompilacji w **Ponowna kompilacja** menu rozwijanym:

![Zrzut ekranu pokazujący, jak włączyć tryb kompilacji „Zatrzymaj przy pierwszym błędzie”](/files/bd44de73fffc5285cb6e41b42181a496a2973dcd)

Ta [**Zatrzymaj przy pierwszym błędzie**](/latex/pl/baza-wiedzy/149-using-the-stop-on-first-error-compilation-mode.md) tryb kompilacji robi dokładnie to, czego można się spodziewać — natychmiast zatrzymuje kompilację, gdy napotka błąd. Gdy tak się stanie, nie zostanie wygenerowany żaden PDF, a zostanie wyświetlony komunikat opisujący błąd. Włączenie **Zatrzymaj przy pierwszym błędzie** pozwala znaleźć i naprawić każdy błąd w projekcie, aż projekt będzie wolny od błędów.

Kliknięcie każdego komunikatu o błędzie przeniesie Cię do wiersza w kodzie źródłowym, który powoduje problem, dzięki czemu możesz poprawić kod. Kilka typowych błędów wyjaśniono na [tę stronę](/latex/pl/podstawy-latex-a/05-errors.md), a niektóre wskazówki dotyczące debugowania LaTeX-a znajdują się na [tę stronę](/latex/pl/pytania-i-odpowiedzi/81-tips-and-tricks-for-troubleshooting-latex.md). Zobacz także sekcję [w tym artykule](#anchor-fatal) zawierającą niektóre typowe **krytyczne błędy kompilacji** powodujące przekroczenia czasu kompilacji.

## Krok 2: Spróbuj kompilować w trybie Fast \[draft]

Uwzględnienie w projekcie wielu lub dużych plików obrazów może znacząco wydłużyć czas potrzebny do skompilowania projektu.

Jednym ze sposobów, który może pomóc ustalić, czy przyczyną przekroczenia czasu jest przetwarzanie obrazów, jest próba kompilacji w **Szybki \[szkic]** trybie. Aby to zrobić, wybierz **Szybki \[szkic]** opcję z **menu Recompile**. Zastępuje to wszystkie grafiki prostokątami i znacznie przyspiesza kompilację PDF-a:

![Ustawienie trybu kompilacji draft dla projektu Overleaf](/files/b42311720a5ee0d2d5f45043771a4b0ce67b9e14)

Jeśli Twój dokument kompiluje się w **Szybki \[szkic]** trybie, ale nie kończy kompilacji w **Normalny** trybie, przyczyną mogą być duże lub liczne pliki obrazów.

### Optymalizacja plików obrazów

Jeśli użyłeś wielu dużych plików PNG lub JPEG w wysokiej rozdzielczości, przetwarzanie tych plików może znacząco zwiększyć czas potrzebny do skompilowania projektu. Upewnij się, że:

* Do diagramów i wykresów używaj plików PDF zamiast PNG.
* Pliki JPEG zachowaj do fotografii.

Dodatkowe wskazówki znajdziesz tutaj: [Optymalizacja dużych plików obrazów](/latex/pl/baza-wiedzy/113-optimising-very-large-image-files.md).

## Krok 3: Oceń swój projekt pod kątem zadań czasochłonnych i krytycznych błędów

Jeśli oba **Zatrzymaj przy pierwszym błędzie** i **Fast\[draft]** tryby kompilacji nadal prowadzą do przekroczenia czasu kompilacji, być może trzeba przyjrzeć się temu bliżej, aby zidentyfikować przyczynę przekroczenia czasu kompilacji i (miejmy nadzieję) ją naprawić.

1\. [Przejrzyj listę praktyk i pakietów czasochłonnych, które mogą spowalniać kompilację](#anchor-slow)

2\. [Przejrzyj listę typowych krytycznych błędów, które mogą prowadzić do przekroczenia limitu czasu](#anchor-fatal)

3\. [Sprawdź porady dotyczące konkretnych scenariuszy przekroczenia czasu, które najlepiej opisują Twoją sytuację](#anchor-advice)

### Praktyki i pakiety czasochłonne

Niektóre praktyki i pakiety mogą powodować bardzo wolną kompilację, a nawet przekroczenia czasu.

**Uwzględnianie złożonych rysunków TikZ lub pgfplots**

`TikZ` i [`pgfplots`](https://ctan.org/pkg/pgfplots?lang=en) tworzą świetne grafiki, ale mogą [zajmować dużo czasu przy kompilacji](https://tex.stackexchange.com/a/254946/226). Istnieje [kilka sposobów zewnętrznego zapisywania rysunków TikZ](/latex/pl/pytania-i-odpowiedzi/60-i-have-a-lot-of-tikz-matlab2tikz-or-pgfplots-figures-so-i-m-getting-a-compilation-timeout.-can-i.md) tak aby LaTeX nie musiał ich odrysowywać za każdym razem, gdy tworzy nowy PDF.

**Korzystanie z pakietu mhchem**

Nowsze wersje [`mhchem` pakietu](https://ctan.org/pkg/mhchem?lang=en) mogą kompilować się dłużej. W zależności od tego, do czego go używasz, [`chemformula` pakietu](https://ctan.org/pkg/chemformula) może skrócić czas potrzebny na kompilację. Jeśli już korzystasz z `mhchem`, możesz spróbować użyć go wprost `chemformula` jako zamiennika:

```latex
% \usepackage{mhchem}
\usepackage{chemformula}
\let\ce\ch
```

* **Uwaga**: istnieją różnice składni i możliwości między `mhchem` i `chemformula`, więc to nie zawsze może działać dobrze. Na przykład, `\ce{2H2O}` będzie renderować się poprawnie w `mhchem`, ale z `chemformula` będziesz musiał zapisać to jako `\ch{2 H2O}` z odstępem po początkowym `2`.

**Uwzględnianie wywołań śledzenia lub debugowania**

Jeśli przypadkiem masz `\tracingall` polecenie w dokumencie, może ono zapisywać *dużo* danych do `.log`. Rejestrowanie i przetwarzanie `\tracingall` danych w `.log` pliku może sprawić, że kompilacja stanie się niezwykle wolna. Zaleca się usunięcie `\tracingall` wywołań, a jeśli musisz używać podobnych metod debugowania, skorzystaj z [`śledzenia` pakietu](http://ctan.org/pkg/trace) .

**Korzystanie z pakietu acro**

Użytkownicy [`acro` pakietu](https://www.ctan.org/pkg/acro) zgłaszali, że wersja 3 działa wolno [przy wczytywaniu deklaracji skrótów. Jedną z konsekwencji](https://github.com/cgnieder/acro/issues/205) wydłużonego czasu kompilacji `acro`jest możliwość wywołania przekroczenia czasu kompilacji; na szczęście istnieje obejście: użycie wersji 2 `acro` pakiet.

Przejście z wersji 3 z powrotem do wersji 2 może wymagać edycji projektu, aby zapewnić zgodność z opcjami, funkcjami i poleceniami wersji 2. Dokumentacja wersji 2 jest dostępna w starszych wydaniach kodu źródłowego, które można [pobrać z GitHuba](https://github.com/cgnieder/acro/releases/tag/v2.10).

Oto kilka rzeczy do sprawdzenia podczas powrotu do wersji 2 — ta lista jest daleka od wyczerpującej:

1. Zmodyfikuj główny `.tex` na:
   * zmień `\usepackage{acro}` na `\usepackage{acro}[=v2]`
   * zmień `include=...` klucz opcji `\printacronyms` na `include-classes=...`
2. W każdym `\DeclareAcronym` poleceniu upewnij się, że `tag=...` klucz opcji został zmieniony na `class=...`.

Zapoznaj się z [`acro` dokumentacją wersji 2.10](https://github.com/cgnieder/acro/releases/tag/v2.10) dla poleceń i opcji dostępnych w wersji 2, ale nie w wersji 3.

**Korzystanie z obrazów EPS lub SVG**

Użycie obrazów EPS lub SVG może wymagać dodatkowego przetwarzania, aby przekonwertować je do formatu PDF. To dodatkowe przetwarzanie wydłuży czas potrzebny do skompilowania projektu.

* Chociaż **latex** kompilator obsługuje obrazy EPS bezpośrednio, **pdfLaTeX** kompilator nie obsługuje obrazów EPS, więc podczas jego użycia wymagany jest dodatkowy krok konwersji tych obrazów do PDF. Przetwarzanie jest obsługiwane przez `epstopdf` pakiet, który używa `Ghostscript` do konwersji plików EPS do PDF. Ten krok konwersji może znacznie wydłużyć czas potrzebny do skompilowania projektu.
* Pliki obrazów SVG nie są bezpośrednio obsługiwane przez żaden kompilator LaTeX-a i wymagają użycia `pakietu svg` i polecenia `\includesvg` które udostępnia.  `pakietu svg` pakiet używa `inkscape` do konwersji obrazów SVG do PDF. Ten krok konwersji może znacznie wydłużyć czas potrzebny do skompilowania projektu.

Aby uzyskać szybsze rezultaty, które mogą pomóc uniknąć przekroczeń czasu kompilacji, używaj wersji PDF swoich obrazów zamiast formatów EPS lub SVG.

**Korzystanie z pakietu tabularray**

Ta `tabularray` pakiet stanowi alternatywę dla standardowych poleceń i środowisk służących do tworzenia tabel w LaTeX-u. Niestety pakiet `tabularray` działa bardzo wolno, zwłaszcza w przypadku większych tabel i tych, które używają niektórych typów kolumn. Obecnie zaleca się standardowe metody definiowania tabel zamiast `tabularray` ze względu na kwestie czasu kompilacji.

**Tworzenie nieskończonej pętli w poleceniu**

Podczas kompilacji polecenia LaTeX-a mogą bardzo rzadko uruchomić „nieskończoną pętlę”. Nieskończone pętle są najczęściej powodowane przez błędy w pakietach lub w poleceniach zdefiniowanych przez użytkownika.

Jeśli podejrzewasz, że możesz mieć do czynienia z pętlą, sprawdź, czy przypadkiem nie utworzyłeś [rekurencyjnej](https://en.wikipedia.org/wiki/Recursion) definicji w jednym ze swoich własnych poleceń, na przykład `\newcommand{\foo}{\foo}`.

### Niektóre przyczyny krytycznych błędów kompilacji

Poniżej znajdują się znane przyczyny krytycznych błędów.

**Uwzględnianie pustych linii w wrażliwych poleceniach dotyczących tytułu**

Klasy LaTeX-a i szablony czasopism często udostępniają specjalne polecenia do podawania części tytułu dokumentu. Polecenia te zazwyczaj mają przyjmować proste argumenty, a używanie ich w nieoczekiwany sposób może prowadzić do błędów kompilacji, a nawet przekroczeń czasu. Co najważniejsze, polecenia takie jak `\author{...}`, `\date{...}` i `\title{...}` nie powinny zawierać pustych linii.

**Uwzględnianie zbyt wielu pływających obiektów o stałym położeniu**

Jeśli masz zbyt wiele tabel lub rysunków używających `[H]` identyfikatora umiejscowienia z `float` pakietu, może to spowodować, że LaTeX wpadnie w nieskończoną pętlę, próbując znaleźć odpowiednie miejsca dla wszystkich z nich. Rozważ zastąpienie wszystkich `[H]` z `[hbt!]` i w razie potrzeby sporadycznego `\clearpage` aby opróżnić kolejkę ze wszystkich tabel i rysunków przed wstawieniem podziału strony.

**Błędy w poleceniu \caption i środowiskach tabular**

Oto lista problemów związanych z tabelami, na które należy uważać — ogólnie rzecz biorąc, zachowaj ostrożność podczas składu tabel!

* `\caption{...}` powinno zawsze znajdować się *poza* stronie `tabular` środowiskiem, ponieważ może to powodować krytyczne błędy, jeśli załadowany jest pakiet [`caption` pakietu](https://ctan.org/pkg/caption) , jak pokazano w poniższym przykładzie:

  ```latex
  \documentclass{article}
  \usepackage{caption}
  \begin{document}

  \begin{table}
      \begin{tabular}{c|c}
          \caption{Caption}% \caption{...} powinno znajdować się POZA środowiskiem tabular
          a & b \\
          c & d \\
      \end{tabular}
  \end{table}
  \end{document}
  ```

  [Otwórz ten przykład **który wywołuje błąd przekroczenia czasu w Overleaf**](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Overleaf+timeout+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bcaption%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Btable%7D%0A++++%5Cbegin%7Btabular%7D%7Bc%7Cc%7D%0A++++++++%5Ccaption%7BCaption%7D%25+%5Ccaption%7B...%7D+should+be+OUTSIDE+the+tabular+environment%0A++++++++a+%26+b+%5C%5C%0A++++++++c+%26+d+%5C%5C%0A++++%5Cend%7Btabular%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument)
* Dla kontrastu, zauważ, że `longtable` środowisko *nie* wymaga `\caption{...}` w jego obrębie, jak pokazuje przykład w naszym [artykule pomocy dotyczącym tabel](/latex/pl/rysunki-i-tabele/01-tables.md#multi-page-tables).
* `\caption{...}` nie powinny zawierać `\\`, `\newline`, `\centering`, `\raggedright` itp.
* W niektórych szablonach lub pakietach, `\ref{...}` lub `\cite{...}` w `\caption` może wymagać poprzedzenia `\protect` aby uniknąć krytycznych błędów; na przykład, `\protect\cite{...}`.
* Sprawdź, czy nie ma niepełnych `\cmidrule{...}` w obrębie `tabular` środowisk; wymaga ono zakresu kolumn, więc będziesz musiał napisać `\cmidrule{3-3}` zamiast samego `\cmidrule{3}` jeśli chcesz poziomej linii obejmującej tylko jedną kolumnę.
* Unikaj zagnieżdżonych `tabular` środowisk. Spójrz na pakiet [`makecell` pakietu](https://ctan.org/pkg/makecell?lang=en) jeśli chcesz dodać ręczne podziały wiersza w komórce tabeli, albo na typ kolumny `p{...}` i/lub pakiet [`tabularx`](https://ctan.org/pkg/tabularx) jeśli szukasz sposobów na tworzenie kolumn, które automatycznie zawijają długie wiersze.
* Jeśli masz wiersze tabeli zaczynające się od `[...` być może trzeba dodać `\\relax` po `\\` w poprzednim wierszu.

**Korzystanie z pakietu soul lub changes**

Jeśli używasz pakietu [`soul`](https://ctan.org/pkg/soul) lub [`changes`](https://ctan.org/pkg/changes) do wyróżniania tekstu lub przekreślania go, `\cite` i `\ref` może wymagać poprzedzenia `\protect`; na przykład, `\protect\cite{...}`.

**Korzystanie ze środowiska tikzpicture**

Sprawdź, czy brakuje `;` na końcu poleceń path/node oraz `]` na końcu list parametrów w `tikzpicture`s.

**Korzystanie z pakietu breqn**

Ta [`breqn`](https://ctan.org/pkg/breqn) pakietu `dmath` może wpadać w nieskończone pętle; zastąp je środowiskiem `align` i w razie potrzeby ręcznie dziel wiersze.

**Korzystanie z pakietu babel**

Niektóre [`babel`](https://ctan.org/pkg/babel) opcje językowe zmieniają znaczenie niektórych znaków, co może powodować problemy, gdy znaki te są używane w ich „normalnym” kontekście; na przykład w trybie matematycznym. Aby tego uniknąć, spróbuj użyć opcji `shorthands=off` podczas ładowania babel (np. `\usepackage[shorthands=off]{babel}`).

**Korzystanie z pakietu jabbrv**

Niektóre szablony używają [`jabbrv` pakietu](https://github.com/compholio/jabbrv) do automatycznego skracania tytułów czasopism (zob. [ten przykład Overleaf](https://www.overleaf.com/latex/templates/automatic-journal-abbreviations/mxfsdscmvxcr)). Gdy pole czasopisma w `.bib` pliku zawiera akcentowane znaki Unicode (np. Biología), może to zablokować kompilację i spowodować przekroczenie czasu w Overleaf. Zamiast tego należy użyć poleceń LaTeX-a, np. `Biolog{\'i}a` albo możesz [zmienić kompilator projektu](/latex/pl/baza-wiedzy/026-changing-compiler.md) na `XeLaTeX` lub `LuaLaTeX`, z których oba mają wbudowaną obsługę odczytu znaków Unicode.

## Porady dotyczące niektórych konkretnych sytuacji przekroczenia czasu

### Mój projekt kompilował się bez żadnych błędów, ale teraz widzę przekroczenie czasu kompilacji

Niewielka zmiana może czasem spowodować przekroczenie czasu kompilacji. Aby pomóc zidentyfikować przyczynę problemu i ją naprawić, spróbuj wykonać te kroki:

1. Użyj [Rekompiluj od zera](/latex/pl/baza-wiedzy/028-clearing-the-cache.md) aby usunąć wszelkie przestarzałe wygenerowane pliki, które mogą powodować problemy.
2. Użyj [funkcję historii Overleaf](/latex/pl/wiecej-tematow/49-using-the-history-feature.md) aby znaleźć swoje najnowsze zmiany. Zobacz listę przyczyn krytycznych błędów kompilacji powyżej.
3. Użyj [Zatrzymaj przy pierwszym błędzie](/latex/pl/baza-wiedzy/149-using-the-stop-on-first-error-compilation-mode.md) opcję, aby znaleźć i naprawić każdy błąd, który został przez Ciebie wprowadzony przez pomyłkę.

Możliwe, że niewielka zmiana doprowadziła do krytycznego błędu kompilacji — zobacz [listę krytycznych błędów kompilacji powyżej](#anchor-fatal) w poszukiwaniu możliwych przyczyn.

### Właśnie przesłałem projekt do Overleaf i napotkałem przekroczenie czasu kompilacji

Może brakować w nim kluczowego pliku lub pakietu albo może być on zorganizowany w sposób powodujący problemy z procesem kompilacji Overleaf.

* Jeśli projekt kompilował się bez problemów na Twoim lokalnym komputerze, ale nie chce się skompilować w Overleaf, możliwe, że używasz innej wersji **TeX Live** na własnym komputerze. Możesz [zmienić wersję TeX Live dla swojego projektu](https://www.overleaf.com/blog/new-feature-select-your-tex-live-compiler-version) tak, aby bardziej odpowiadała tej, która pomyślnie skompilowała Twój projekt lokalnie.
* Przesłany projekt może nie mieć optymalnej struktury plików dla Overleaf. Jeśli główny plik tex znajduje się w folderze, kompilator może mieć trudności ze znalezieniem niektórych zależności plików. Jeśli główny plik tex znajduje się w folderze, spróbuj przeorganizować projekt tak, aby główny plik tex znajdował się na najwyższym poziomie projektu.

Postępując zgodnie [z powyższymi instrukcjami dotyczącymi lokalizowania i naprawiania błędów](#first-errors) często można zidentyfikować brakujące pliki, problemy z wersją TeX Live i problemy z organizacją projektu.

### Zrobiłem kopię projektu, który się kompilował, ale teraz napotykam przekroczenie czasu kompilacji

Nowe projekty, w tym kopie istniejących projektów, domyślnie używają najnowszej wersji TeX Live. Jeśli Twój oryginalny projekt był oparty na starszej wersji TeX Live, możliwe, że problemy powodują niezgodności z najnowszą wersją. Spróbuj [zmienić wersję TeX Live](https://www.overleaf.com/blog/new-feature-select-your-tex-live-compiler-version) w nowej kopii tak, aby odpowiadała wersji oryginalnego projektu.

### Nie mogę skompilować projektu, gdy uwzględniam wszystkie sekcje, ale każda z nich kompiluje się dobrze osobno

Skorzystaj z [powyższych porad dotyczących użycia opcji kompilacji Fast\[draft\]](#second-images) aby sprawdzić, czy cały projekt da się skompilować w trybie Fast\[draft].

W niektórych przypadkach możliwe jest pomyślne skompilowanie dużego projektu w dwóch etapach: najpierw uruchamiając go w trybie Fast\[draft], a następnie kompilując w trybie Normalnym.

Sprawdź każdą sekcję projektu, aby zidentyfikować możliwe źródła wolnej kompilacji. Mogą to być [duże pliki obrazów, które można zoptymalizować](#anchor-optimize), lub inne [czasochłonne praktyki lub pakiety](#anchor-slow).

### Mój projekt czasem przekracza limit czasu, ale nie kompiluje się niezawodnie

Twój projekt może działać bardzo blisko maksymalnego czasu kompilacji. Postępuj zgodnie z powyższymi poradami dotyczącymi [naprawiania błędów](#first-errors), [optymalizacji obrazów](#second-images), oraz [unikania czasochłonnych praktyk lub pakietów](#third-assess).

## Najlepsze praktyki zapobiegania przekroczeniom czasu kompilacji

Znacznie lepiej jest zapobiegać przekroczeniom czasu kompilacji niż radzić sobie z czasami stresującym procesem naprawiania ich po wystąpieniu. Te zalecenia powinny pomóc Ci zapobiegać przekroczeniom czasu kompilacji lub szybko się z nich wycofać, gdy już wystąpią.

### Naprawiaj wszystkie błędy kompilacji, gdy tylko się pojawią

Błędy kompilacji są oznaczone czerwoną dymką powiadomienia obok przycisku Recompile, jak opisano na [tę stronę](/latex/pl/pytania-i-odpowiedzi/81-tips-and-tricks-for-troubleshooting-latex.md). Jeśli klikniesz czerwoną dymkę, zobaczysz komunikaty o błędach. Kliknięcie każdego komunikatu o błędzie przeniesie Cię do odpowiedniego wiersza w kodzie źródłowym, dzięki czemu możesz poprawić kod. Zalecamy, aby błędy były poprawiane jak najszybciej, ponieważ pozwolenie im się gromadzić może w przyszłości prowadzić do trudnych do zdiagnozowania i krytycznych błędów.

[Ta strona](/latex/pl/podstawy-latex-a/05-errors.md) wyjaśnia kilka typowych błędów kompilacji. Jeśli masz trudności ze zrozumieniem komunikatu o błędzie, często wyszukanie w Internecie tekstu błędu zaprowadzi Cię do wpisu na blogu lub forum, w którym błąd jest wyjaśniony i podano rozwiązania.

### Oznaczaj wersje swojego projektu przed dużymi zmianami lub ważnymi etapami

Użyj [funkcję historii Overleaf](/latex/pl/wiecej-tematow/49-using-the-history-feature.md) aby oznaczać wersje swojego projektu, dzięki czemu możesz łatwo porównać bieżący projekt z wcześniejszymi wersjami. Może to pomóc szybko znaleźć nowe źródła błędów kompilacji.

### Uporządkuj swoje pliki

Łatwiej jest znaleźć i naprawić problemy, jeśli projekt jest dobrze uporządkowany. Ponadto dobre zarządzanie projektem może umożliwić kompilowanie konkretnych sekcji projektu, co ułatwia identyfikację obszarów, które mogą przyczyniać się do wyjątkowo długiego czasu kompilacji. Proszę [zobacz tutaj](/latex/pl/struktura-dokumentu/07-management-in-a-large-project.md) po porady dotyczące zarządzania dużymi projektami.

## Więcej informacji o kompilowaniu i czasie kompilacji

### Czym właściwie jest „kompilowanie”?

Kompilowanie to proces przekształcania kodu LaTeX w sformatowany plik PDF. [Dowiedz się więcej o tym, jak Overleaf kompiluje projekty LaTeX](/latex/pl/baza-wiedzy/064-how-does-overleaf-compile-my-project.md).

### Limity dozwolonego użytku

Niektóre duże lub złożone dokumenty mogą wymagać dłuższego czasu kompilacji niż limit czasu oczekiwania w darmowym planie Overleaf i mogą wymagać wydłużonego czasu kompilacji dostępnego w naszym [płatnych planach](https://www.overleaf.com/user/subscription/plans). Niektóre projekty mogą nawet wymagać dłuższego czasu kompilacji, niż jest dostępny w naszych płatnych planach. W takich przypadkach może być konieczne pobranie projektu i skompilowanie go lokalnie.

### Wciąż utknąłeś?

Jeśli masz przekroczenie limitu czasu kompilacji, którego nie możesz rozwiązać, korzystając z porad tutaj, proszę [daj nam znać](https://www.overleaf.com/contact).


---

# 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/latex/pl/baza-wiedzy/038-fixing-and-preventing-compile-timeouts.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.