[[TableOfContents]] 에러는 크게 세 가지 층위에서 발생한다. 1. TeX 에러 1. LaTeX 에러 1. package 또는 macro 에러 == 컴파일시 에러 검출 == TeX 에러 메시지는 다음과 같은 모양을 하고 있다. Uploads:errordisplay.jpg 또는 LaTeX 에러 메시지를 보여주는 에러도 있다. Uploads:latexerrordisp.jpg * `-file-line-error` 옵션을 실행시에 지시하면 `파일명:에러발생행번호:` 형식의 에러 메시지를 볼 수 있고 nonstopmode로 동작한다. * 위와 같이 사용자 입력을 기다리는 상태에서 다음과 같은 일을 할 수 있다. {{| h : 간단한 도움말을 보여준다. e : 현재의 컴파일을 중단하고 에러 발생 위치에서 편집기를 열어준다. r : 모든 에러를 무시하고 nonstopmode로 파일 끝까지 컴파일을 시도한다. q : 모든 에러를 무시하고 batchmode로 파일 끝까지 컴파일을 시도한다. s : 모든 에러를 무시하고 scrollmode로 파일 끝까지 컴파일을 시도한다. x : 컴파일을 중단한다. I : 현재의 에러 발생 위치에 있는 단어(매크로)를 stuff으로 바꾸어서 컴파일한다. : 현재 발생한 에러를 무시하고 계속 컴파일한다. 1..9 : 지정된 숫자만큼 그 뒤의 control sequence를 무시하고 컴파일을 시도한다. |}} * `e`가 제대로 작동하려면 에디터와의 연동이 미리 설정되어 있어야 한다. * `I`은 파일에 저장되지 않는다. * `1..9`의 숫자에서 무시되는 control sequence는 TeX이 처리하는 순서를 가리키는 것이지 입력파일의 명령어를 의미하는 것이 아니다. plainTeX에서는 유용하나 다른 control sequence를 대단히 많이 호출하는 LaTeX에서는 오류를 처리하는 데 적절하지 못하다. == 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 변수에 적절한 값이 할당되지 않았다는 의미이다. 일반적인 경우에는 dimension 값을 정의해줌으로써 해결된다. 그런데 한글 관련 매크로에서 한글을 숫자로 취급하여 어떤 동작을 하게 한 경우에도 만날 수 있는데 그 대부분은 매크로 정의가 잘못된 경우이다. 어떤 매크로에서 이 문제가 발생하였는지를 추적하는 것이 쉽지 않은 일일 수 있다. 1. '''Illegal unit of measure (pt inserted)''' 에러 dimension 변수에 할당된 값이 길이 단위가 주어지지 않았다는 의미이다. 1. '''Missing \endcsname inserted''' LaTeX 에러가 아니라 TeX 에러이다. 대개 TeX 에러가 추적이 훨씬 어렵다. 가장 단순한 보기는 예를 들면 다음과 같이 불필요한 백슬래시 `\`를 쓴 경우에 만나볼 수 있다. {{{ \begin{\sffamily} }}} 한글 관련 매크로에서 이 에러가 발생하였을 때 쉽게 추적하기 어려운 경우도 많다. 이 에러를 만나면 적절한 곳([게시판])에 에러 발생 상황과 매크로 정의를 상세히 보고하여 질문해보는 수밖에는 없어 보인다. 1. '''Missing \endgroup inserted''' 이 TeX 에러가 발생하는 경우는 매우 다양하다. 대표적인 경우를 하나 들자면 displaymath 환경 안에 eqnarray 환경을 다시 넣은 경우와 같이 허용되지 않는 환경 nesting이 있었을 때 발생할 수 있다. 1. '''Paragraph ended before \begin was completed''' `\begin`으로 시작한 문장의 닫는 괄호를 빼먹은 경우 발생할 수 있다. `\begin{document` 1. '''Runaway argument''' long으로 정의되지 않은 명령은 인자에 `\par`를 가질 수 없다. 예컨대 다음과 같은 경우, {{{ \textbf{이 명령의 인자에는 par를 두면 안된다} }}} 그리고, 인자의 닫는 괄호를 잊어버렸을 때도 이 에러가 발생한다. {{{ \title{A test document }}} 1. '''File not found''' 에러 클래스 파일, 스타일 파일 등 스타일 관련 파일을 못 찾겠다면 작업 폴더에나 루트 디렉터리에 해당 파일을 넣어야 한다(MiKTeX 2.4에서는 Remote Package Repository에서 찾아 설치하는 기능이 있음). 그림 관련 파일을 찾을 때는 KTUGOperate:17222'''''' 참조 1. '''perhaps a missing \item''' 에러 [나열환경] 안에서 `\item`을 쓰는 것을 잊어버렸을 때 발생한다. 또는 `thebibliography` 환경 안에서 `\bibitem`을 쓰는 것을 잊어버렸을 때도 마찬가지. 1. '''You can't use macro parameter character # in horizontal mode''' 이 에러는 주로 `#` 문자를 입력 파일에 그대로 썼을 때 발생한다. `#` 문자를 문서에 찍고 싶다면 반드시 `\#` 와 같이 하여야 한다. 왜냐하면 `#` 문자 자체는 TeX의 parameter를 처리하기 위한 [유보문자]로 쓰이기 때문이다. 1. '''You can't use `\spacefactor' in vertical mode''' 이 에러는 몇 가지 이유에서 발생할 수 있지만 가장 흔한 것은 @(at) 문자를 매크로 이름에 썼음에도 불구하고 `\makeatletter`를 선언하지 않은 경우이다. 에러의 모양은 다음과 같다. {{{ ! You can't use `\spacefactor' in vertical mode. \@->\spacefactor \@m }}} 해결책은 @-문자가 포함된 매크로 정의 영역을 `\makeatletter`와 `\makeatother`로 둘러싸주는 것이다. cf. http://www.tex.ac.uk/cgi-bin/texfaq2html?label=atsigns 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''' 개행명령(`\\` 또는 `\newline`)이 쓰인 줄에 아무런 내용도 없는 경우에 발생한다. 만약 한 줄을 비워야 할 필요가 있다면 `\bigskip`이나 `\medskip`과 같은 skip 명령을 써야 한다. 부득이하여 빈 줄을 개행명령으로 주어야 할 필요가 있다면 무의미한 문자를 하나 넣고 그 다음에 개행하라. 예를 들면 {{{\ \\}}} 1. '''Float(s) lost. This may be a LaTeX bug''' 에러 1. '''Too many unprocessed floats''' 에러 1. '''Extra }, or forgotten $''' 에러 현재 작업하고 있는 소스 파일에서 } 또는 $ 를 잊어버렸을 때는 해당 위치에 넣으면 된다. 한글을 쓸 때 장-절의 명령, 머리말-꼬리말, 목차만들기, 인덱스 만들기, 여러 가지 환경 등의 장치 속에 "{한글}"와 같이 입력되어 있으면 이런 메시지가 나타나는 수가 있는 데 "{한글 }"와 같이 한글과 } 사이를 한 칸 띄움으로써 해결될 수도 있다. 1. '''Environment(Command)... already defined''' 에러 현재 작업 파일에서 정의한 환경 또는 명령어이면 환경명, 명령어를 약간 바꾸거나 \newcommand를 \renewcommand로 바꿈으로써 쉽게 해결할 수 있다. 만약 가령 book 클래스, amsbook 클래스를 쓰면서 \usepackage{makeidx}를 프리앰블에 넣으면 \see라는 명령어가 클래스 파일에도 정의되어 있고 makeidx.sty에도 정의되기 때문에 나타난다. 이때는 \usepackage{makeidx}를 주석처리하거나 별도의 장치를 하여야 한다. see KTUGContrib:2845'''''' ''To be continued'' == Warnings == === Overfull, Underfull warning === === Font shape unavailable warning === == debugging과 tracing ==