Projekty z kilkoma plikami

Trzymaj preambułę i \begin{document} w main.tex, a pozostałe pliki dołączaj za pomocą \input{chapters/intro} lub \include{chapters/intro}; Scissor LaTeX łączy je w jeden dokument przed składem.

Po co dzielić dokument

Nad pracą dyplomową czy długim raportem łatwiej pracować w częściach: jeden plik na rozdział, jeden na preambułę, jeden na dodatek. LaTeX ma do tego dwa polecenia i oba działają w Scissor LaTeX.

Mały projekt

Typowy projekt ma plik główny i folder z rozdziałami:

main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bib

Plik główny zawiera klasę, preambułę i treść dokumentu, a resztę dołącza:

\documentclass{report}
\input{preamble}

\title{Rainfall at Two Sites}
\author{Erika Mustermann}

\begin{document}
\maketitle
\input{chapters/intro}
\input{chapters/method}
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

Każdy plik rozdziału zawiera tylko swoją część tekstu, bez preambuły i bez \begin{document}:

\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.

Scissor LaTeX zastępuje każde \input i \include tekstem pliku i składa wynik jako jeden dokument. Etykiety, odwołania i cytowania działają między plikami, bo dla modułu składu to jeden tekst.

Jak wygląda połączony dokument

Tak edytor składa dokument, gdy main.tex dołącza dwa pliki rozdziałów za pomocą \input: tekst obu plików po kolei. (Przykład jest zapisany jako jeden plik, aby można go było tu pokazać). W klasie report lub book polecenie \chapter samo zaczyna każdy rozdział na nowej stronie.

Dwa pliki rozdziałów połączone w jeden dokument

LaTeXKopiujOtwórz w edytorze (otwiera się w nowej karcie)

\documentclass{report}
\begin{document}
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.
\chapter{Method}
\label{chap:method}
Each gauge was emptied after reading, as noted in
Chapter~\ref{chap:intro}.
\end{document}

Jak znajdowane są nazwy plików

• Ścieżki są względne wobec głównego folderu projektu, tak jak w LaTeX są względne wobec folderu pliku głównego, także wewnątrz zagnieżdżonych plików.
• Rozszerzenie .tex można pominąć: \input{chapters/intro} znajduje chapters/intro.tex.
• Cudzysłowy wokół nazwy, jak w \input{"my file"}, są usuwane.
• Brakujący plik jest zgłaszany jako błąd w karcie Problemy, z wierszem polecenia \input. Reszta dokumentu nadal się składa.
• Plik, który dołącza sam siebie, bezpośrednio lub przez inne pliki, jest pomijany z komunikatem, a zagnieżdżanie zatrzymuje się po 24 poziomach.

subfiles i \includeonly

Pakiet subfiles pozwala kompilować każdy rozdział osobno. Scissor LaTeX nie podąża za \subfile: polecenie jest pomijane, a karta Problemy informuje, że plik nie został dołączony.

\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}

Aby pracować nad jednym rozdziałem naraz, zakomentuj pozostałe wiersze \include znakiem %. \includeonly jest akceptowane, ale nie ma żadnego efektu: składany jest każdy dołączony plik. To samo dotyczy \lstinputlisting i \inputminted, które są pomijane z tym samym komunikatem (zobacz Listingi kodu).

Inne pliki w projekcie

Obrazy, pliki .bib i pliki danych mogą znajdować się w dowolnym folderze; odwołuj się do nich ścieżką od głównego folderu, na przykład \includegraphics{figures/plot.png}. Do cytowań używane są wszystkie pliki .bib w projekcie, niezależnie od tego, co wskazuje \bibliography (zobacz Bibliografie). Aby przenieść cały projekt z instalacji TeX, zobacz Projekty i pliki.

Czym różni się od instalacji TeX

Dokumentacje powiązanych pakietów są dostępne w CTAN: subfiles i import.

Każdy przykład na tej stronie jest składany przez Scissor LaTeX podczas budowania witryny. Ostatnia aktualizacja: 2026-11-07.