흔한 오류와 해결 방법
대부분의 문제는 문서를 멈추지 않습니다. 모르는 명령은 건너뛰고 문제 탭에 나열되며, 읽을 수 없는 수식은 빨간색으로 표시되고 문제 탭에 이름이 나옵니다. 없는 이미지나 인용은 그 자리에 표시되며, 문서 전체를 멈추는 것은 EPS 이미지뿐입니다.
문제가 보고되는 방식
TeX 설치 환경은 첫 오류에서 멈추고 어떻게 할지 묻습니다. Scissor LaTeX는 멈추지 않고 문서를 조판할 수 있는 만큼 조판한 다음, 처리하지 못한 부분을 미리 보기 아래의 문제 탭에 나열합니다. 각 항목에는 알 수 있는 경우 해당 줄이 표시되며, 클릭하면 그 줄로 이동합니다.
결과는 네 가지입니다.
| 보이는 것 | 뜻 | 살펴볼 곳 |
|---|---|---|
| 문제 탭에 메시지, 문서는 정상 | 무언가를 건너뛰었거나 빠뜨렸습니다. | 아래 절들 |
| 빨간 소스 코드로 표시된 수식 | 그 수식을 읽을 수 없습니다. | 빨간 수식 |
빨간 [key?] 또는 회색 점선 상자 | 인용이나 이미지가 없습니다. | 없는 인용과 이미지 |
| 페이지가 전혀 없고 위쪽에 오류 | 문서 전체가 실패했습니다. | 문서 전체가 조판되지 않을 때 |
"Skipped N unknown commands"
가장 자주 보게 될 메시지이며, LaTeX의 "Undefined control sequence"에 해당합니다. Scissor 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가 모르는 패키지는 문제 탭에 표시되고, 그 서식은 적용되지 않습니다. 문서의 나머지는 평소처럼 조판되며, 그 패키지의 명령 중 모르는 것은 알 수 없는 명령으로 보고됩니다.
사용할 수 없는 패키지
\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를 쓸 수 없어 수식이 빨간색입니다
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?]로 출력되며, 문제 탭에 없는 키가 나열됩니다. 없는 이미지는 파일 이름이 적힌 회색 점선 상자가 됩니다.
프로젝트에 없는 이미지
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
문제 탭: 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의 처리 |
|---|---|
본문의 x_1에 대한 "Missing $ inserted" | x_1을 글자 그대로 출력합니다. 수식은 $...$ 안에 넣으세요. |
| "Misplaced alignment tab character &" | &를 글자 그대로 출력합니다. 앰퍼샌드는 \&로 쓰세요. |
| "Extra }, or forgotten $" | 짝이 맞지 않는 중괄호를 무시합니다. |
| "\begin{itemize} ended by \end{document}" | 환경을 대신 닫아 줍니다. |
| "Reference ... undefined" | 굵은 ??를 출력하고, 문제 탭에 없는 레이블을 나열합니다. |
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