Typowe błędy i jak je naprawić
Większość problemów nie zatrzymuje dokumentu: nieznane polecenia są pomijane i wymieniane na karcie Problemy, wzór, którego nie da się odczytać, jest pokazywany na czerwono i tam wskazany, a brakujące obrazy lub cytowania są oznaczane w miejscu; tylko obraz EPS zatrzymuje cały dokument.
Jak zgłaszane są problemy
Instalacja TeX zatrzymuje się na pierwszym błędzie i pyta, co zrobić. Scissor LaTeX działa dalej: składa tyle dokumentu, ile się da, a to, z czym sobie nie poradził, wymienia na karcie Problemy pod podglądem. Każdy wpis podaje wiersz, którego dotyczy, jeśli jest znany, a kliknięcie wpisu przenosi do tego miejsca.
Są cztery rodzaje wyników:
| Co widzisz | Co to oznacza | Gdzie szukać |
|---|---|---|
| Komunikat na karcie Problemy, dokument w porządku | Coś zostało pominięte lub opuszczone. | Sekcje poniżej. |
| Wzór pokazany jako czerwony kod źródłowy | Tego wzoru nie udało się odczytać. | Czerwone wzory |
Czerwone [key?] lub szara przerywana ramka | Brakuje cytowania lub obrazu. | Brakujące cytowania i obrazy |
| Brak jakichkolwiek stron, błąd na górze | Cały dokument się nie złożył. | Gdy cały dokument się nie składa |
„Skipped N unknown commands”
To komunikat, który zobaczysz najczęściej; jest odpowiednikiem błędu LaTeX „Undefined control sequence”. Polecenie, którego Scissor LaTeX nie zna, jest pomijane: jego nazwa znika, a tekst w nawiasach klamrowych zostaje.
Nieznane polecenie: nazwa znika, tekst zostaje
The value is \highlightvalue{44} and the unit is \unitname{kg}.Karta Problemy: Skipped 2 unknown commands: \highlightvalue, \unitname
Co zrobić:
- Sprawdź pisownię.
\textbfdziała,\textboldnie. - Jeśli polecenie pochodzi z pakietu, znajdź ten pakiet na stronach pakietów. Niektóre polecenia mają prosty zamiennik.
- Jeśli to Twoje własne polecenie, sprawdź, czy jest zdefiniowane za pomocą
\newcommandprzed pierwszym użyciem (zobacz Własne polecenia).
Z nieznanym środowiskiem jest inaczej: zostaje ono po cichu usunięte, a jego zawartość zostaje, bez żadnego komunikatu. Jeśli tekst wygląda na niesformatowany, sprawdź nazwę środowiska.
„Package ... is not available here”
\usepackage nigdy nie kończy się błędem. Pakiet, którego Scissor LaTeX nie zna, jest odnotowywany na karcie Problemy, a jego formatowanie nie jest stosowane. Reszta dokumentu składa się jak zwykle, a nieznane polecenia z tego pakietu są zgłaszane jako nieznane.
Pakiet, który nie jest dostępny
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}Karta Problemy: 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.
Czerwone wzory
Gdy wzór zawiera coś, czego konwerter matematyki nie potrafi odczytać, wzór ten jest pokazywany jako czerwony kod źródłowy. Nie wpływa to na resztę dokumentu. Karta Problemy podaje wzór, jego wiersz i przyczynę, na przykład „This formula could not be read: \symbf{v} (unknown command: \symbf)”; po dziesięciu wzorach jeszcze jeden wiersz podaje liczbę pozostałych.
\symbf nie jest dostępne, więc wzór jest czerwony
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.Na czerwono: wzoru nie da się odczytać, więc zamiast niego widać jego kod źródłowy.
Typowe przyczyny i rozwiązania:
| Przyczyna | Rozwiązanie |
|---|---|
\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 | Przepisz wzór bez niego. |
$ bez pary | Zamknij wzór. Niezamknięty $ nie jest czerwony: zamienia resztę akapitu, aż do następnego pustego wiersza, w zlaną matematykę kursywą. |
Brakujące cytowania i obrazy
Klucz cytowania, którego nie ma w żadnym pliku .bib, jest wypisywany jako czerwone [key?], a karta Problemy wymienia brakujące klucze. Brakujący obraz staje się szarą przerywaną ramką z nazwą pliku.
Obraz, którego nie ma w projekcie
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
Karta Problemy: Images not in the project: figures/plot.png
Prześlij plik do projektu z tą samą ścieżką albo popraw ścieżkę. Bez rozszerzenia znajdowane są pliki .png, .jpg, .jpeg i .svg; rysunki PDF i EPS również dają ramkę (zobacz Rysunki i obrazy). O cytowaniach przeczytasz w Bibliografie i cytowania.
Inne komunikaty
| Komunikat | Znaczenie | Co zrobić |
|---|---|---|
| „N included files are not part of this conversion” | Pominięto \subfile, \import, \lstinputlisting, \inputminted lub \includepdf. | Użyj \input albo wklej zawartość. |
| „File not found: ...” | \input lub \include wskazuje plik, którego nie ma w projekcie. | Sprawdź ścieżkę od głównego folderu projektu. |
| „N pictures of an unsupported kind are not included” | Pominięto środowisko tikzcd, circuitikz, forest lub picture. | Zobacz Rysunki w TikZ. |
| „TikZ option '...' is not supported yet” | Rysunek używa opcji, której silnik rysunków nie zna. Rysunek jest rysowany bez niej. | Sprawdź opcję albo ją usuń. |
| „Layout in the style of ... Not official.” | Klasa lub pakiet konferencyjny przełączył dokument na układ wzorowany na oryginale. | Nic; to tylko informacja. |
| „Macro expansion stopped at the safety limit” | Polecenie rozwija się w samo siebie albo w ogromną ilość tekstu. | Poszukaj \newcommand, które używa własnej nazwy. |
| „This formula could not be read: ...” | Wzór jest pokazany na czerwono; przyczyna jest w nawiasie. | Zobacz Czerwone wzory. |
| „References to labels that do not exist (shown as ??): ...” | \ref, \eqref, \pageref lub \cref wskazuje etykietę, która nie jest zdefiniowana, albo etykietę na czerwonym wzorze. | Sprawdź pisownię etykiety. |
| „Bibliography style ... is not available; using numbered references [1] instead” | \bibliographystyle podaje styl, którego nie ma na liście, na przykład alpha. | Wybierz styl z listy albo zostaw odwołania numerowane. |
| „Skipped .bib entries: ...” | Tych wpisów pliku .bib nie udało się odczytać (brakujący nawias, powtórzony klucz); pozostałe są używane. | Popraw wpis we wskazanym wierszu. |
Błędy LaTeX, których tu nie zobaczysz
Niektóre klasyczne błędy LaTeX niczego w Scissor LaTeX nie zatrzymują, przez co łatwo je przeoczyć:
| Błąd LaTeX | Co robi Scissor LaTeX |
|---|---|
„Missing $ inserted” dla x_1 w tekście | Wypisuje x_1 dosłownie. Umieść matematykę w $...$. |
| „Misplaced alignment tab character &” | Wypisuje & dosłownie. Aby uzyskać znak &, napisz \&. |
| „Extra }, or forgotten $” | Ignoruje niezrównoważone nawiasy klamrowe. |
| „\begin{itemize} ended by \end{document}” | Sam zamyka środowisko. |
| „Reference ... undefined” | Wypisuje pogrubione ??; karta Problemy wymienia brakujące etykiety. |
Tekst, który LaTeX by odrzucił
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.Takie dokumenty mogą się nie skompilować w instalacji TeX, więc popraw je, nawet jeśli podgląd wygląda dobrze.
Czym to się różni od instalacji TeX
Listę kontrolną według objawów znajdziesz w Rozwiązywanie problemów.
Pytania i odpowiedzi
Co oznacza „Undefined control sequence”?
LaTeX nie zna polecenia, zwykle z powodu literówki lub brakującego pakietu. W Scissor LaTeX ta sama sytuacja pojawia się na karcie Problemy jako „Skipped N unknown commands”, a dokument nadal się składa.
Dlaczego mój wzór jest czerwony?
Wzór zawiera polecenie, którego konwerter matematyki nie zna, na przykład \symbf lub \abs. Karta Problemy je wskazuje. Zastąp to polecenie; tabela na tej stronie wymienia typowe zamienniki.
Dlaczego w moim dokumencie widzę [key?]?
Klucza cytowania nie ma w żadnym pliku .bib projektu. Sprawdź pisownię i to, czy plik .bib został przesłany.
Każdy przykład na tej stronie jest składany przez Scissor LaTeX podczas budowania witryny. Ostatnia aktualizacja: 2026-11-07.