Перейти до вмісту
Scissor LaTeX

Поширені помилки і як їх виправити

Більшість проблем не зупиняє документ: невідомі команди пропускаються й перелічуються на вкладці «Проблеми», формула, яку не вдається прочитати, показується червоним і називається там, а відсутні зображення чи цитування позначаються на місці; лише зображення EPS зупиняє весь документ.

Як повідомляється про проблеми

Інсталяція TeX зупиняється на першій помилці й питає вас, що робити. Scissor LaTeX продовжує роботу: він верстає стільки документа, скільки може, а те, з чим не впорався, перелічує на вкладці Проблеми під переглядом. Кожен запис містить рядок, до якого він стосується, якщо той відомий, і клацання по ньому переносить вас туди.

Буває чотири види результату:

Що ви бачитеЩо це означаєДе шукати
Повідомлення на вкладці «Проблеми», документ у порядкуЩось пропущено або не включено.Розділи нижче.
Формула показана як червоний вихідний кодЦю формулу не вдалося прочитати.Червоні формули
Червоне [key?] або сіра пунктирна рамкаБракує цитування чи зображення.Відсутні цитування й зображення
Жодної сторінки, помилка вгоріНе вдалося зверстати весь документ.Коли весь документ не верстається

"Skipped N unknown commands"

Це повідомлення ви бачитимете найчастіше; воно відповідає помилці LaTeX «Undefined control sequence». Команда, якої Scissor LaTeX не знає, пропускається: її назва зникає, а текст у її фігурних дужках лишається.

Невідома команда: назва зникає, текст лишається

LaTeXВідкрити в редакторі
The value is \highlightvalue{44} and the unit is \unitname{kg}.

Вкладка «Проблеми»: Skipped 2 unknown commands: \highlightvalue, \unitname

Що робити:

  • Перевірте написання. \textbf працює, \textbold ні.
  • Якщо команда походить із пакета, знайдіть цей пакет на сторінках пакетів. Для деяких команд є проста заміна.
  • Якщо це ваша власна команда, перевірте, що вона визначена через \newcommand до того, як її використано (див. Власні команди).

Невідоме середовище поводиться інакше: воно мовчки прибирається, а його вміст лишається, без жодного повідомлення. Якщо текст виглядає невідформатованим, перевірте назву середовища.

"Package ... is not available here"

\usepackage ніколи не завершується помилкою. Пакет, якого Scissor LaTeX не знає, відзначається на вкладці «Проблеми», а його форматування не застосовується. Решта документа верстається як зазвичай, а невідомі команди з цього пакета позначаються як невідомі.

Пакет, який недоступний

LaTeXВідкрити в редакторі
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}

Вкладка «Проблеми»: 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.

Червоні формули

Коли формула містить щось, чого конвертер математики не може прочитати, ця формула показується як червоний вихідний код. На решту документа це не впливає. Вкладка «Проблеми» називає формулу, її рядок і причину, наприклад «This formula could not be read: \symbf{v} (unknown command: \symbf)»; після десяти формул ще один рядок подає кількість решти.

\symbf недоступна, тож формула червона

LaTeXВідкрити в редакторі
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.

Червоним: формулу не вдається прочитати, тому замість неї показано вихідний код.

Поширені причини й виправлення:

ПричинаВиправлення
\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Перепишіть формулу без неї.
$ без париЗакрийте формулу. Незакритий $ не стає червоним: він перетворює решту абзацу, до наступного порожнього рядка, на злиту курсивну математику.

Відсутні цитування й зображення

Ключ цитування, якого немає в жодному файлі .bib, виводиться як червоне [key?], а вкладка «Проблеми» перелічує відсутні ключі. Відсутнє зображення стає сірою пунктирною рамкою з назвою файлу.

Зображення, якого немає в проєкті

LaTeXПреамбула: \usepackage{graphicx}Відкрити в редакторі
\begin{figure}[h]
  \centering
  \includegraphics[width=0.5\linewidth]{figures/plot.png}
  \caption{A plot that has not been uploaded yet.}
\end{figure}
Зверстано в Scissor LaTeX: Зображення, якого немає в проєкті

Вкладка «Проблеми»: Images not in the project: figures/plot.png

Додайте файл до проєкту з тим самим шляхом або виправте шлях. Без розширення знаходяться файли .png, .jpg, .jpeg і .svg; для рисунків PDF і EPS теж показується рамка (див. Рисунки й зображення). Про цитування див. Бібліографії й цитування.

Інші повідомлення

ПовідомленняЗначенняЩо робити
"N included files are not part of this conversion"Пропущено \subfile, \import, \lstinputlisting, \inputminted або \includepdf.Використайте \input або вставте вміст безпосередньо.
"File not found: ..."\input чи \include називає файл, якого немає в проєкті.Перевірте шлях від верхньої теки проєкту.
"N pictures of an unsupported kind are not included"Середовище tikzcd, circuitikz, forest чи picture не включено.Див. Рисунки з TikZ.
"TikZ option '...' is not supported yet"Рисунок використовує параметр, якого не знає рушій малювання. Рисунок малюється без нього.Перевірте параметр або приберіть його.
"Layout in the style of ... Not official."Клас або пакет конференції перемкнув документ на схожий макет.Нічого; це лише інформація.
"Macro expansion stopped at the safety limit"Команда розгортається сама в себе або у величезний обсяг тексту.Пошукайте \newcommand, який використовує власну назву.
"This formula could not be read: ..."Формула показується червоним; причина вказана в дужках.Див. Червоні формули.
"References to labels that do not exist (shown as ??): ..."\ref, \eqref, \pageref чи \cref називає мітку, яку не визначено, або мітку на червоній формулі.Перевірте написання мітки.
"Bibliography style ... is not available; using numbered references [1] instead"\bibliographystyle називає стиль, якого немає в переліку, як-от alpha.Оберіть стиль із переліку або залиште нумеровані посилання.
"Skipped .bib entries: ..."Ці записи файлу .bib не вдалося прочитати (бракує дужки, дубльований ключ); решта використовується.Виправте запис у вказаному рядку.

Помилки LaTeX, яких ви тут не побачите

Деякі класичні помилки LaTeX у Scissor LaTeX нічого не зупиняють, тож їх легко пропустити:

Помилка LaTeXЩо робить Scissor LaTeX
"Missing $ inserted" для x_1 у текстіВиводить x_1 буквально. Пишіть математику в $...$.
"Misplaced alignment tab character &"Виводить & буквально. Для амперсанда пишіть \&.
"Extra }, or forgotten $"Ігнорує незбалансовані фігурні дужки.
"\begin{itemize} ended by \end{document}"Закриває середовище за вас.
"Reference ... undefined"Виводить жирне ??; вкладка «Проблеми» перелічує відсутні мітки.

Текст, який LaTeX відхилив би

LaTeXВідкрити в редакторі
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.

Такі документи все одно можуть не скомпілюватися в інсталяції TeX, тож виправте їх, навіть якщо перегляд виглядає добре.

Чим відрізняється від інсталяції TeX

Контрольний перелік за симптомами див. у розділі Усунення несправностей.

Запитання й відповіді

Що означає «Undefined control sequence»?

LaTeX не знає команди, зазвичай через друкарську помилку чи відсутній пакет. У Scissor LaTeX та сама ситуація показується як «Skipped N unknown commands» на вкладці «Проблеми», а документ однаково верстається.

Чому моя формула червона?

Формула містить команду, якої не знає конвертер математики, як-от \symbf чи \abs. Вкладка «Проблеми» її називає. Замініть цю команду; таблиця на цій сторінці перелічує поширені заміни.

Чому я бачу [key?] у своєму документі?

Ключа цитування немає в жодному файлі .bib проєкту. Перевірте написання і те, чи файл .bib завантажено.

Кожен приклад на цій сторінці верстається в Scissor LaTeX під час збирання сайту. Оновлено 2026-11-07.