문서 전체가 조판되지 않을 때

문서 전체를 멈추는 것은 거의 없습니다. 읽을 수 없는 수식은 빨간색으로 표시되고 문제 탭에 이름이 나오며, \partial, \langle, \oplus, \hbar, Vmatrix는 LaTeX와 똑같이 조판됩니다. 남아 있는 알려진 원인은 EPS 이미지 하나이며, PDF, PNG, SVG로 변환하면 됩니다.

보이는 증상

보통 한 곳의 문제는 그곳에만 머뭅니다. 모르는 명령은 건너뛰고, 읽을 수 없는 수식은 빨간색으로 표시되며, 문서의 나머지는 조판됩니다. 그런데 문서 전체가 실패하면 미리보기에 새 페이지가 나타나지 않고, 위쪽의 오류 표시줄에 무엇이 잘못되었는지 표시됩니다.

아직도 문서를 멈추는 것

알려진 원인은 하나입니다. \includegraphics{figure.eps}처럼 확장자와 함께 넣은 EPS 이미지입니다. 오류 메시지는 unknown image format입니다. 파일을 PDF, PNG, SVG로 변환하고 \includegraphics의 파일 이름을 바꾸세요. 문제 해결에 예제가 있습니다.

긴 문서에서 해당 줄을 찾으려면 오류에 나온 줄 번호를 보거나, 문서의 절반을 %로 주석 처리하고 페이지가 다시 나타나는지 확인하세요. 여전히 실패하는 절반을 대상으로 같은 과정을 반복하세요.

수식은 문서를 멈추지 않습니다

수식 변환기가 모르는 명령을 쓰거나 괄호의 짝이 맞지 않아 읽을 수 없는 수식은 그 소스가 빨간색으로 표시됩니다. 문제 탭에는 "This formula could not be read: \symbf{v} (unknown command: \symbf)"처럼 줄 번호와 함께 표시됩니다. 이런 수식은 처음 열 개까지 하나씩 표시되고, 나머지는 한 줄에 개수로 알려 줍니다. 빨간 수식에 붙은 \label은 아무것도 가리키지 않으므로, 그 수식을 가리키는 \eqref는 ??를 출력하고 없는 레이블 목록에 나타납니다. 흔히 쓰는 대체 방법은 빨간 수식을 보세요.

예전에는 문서를 멈추던 명령

예전 버전의 Scissor LaTeX에서는 조판 라이브러리가 기호 이름을 바꾼 일부 수식 명령 때문에 unknown variable: diff나 unknown symbol modifier 같은 오류와 함께 문서 전체가 멈췄습니다. 이제는 모두 LaTeX에서 쓰는 그대로 조판됩니다.

\frac{\partial f}{\partial x}

\langle u, v \rangle, \quad \left\langle \frac{a}{b} \right\rangle

V \oplus W, \quad A \otimes B, \quad \bigcap_{i} A_i

고쳐진 명령에는 다음이 포함됩니다. \partial, \langle, \rangle, \lang, \rang, \cap, \bigcap, \Cap, \doublecap, \sqcap, \oplus, \ominus, \otimes, \odot과 그 큰 형태, \circledast, \circledcirc, \circleddash, \llbracket, \rrbracket, \hbar, \hslash, \mho, \dashleftarrow, \dashrightarrow, \bra, \ket, \braket, 내장된 \argmax와 \argmin, Vmatrix 환경, 그리고 수식 안의 \hspace*입니다. 이 중 일부를 유니코드 문자로 바꿔 두었다면 그대로 두어도 되고 명령으로 되돌려도 됩니다.

유니코드 문자도 동작합니다

Scissor LaTeX는 수식 안의 유니코드 수학 문자도 그대로 받아들입니다. ⟨와 ⟩ 같은 구분 기호는 \left와 \right로 크기가 커집니다.

\frac{∂ f}{∂ x}, \quad ⟨ u, v ⟩, \quad \left⟨ \frac{a}{b} \right⟩,
\quad V ⊕ W, \quad A ∩ B, \quad ℏ \omega

유니코드 문자와 직접 정의한 연산자

LaTeX복사편집기에서 열기 (새 탭에서 열림)

\documentclass{article}
\usepackage{amsmath}
\DeclareMathOperator*{\argmax}{arg\,max}
\begin{document}
\[
  ⋂_{i=1}^{n} A_i, \quad ⨁_{i} V_i, \quad ⟦ x ⟧, \quad
  ⟨ \psi \vert \phi ⟩, \quad a ⇢ b, \quad
  \argmax_{x} f(x), \quad
  \begin{Vmatrix} a & b \\ c & d \end{Vmatrix}
\]
\end{document}

XeLaTeX나 LuaLaTeX와 unicode-math 패키지를 쓰는 TeX 설치 환경은 이 문자들을 그대로 읽습니다. pdfLaTeX에서는 프리앰블에서 \DeclareUnicodeCharacter로 각 문자의 의미를 LaTeX에 알려 주세요. Scissor LaTeX는 이 줄들을 받아들이고 무시하므로 하나의 소스가 양쪽에서 모두 동작합니다.

Scissor LaTeX와 pdfLaTeX에서 함께 쓰는 소스

LaTeX복사편집기에서 열기 (새 탭에서 열림)

\documentclass{article}
\usepackage{amsmath}
\DeclareUnicodeCharacter{2202}{\partial}
\DeclareUnicodeCharacter{27E8}{\langle}
\DeclareUnicodeCharacter{27E9}{\rangle}
\DeclareUnicodeCharacter{2295}{\oplus}
\begin{document}
The gradient has the parts $\frac{∂ f}{∂ x_i}$, the inner product
is $⟨ u, v ⟩$, and the sum is $V ⊕ W$.
\end{document}

전체 목록

아래 목록은 사이트를 빌드할 때 만들어집니다. 조판기의 표에 있는 수식 명령을 하나씩 수식 안에서 시험하고, 동작하지 않는 명령을 모두 그 결과와 함께 나열합니다. 엔진에서 명령이 고쳐지면 이 목록에서 저절로 빠집니다.

현재 없음: 표의 수식 명령 789개 모두 수식 안에서 단독으로 조판됩니다.

관련 페이지

• 흔한 오류와 해결 방법: 문제 탭의 메시지.
• 증상별 문제 해결: 보이는 증상에서 해결책까지.
• TeX 설치 환경과의 차이: 모든 제한 사항을 한곳에.
• 괄호와 구분 기호와 연산자와 이항 기호: 기호와 그 명령.

이 페이지의 모든 예제는 사이트를 빌드할 때 Scissor LaTeX로 조판됩니다. 마지막 업데이트: 2026-11-07