[[TableOfContents]] 에러는 크게 세 가지 층위에서 발생한다. 1. TeX 에러 1. LaTeX 에러 1. package 또는 macro 에러 == 컴파일시 에러 검출 == TeX 에러 메시지는 다음과 같은 모양을 하고 있다. Uploads:errordisplay.jpg 또는 LaTeX 에러 메시지를 보여주는 에러도 있다. Uploads:latexerrordisp.jpg * `-file-line-error` 옵션을 실행시에 지시하면 `파일명:에러발생행번호:` 형식의 에러 메시지를 볼 수 있고 nonstopmode로 동작한다. * 위와 같이 사용자 입력을 기다리는 상태에서 다음과 같은 일을 할 수 있다. {{{ h : 간단한 도움말을 보여준다. e : 현재의 컴파일을 중단하고 에러 발생 위치에서 편집기를 열어준다. r : 모든 에러를 무시하고 파일 끝까지 컴파일을 시도한다. x : 컴파일을 중단한다. I : 현재의 에러 발생 위치에 있는 단어(매크로)를 stuff으로 바꾸어서 컴파일한다. : 현재 발생한 에러를 무시하고 계속 컴파일한다. }}} * `e`가 제대로 작동하려면 에디터와의 연동이 미리 설정되어 있어야 한다. * `I`은 파일에 저장되지 않는다. == Real ERRORS == === 에러인 것과 에러가 아닌 것 === 1. 가끔 이전의 latex 실행에서 남아 있던 부수파일(*.aux, *.toc 등)에서 에러가 발생하는 것처럼 보일 때가 있으나 다시 latex을 실행하면 없어진다면 이것은 에러가 아니다. 1. 오타에 기인한 에러는 엄밀히 말해서 에러가 아니다. 이런 에러는 즉시 발견하고 수정할 수 있다. 1. Warning은 에러가 아니다. 다만 경고일 뿐이다. 이것은 경우에 따라 무시해도 좋을 때도 있다. 경고에 대해서는 별도로 다룬다. === 자주 만나는 에러와 처리방법 === 아래에서 LaTeX 사용자가 만날 수 있는 TeX 또는 LaTeX 에러를 간략히 정리해둔다. 1. '''No room for new \dimen''' 또는 '''No room for new \skip''' 에러 TeX 에러 중에서 가장 처리하기 어려운 오류이다. 이것은 TeX 시스템 자체의 한계와 관련된 것이다. 이 오류가 발생하는 경우는 너무 많은 \dimen, \skip을 사용했을 경우인데 일반적으로 복잡한 스타일을 불필요하게 로드하였을 때도 발생할 수 있다. 예를 들면 memoir와 musixltx를 동시에 쓰는 경우와 같은 것이다. 이 오류의 근본적인 해결은 TeX 시스템을 재설계하는 것이라 생각한다. [e-TeX]은 이 오류가 좀 덜 발생할 수 있도록 내부적인 개선을 이루어두었다 한다. 그러므로 앞으로는 이 오류를 만날 가능성이 줄어들 것이 틀림없고 실제로 이 오류가 발생했다 해도 로드한 패키지들을 검토하여 불필요한 것을 제외하면 해결할 수 있는 것이 많다. 1. '''Undefined control sequence''' 에러 정의되지 않은 명령 또는 환경이 쓰였다는 것이다. 대부분 오타에서 기인한 것이기 쉽다. 또는 `\usepackage{graphicx}` 없이 `\includegraphics` 명령을 쓰는 경우와 같이 해당하는 control sequence가 정의된 패키지를 로드하지 않아서 발생할 수도 있다. => 오타를 수정하거나 명령을 정의한다. 또는 필요한 패키지를 로드한다. 1. '''TeX capacity exceeded''' 에러 비교적 자주 만나는 에러인데 이런 문제가 생길 가능성은 다음과 같다. 1. 실제로 현재 설정된 TeX capacity 설정값이 주어진 문서 파일을 처리하기에 부족한 경우. 즉 복잡한 스타일들을 여러 개 얹었거나 지나치게 많은 매크로를 정의해서 사용하거나 한 경우이다. => tex capacity 관련 설정값을 수정하여 TeX 시스템 기본 설정을 바꾸어야 한다. 방법은 TeX 시스템 기본 설정 파일을 수정하거나 새로 포맷을 만들거나, 주변의 TeX 도사에게 물어보는 것이다. 1. 매크로 정의에서 loop가 발생한 경우 => 잘못 정의된 매크로를 올바르게 고친다. 1. 스타일 사이의 충돌이 있는 경우 => preamble의 style 로드를 하나씩 제거해가면서 문제가 없어지는지 여부를 확인한다. 이 가운데 가장 많은 예는 두번째의 매크로 정의의 오류이다. 첫번째 경우는 상대적으로 많지 않으므로 혹시 이런 에러를 만난다면 반드시 preamble을 먼저 검토해보도록 하고 TeX 시스템 설정을 수정하는 것은 최후에 시도해보도록 하여야 한다. 1. '''Extra alignment tab has been to \cr''' 에러 이 에러는 [배열환경]에서 발생하는 것으로 주로 표나 array에서 미리 지정된 column 수가 맞지 않을 때 발생한다. 경우에 따라서 column 수가 맞다 해도 내부 매크로의 동작 때문에 이러한 에러가 발생할 수 있다. 표와 array의 코드를 검토해보아야 할 것이다. 1. '''Missing number, treated as zero''' 에러 이것은 dimension 변수에 적절한 값이 할당되지 않았다는 의미이다. 한글 관련 매크로에서 한글을 숫자로 취급하여 어떤 동작을 하게 한 경우 만날 수 있는데 대부분은 매크로 정의가 잘못된 경우일 것이다. 그런데 어떤 매크로에서 이 문제가 발생하였는지를 추적하는 것이 쉽지 않은 일일 수 있다. 1. '''Illegal unit of measure (pt inserted)''' 에러 dimension 변수에 할당된 값이 길이 단위가 주어지지 않았다는 의미이다. 1. '''Missing \endcsname inserted''' 1. '''File not found''' 에러 1. '''perhaps a missing \item''' 에러 1. '''\begin{enumerate} on input line xxx ended by \end{document}''' 에러 1. '''can be used only preamble''' 에러 1. '''Counter too large''' 에러 1. '''Missing \begin{document}''' 에러 1. '''Not in outer par mode''' 1. '''There's no line here to end''' 1. '''Float(s) lost. This may be a LaTeX bug''' 에러 1. '''Too many unprocessed floats''' 에러 1. '''Extra }, or forgotten $''' 에러 1. '''Environment(Command)... already defined''' 에러 ''To be continued'' == Warnings == === Overfull, Underfull warning === === Font shape unavailable warning ===