Naar de inhoud

Projecten met meerdere bestanden

Houd de preambule en \begin{document} in main.tex en haal de andere bestanden binnen met \input{chapters/intro} of \include{chapters/intro}; Scissor LaTeX voegt ze samen tot één document voordat het zet.

Waarom een document splitsen

Aan een scriptie of een lang verslag werk je makkelijker in stukken: één bestand per hoofdstuk, één voor de preambule, één voor de bijlage. LaTeX heeft hiervoor twee commando's, en beide werken in Scissor LaTeX.

CommandoWat het doetIn Scissor LaTeX
\input{file}Zet de tekst van het bestand precies hier, alsof je hem zelf had getypt.Werkt, ook in de preambule en genest.
\include{file}Begint een nieuwe pagina, zet de tekst van het bestand hier en sluit de pagina af.Werkt. Pagina-einden achter elkaar worden één einde, dus er ontstaan geen lege pagina's.
\includeonly{a,b}Laat elke \include weg die niet in de lijst staat.Genegeerd: alle bestanden worden opgenomen.
\subfile{file} (subfiles)Zoals \input, voor bestanden die ook los compileren.Niet ondersteund: overgeslagen met een melding. Gebruik \input.
\import{dir/}{file} (import)\input relatief ten opzichte van een andere map.Niet ondersteund: overgeslagen met een melding.

Een klein project

Een typisch project heeft een hoofdbestand en een map met hoofdstukken:

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

Het hoofdbestand bevat de klasse, de preambule en de body van het document, en haalt de rest binnen:

LaTeX
\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}

Elk hoofdstukbestand bevat alleen zijn deel van de tekst, zonder preambule en zonder \begin{document}:

LaTeX
\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 vervangt elke \input en \include door de tekst van het bestand en zet het resultaat als één document. Labels, verwijzingen en citaties werken over bestanden heen, want voor de zetmachine is het allemaal één tekst.

Hoe het samengevoegde document eruitziet

Dit zet de editor als main.tex twee hoofdstukbestanden binnenhaalt met \input: de tekst van beide bestanden, op volgorde. (Het voorbeeld is als één bestand geschreven, zodat het hier getoond kan worden.) In een report of book begint \chapter elk hoofdstuk vanzelf op een nieuwe pagina.

Twee hoofdstukbestanden, samengevoegd tot één document

\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}
Gezet door Scissor LaTeX: Twee hoofdstukbestanden, samengevoegd tot één document
Pagina 2

Hoe bestandsnamen worden gevonden

  • Paden zijn relatief ten opzichte van de bovenste map van het project, zoals ze in LaTeX relatief zijn ten opzichte van de map van het hoofdbestand, ook in geneste bestanden.
  • De extensie .tex mag je weglaten: \input{chapters/intro} vindt chapters/intro.tex.
  • Aanhalingstekens om een naam, zoals in \input{"my file"}, worden verwijderd.
  • Een bestand dat ontbreekt, staat als fout in het tabblad Problemen, met de regel van de \input. De rest van het document wordt toch gezet.
  • Een bestand dat zichzelf opneemt, rechtstreeks of via andere bestanden, wordt met een melding weggelaten, en nesten stopt na 24 niveaus.

subfiles en \includeonly

Met het pakket subfiles kan elk hoofdstuk los compileren. Scissor LaTeX volgt \subfile niet: het commando wordt overgeslagen en het tabblad Problemen meldt dat een bestand niet is opgenomen.

\subfile wordt niet gevolgd

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

Tabblad Problemen: 1 included file is not part of this conversion

Om aan één hoofdstuk tegelijk te werken, zet je de andere \include-regels uit met %. \includeonly wordt geaccepteerd maar heeft geen effect: elk opgenomen bestand wordt gezet. Hetzelfde geldt voor \lstinputlisting en \inputminted, die met dezelfde melding worden overgeslagen (zie Codevoorbeelden).

Andere bestanden in het project

Afbeeldingen, .bib-bestanden en databestanden kunnen in elke map staan; verwijs ernaar met hun pad vanaf de bovenste map, zoals \includegraphics{figures/plot.png}. Alle .bib-bestanden in het project worden gebruikt voor citaties, wat \bibliography ook noemt (zie Literatuurlijsten). Om een heel project uit een TeX-installatie over te brengen, zie Projecten en bestanden.

Wat anders is dan in een TeX-installatie

De handleidingen van de verwante pakketten staan op CTAN: subfiles en import.

Vragen en antwoorden

Wat is het verschil tussen \input en \include?

\input plakt de tekst van het bestand op die plek. \include begint en eindigt er ook een nieuwe pagina omheen, en werkt in een TeX-installatie samen met \includeonly. In Scissor LaTeX werken beide voor hoofdstukken; \includeonly wordt genegeerd, dus elke \include wordt gezet.

Waarom wordt mijn \input-bestand niet gevonden?

Controleer het pad vanaf de bovenste map van het project en de spelling, ook hoofdletters. Het tabblad Problemen toont de naam waarnaar werd gezocht en de regel van de \input.

Werkt subfiles in Scissor LaTeX?

Nee. Vervang \subfile{...} door \input{...}; de hoofdstukbestanden hebben dan geen eigen preambule nodig.

Elk voorbeeld op deze pagina wordt door Scissor LaTeX gezet wanneer de site wordt gebouwd. Laatst bijgewerkt op 2026-11-07.