> 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/wiecej-tematow/08-choosing-a-latex-compiler.md). # Wybór kompilatora LaTeX Style, treść i układ w dokumencie LaTeX są definiowane za pomocą *znaczników* lub *polecenia* w zwykłym pliku .tex plik ten może być użyty do wygenerowania kilku typów wersji dokumentu „czytelnych dla człowieka”. Najłatwiejszym sposobem wygenerowania tego końcowego wyniku jest użycie [Overleaf](http://www.overleaf.com). Overleaf ma gotową do użycia dystrybucję LaTeX, a końcowe dokumenty można generować po prostu klikając przycisk „Recompile”; jeśli dotyczy to ciebie, możesz pominąć ten artykuł. W przeciwnym razie, jeśli musisz się nauczyć, jak kompilować dokumenty na swoim komputerze, ten artykuł opisuje, jak wygenerować wyjście PS, DVI i PDF z pliku LaTeX. ## Wstęp Dokumenty LaTeX to zwykłe dokumenty z rozszerzeniem .tex (zobacz [Tworzenie dokumentu w LaTeX-u](/latex/pl/podstawy-latex-a/01-learn-latex-in-30-minutes.md) artykuł z przykładami), ten zwykły plik tekstowy zawiera pewne polecenia znaczników, których celem jest formatowanie dokumentu, ale jak właściwie wygenerować wynik końcowy?. To zależy od typu dokumentu, który chcesz wygenerować. Załóżmy, że zapisałeś swój dokument i nazwałeś plik „mydocument.tex”. Aby utworzyć plik .PDF, po prostu uruchom to polecenie w terminalu systemowym. `pdflatex mydocument.tex` I pojawi się plik o nazwie „mydocument.pdf”. ## Dystrybucje TeX Zestaw programów, które umożliwiają kompilację dokumentów TeX i LaTeX, nazywa się składaniem TeX lub dystrybucją TeX. Istnieje wiele dystrybucji TeX dostępnych dla różnych systemów operacyjnych: * **MiKTeX** dla Windows * **TeX Live** dla Linuksa i innych systemów podobnych do UNIX-a * **MacTeX** dystrybucja TeX Live dla macOS * **teTeX** dla Linuksa i innych systemów podobnych do UNIX-a; nie jest już obecnie aktywnie rozwijana * **proTeXt** jest oparty na MiKTeX Oczywiście, jeśli nie chcesz przechodzić przez proces instalowania dystrybucji TeX, możesz skorzystać z gotowej do użycia opcji online, takiej jak [Overleaf](http://www.overleaf.com). ## edytory LaTeX Istnieje wiele zaawansowanych edytorów tekstu specjalnie przeznaczonych do LaTeX dla najpopularniejszych systemów operacyjnych, niektóre z nich można pobrać za darmo, podczas gdy inne są oprogramowaniem własnościowym: * Otwarty kod źródłowy: AUCTEX, GNU TeXmacs, Gummi, Kile, LaTeXila, MeWa, TeXShop, TeXnicCenter, Texmaker, TeXstudio, TeXworks * Bezpłatne oprogramowanie: LEd, WinShell * Oprogramowanie własnościowe/Shareware: Inlage, Scientific WorkPlace, WinEdt Istnieją również edytory ogólnego przeznaczenia, które dodają opcje przyjazne dla LaTeX za pomocą wtyczek. Na przykład dobrze znane edytory emacs i vim mają oba rozszerzenie LaTeX, podobnie jak Atom, VS Code i Sublime Text. Warto wspomnieć, że edytor w [Overleaf](http://overleaf.com) można dostosować tak, aby emulował zachowanie emacs lub vim. Jest także *obsługujący motywy*, więc możesz wybrać takie samo podświetlanie składni jak w niektórych z wcześniej wspomnianych edytorów. Te ustawienia znajdziesz, klikając ikonę menu Overleaf, nad panelem listy plików w twoim projekcie Overleaf. ## Formaty wyjściowe We wszystkich dystrybucjach TeX dostępne są trzy formaty wyjściowe. Aby wygenerować określony wynik, dokument musi zostać skompilowany poprzez uruchomienie polecenia w *terminalu* (Linux i macOS) lub w *wierszu poleceń* (Windows). Na przykład, jeśli chcesz skompilować plik o nazwie „mydocument.tex”, możesz użyć jednego z następujących poleceń: **latex mydocument.tex** To utworzy „mydocument.dvi”, dokument DVI **pdflatex mydocument.tex** To wygeneruje „mydocument.pdf”, dokument PDF Istnieją również dodatkowe polecenia, które umożliwiają konwersję między formatami, obsługiwane są także obrazy PS. Zobacz [przewodnik referencyjny](#reference-guide) schematycznego opisu poleceń i formatów wyjściowych. Poniżej przedstawiono opis każdego formatu wyjściowego: * **(DVI)** Format pliku niezależny od urządzenia składa się z danych binarnych opisujących wizualny układ dokumentu w sposób niezależny od konkretnego formatu obrazu, sprzętu wyświetlającego ani drukarki. * **(PS)** Format pliku PostScript opisuje tekst i grafikę na stronie i opiera się na grafice wektorowej. PostScript jest jak dotąd standardem w dziedzinie składu komputerowego. * **(PDF)** Portable Document Format to format pliku oparty na PostScript, używany do przedstawiania dokumentów w sposób niezależny od oprogramowania aplikacyjnego, sprzętu i systemów operacyjnych. Obecnie jest powszechnie używany jako format pliku do drukowania i dystrybucji w sieci. Uwaga: *Większość edytorów obecnie zawiera ikony szybkiego dostępu do kompilowania do różnych formatów wyjściowych, więc nie musisz faktycznie uruchamiać poleceń w wierszu systemowym.* W Overleaf końcowy skompilowany wynik jest zawsze dokumentem PDF. Jeśli musisz wygenerować plik DVI ze swojego projektu Overleaf, oto co możesz zrobić: 1. Upewnij się, że w swoim projekcie używasz wyłącznie obrazów .eps i .ps. 2. Kliknij **ikona menu Overleaf** nad panelem listy plików i ustaw *Kompilator* ustawienie na „LaTeX”. 3. Ponownie skompiluj swój projekt. 4. Kliknij przycisk „Logs and output files” obok przycisku Recompile. 5. Przewiń w prawo do samego dołu i kliknij „Other logs and output files”. 6. Powinieneś wtedy móc pobrać wygenerowany plik .dvi. ![Pobieranie innych plików wyjściowych](/files/f3cd7725eecd273edbfa2301793268b7f2729757) ## Inne kompilatory Pozostałe możliwe ustawienia kompilatora to pdfLaTeX (domyślne), XeLaTeX i LuaLaTeX. Zwykle można pozostać przy pdfLaTeX, ale wybór kompilatora zależy od potrzeb każdego projektu. * LaTeX obsługuje tylko formaty obrazów .eps i .ps do użycia z `\includegraphics`. Jeśli wszystkie obrazy w twoim projekcie są plikami .eps, to to ustawienie kompilatora jest zalecane. * pdfLaTeX obsługuje formaty obrazów .png, .jpg, .pdf. Podczas kompilacji będzie on konwertować obrazy .eps do .pdf w locie, co może wydłużyć wymagany czas kompilacji. (pdfLaTeX może nie być w stanie obsłużyć `pstricks` dobrze na Overleaf.) * XeLaTeX i LuaLaTeX obsługują natywnie UTF-8 bardzo solidnie, a także Truetype i OpenType. Są zatem zalecane, jeśli musisz składać skrypty niełacińskie w Overleaf, w połączeniu z `polyglossia` pakietem. Obsługują też wszystkie formaty obrazów .png, .jpg, .pdf *i* .eps image formats. * XeLaTeX obsługuje `pstricks`; ale LuaLaTeX nie. * Możesz rozszerzyć możliwości LuaLaTeX, osadzając kod Lua bezpośrednio w swoim dokumencie. ## Kompilowanie dokumentów z odwołaniami krzyżowymi W niektórych przypadkach, gdy dokument zawiera odwołania krzyżowe, musisz skompilować źródło dwa razy. Jest to konieczne, aby poprawnie wstawić numery do spisu treści, listy obrazów, numerów odwołań do twierdzeń i tak dalej. Podczas pierwszej kompilacji kompilator LaTeX zapisuje plik .aux z informacjami o różnych numeracjach, a podczas drugiej odczytuje te informacje, aby poprawnie wygenerować spis treści, bibliografię itp. Proces ten można zautomatyzować za pomocą polecenia `latexmk`. Na przykład, aby utworzyć plik pdf z pliku „mydocument.tex”, uruchom `latexmk -pdf mydocument.tex` tylko raz, nawet jeśli dokument zawiera odwołane obrazy i bibliografię. Możesz zmienić *-pdf* na *-dvi* aby ustawić inny typ pliku. ## Przewodnik referencyjny **Przepływ kompilacji pliku LaTeX** ![Przepływ pliku LaTeX](/files/dfaa2959b8259f000bcc4131919ac055f299c83f) ## Dalsza lektura * [Tworzenie dokumentu w LaTeX-u](/latex/pl/podstawy-latex-a/01-learn-latex-in-30-minutes.md) * [Tworzenie dokumentu w Overleaf](/latex/pl/baza-wiedzy/031-creating-a-document-in-overleaf.md) * [Debugowanie błędów przekroczenia limitu czasu kompilacji](/latex/pl/baza-wiedzy/038-fixing-and-preventing-compile-timeouts.md) * [Wieloplikowe projekty LaTeX](/latex/pl/struktura-dokumentu/08-multi-file-latex-projects.md) * [Niezbyt krótki wstęp do LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) --- # 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/wiecej-tematow/08-choosing-a-latex-compiler.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.