Veelvoorkomende fouten en hoe je ze oplost
De meeste problemen houden het document niet tegen: onbekende commando's worden overgeslagen en in het tabblad Problemen vermeld, een formule die niet gelezen kan worden, wordt rood getoond en daar genoemd, en ontbrekende afbeeldingen of citaties worden ter plekke gemarkeerd; alleen een EPS-afbeelding laat het hele document stoppen.
Hoe problemen worden gemeld
Een TeX-installatie stopt bij de eerste fout en vraagt je wat je wilt doen. Scissor LaTeX gaat door: het zet zoveel mogelijk van het document en toont wat het niet kon verwerken in het tabblad Problemen onder het voorbeeld. Elke melding heeft de regel waar ze over gaat, als die bekend is, en met een klik spring je ernaartoe.
Er zijn vier soorten resultaat:
| Wat je ziet | Wat het betekent | Waar je kijkt |
|---|---|---|
| Een melding in het tabblad Problemen, document in orde | Er is iets overgeslagen of weggelaten. | De secties hieronder. |
| Een formule die als rode broncode wordt getoond | Die formule kon niet worden gelezen. | Rode formules |
Een rode [key?] of een grijs gestreept kader | Er ontbreekt een citatie of een afbeelding. | Ontbrekende citaties en afbeeldingen |
| Helemaal geen pagina's, een fout bovenaan | Het hele document is mislukt. | Als het hele document niet wordt gezet |
"N onbekende commando's overgeslagen"
Dit is de melding die je het vaakst zult zien, en de tegenhanger van "Undefined control sequence" in LaTeX. Een commando dat Scissor LaTeX niet kent, wordt overgeslagen: de naam verdwijnt, en de tekst tussen de accolades blijft staan.
Een onbekend commando: de naam verdwijnt, de tekst blijft
The value is \highlightvalue{44} and the unit is \unitname{kg}.Tabblad Problemen: Skipped 2 unknown commands: \highlightvalue, \unitname
Wat je kunt doen:
- Controleer de spelling.
\textbfwerkt,\textboldniet. - Als het commando uit een pakket komt, zoek het pakket op in de pakketpagina's. Voor sommige commando's is er een eenvoudige vervanging.
- Als het je eigen commando is, controleer dan of het met
\newcommandis gedefinieerd voordat het wordt gebruikt (zie Je eigen commando's).
Een onbekende omgeving is anders: die wordt zonder melding verwijderd en de inhoud blijft staan. Als tekst er onopgemaakt uitziet, controleer dan de naam van de omgeving.
"Pakket ... is hier niet beschikbaar"
\usepackage mislukt nooit. Een pakket dat Scissor LaTeX niet kent, wordt vermeld in het tabblad Problemen, en de opmaak ervan wordt niet toegepast. De rest van het document wordt gewoon gezet, en commando's uit het pakket die niet bekend zijn, worden als onbekend gemeld.
Een pakket dat niet beschikbaar is
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Tabblad Problemen: Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
Rode formules
Als een formule iets bevat dat de wiskundeomzetter niet kan lezen, wordt die formule als rode broncode getoond. De rest van het document heeft daar geen last van. Het tabblad Problemen noemt de formule, de regel en de reden, zoals "Deze formule kon niet worden gelezen: \mathscr{L}\{f\} (onbekend commando: \mathscr)"; na tien formules geeft nog één regel het aantal van de rest.
\symbf bestaat niet, dus de formule is rood
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.In het rood: de formule kan niet worden gelezen, dus de broncode wordt getoond.
Veelvoorkomende oorzaken en oplossingen:
| Oorzaak | Oplossing |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | Herschrijf de formule zonder dit commando. |
Een $ zonder zijn partner | Sluit de formule af. Een niet-afgesloten $ is niet rood: het verandert de rest van de alinea in aaneengeschreven cursieve wiskunde, tot de volgende lege regel. |
Ontbrekende citaties en afbeeldingen
Een citatiesleutel die in geen enkel .bib-bestand staat, wordt afgedrukt als een rode [key?], en het tabblad Problemen noemt de ontbrekende sleutels. Een ontbrekende afbeelding wordt een grijs gestreept kader met de bestandsnaam.
Een afbeelding die niet in het project staat
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Tabblad Problemen: Images not in the project: figures/plot.png
Upload het bestand naar het project met hetzelfde pad, of verbeter het pad. Zonder extensie worden .png-, .jpg-, .jpeg- en .svg-bestanden gevonden; PDF- en EPS-figuren tonen ook het kader (zie Figuren en afbeeldingen). Voor citaties, zie Literatuurlijsten en citaties.
Andere meldingen
| Melding | Betekenis | Wat je kunt doen |
|---|---|---|
| "N opgenomen bestanden maken geen deel uit van deze omzetting" | \subfile, \import, \lstinputlisting, \inputminted of \includepdf is overgeslagen. | Gebruik \input, of plak de inhoud erin. |
| "Bestand niet gevonden: ..." | Een \input of \include noemt een bestand dat niet in het project staat. | Controleer het pad vanaf de bovenste map van het project. |
| "N tekeningen van een niet-ondersteunde soort zijn niet opgenomen" | Een tikzcd-, circuitikz-, forest- of picture-omgeving is weggelaten. | Zie Tekeningen met TikZ. |
| "TikZ-optie '...' wordt nog niet ondersteund" | Een tekening gebruikt een optie die de tekenengine niet kent. De tekening wordt zonder die optie getekend. | Controleer de optie, of laat haar weg. |
| "Opmaak in de stijl van ... Niet officieel." | Een congresklasse of -pakket is overgeschakeld op een opmaak die erop lijkt. | Niets; dit is ter informatie. |
| "Macro-expansie gestopt bij de veiligheidslimiet" | Een commando expandeert naar zichzelf, of naar een enorme hoeveelheid tekst. | Zoek naar een \newcommand dat zijn eigen naam gebruikt. |
| "Deze formule kon niet worden gelezen: ..." | De formule wordt rood getoond; de reden staat tussen haakjes. | Zie Rode formules. |
| "Verwijzingen naar labels die niet bestaan (getoond als ??): ..." | Een \ref, \eqref, \pageref of \cref noemt een label dat niet is gedefinieerd, of een label op een rode formule. | Controleer de spelling van het label. |
| "Bibliografiestijl ... is niet beschikbaar; in plaats daarvan worden genummerde verwijzingen [1] gebruikt" | \bibliographystyle noemt een stijl die niet in de lijst staat, zoals alpha. | Kies een stijl uit de lijst, of houd de genummerde verwijzingen. |
| "Overgeslagen .bib-items: ..." | Deze items in het .bib-bestand konden niet worden gelezen (een ontbrekende accolade, een dubbele sleutel); de andere worden gebruikt. | Verbeter het item op de genoemde regel. |
LaTeX-fouten die je hier niet ziet
Sommige klassieke LaTeX-fouten houden in Scissor LaTeX niets tegen, waardoor je ze makkelijk over het hoofd ziet:
| LaTeX-fout | Wat Scissor LaTeX doet |
|---|---|
"Missing $ inserted" voor x_1 in tekst | Drukt x_1 letterlijk af. Zet wiskunde in $...$. |
| "Misplaced alignment tab character &" | Drukt & letterlijk af. Schrijf \& voor een ampersand. |
| "Extra }, or forgotten $" | Negeert accolades die niet in balans zijn. |
| "\begin{itemize} ended by \end{document}" | Sluit de omgeving voor je af. |
| "Reference ... undefined" | Drukt een vette ?? af; het tabblad Problemen noemt de ontbrekende labels. |
Tekst die LaTeX zou weigeren
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Deze documenten kunnen in een TeX-installatie nog steeds mislukken, dus verbeter ze, ook al ziet het voorbeeld er goed uit.
Wat anders is dan in een TeX-installatie
Voor een checklist per symptoom, zie Problemen oplossen.
Vragen en antwoorden
Wat betekent "Undefined control sequence"?
LaTeX kent een commando niet, meestal door een typfout of een ontbrekend pakket. In Scissor LaTeX verschijnt dezelfde situatie als "N onbekende commando's overgeslagen" in het tabblad Problemen, en het document wordt toch gezet.
Waarom is mijn formule rood?
De formule bevat een commando dat de wiskundeomzetter niet kent, zoals \symbf of \abs. Het tabblad Problemen noemt het. Vervang dat commando; de tabel op deze pagina geeft veelvoorkomende vervangingen.
Waarom zie ik [key?] in mijn document?
De citatiesleutel staat in geen enkel .bib-bestand van het project. Controleer de spelling en of het .bib-bestand is geüpload.
Elk voorbeeld op deze pagina wordt door Scissor LaTeX gezet wanneer de site wordt gebouwd. Laatst bijgewerkt op 2026-11-07.