[[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에서는 오류를 처리하는 데 적절하지 못하다. === 에러에서 소스 찾아가기 : `e` 사용 === * [WinEdtTip/오류소스찾아가기] * {{{.../texmf/miktex/config/miktex.ini}}}의 Editor부분을 적절히 수정합니다. * EmEditor''''''의 경우 * {{{Editor="....\EmEditor\emeditor.exe" "%f" /l "%l"}}} * VimEditor''''''의 경우 * {{{Editor="c:\utils\Vim\vim70\gvim.exe" "+%l" "%f"}}} == Real ERRORS == === 에러인 것과 에러가 아닌 것 === 1. 가끔 이전의 latex 실행에서 남아 있던 부수파일(*.aux, *.toc 등)에서 에러가 발생하는 것처럼 보일 때가 있으나 다시 latex을 실행하면 없어진다면 이것은 에러가 아니다. 1. 오타에 기인한 에러는 엄밀히 말해서 에러가 아니다. 이런 에러는 즉시 발견하고 수정할 수 있다. 1. Warning은 에러가 아니다. 다만 경고일 뿐이다. 이것은 경우에 따라 무시해도 좋을 때도 있다. 경고에 대해서는 별도로 다룬다. === 자주 만나는 에러와 처리방법 === 아래에서 LaTeX 사용자가 만날 수 있는 TeX 또는 LaTeX 에러를 간략히 정리해둔다. 1. "*" (아무 메시지도 없이 별표 프롬프트만 나오는 경우) TeX 명령행 상태이다. LaTeX 문서 처리중에 이 프롬프트를 만났다면 TeX에게 "최종 처리" 명령을 전달하지 못한 것이다. 이 프롬프트에서 빠져나오려면 `\end{document}`를 직접 써넣는데, 대부분의 경우 결과가 의도한 바와 다를 것이다. 단순히 \end{document}를 빠뜨린 것이라면 문서 마지막에 이 명령을 써넣으면 되고 그렇지 않고 매크로 처리 과정에서 오류가 생긴 것이면 문서에 사용된 코드를 재검토해야 한다. 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. '''Misplaced alignment tab char &''' 에러 & 문자는 [배열환경]의 칼럼 지정자로 쓰이는 [유보문자]이다. 이 문자를 텍스트 위치에 놓았을 때 발생하는 에러이다. & 문자를 텍스트로 그대로 찍으려면 \& 로 하여야 한다. 1. '''Misplaced \noalign''' 에러 [Tabular환경]으로 표를 만들 때 표의 배열환경은 비교적 엄격한 행나누기를 요구하는 수가 있다. 예컨대 colortbl 환경의 \rowcolor와 같은 매크로는 특정 행의 제일 첫번째 매크로가 아니면 위와 같은 에러를 낸다. 현재 행에서 \rowcolor 보다 앞서 나온 매크로를 없애거나 수정한다. 1. '''Illegal unit of measure (pt inserted)''' 에러 dimension 변수에 할당된 값이 길이 단위가 주어지지 않았다는 의미이다. 1. '''Missing control sequence inserted''' 에러 새 명령어를 정의하거나 기존의 명령어의 정의를 바꾸기 위하여 \newcommand 또는 \renewcommand를 쓰면서 첫째 요소로 명령어(backslash로 시작함)를 넣지 않았을 때 1. '''Missing \endcsname inserted''' LaTeX 에러가 아니라 TeX 에러이다. 대개 TeX 에러가 추적이 훨씬 어렵다. 가장 단순한 보기는 예를 들면 다음과 같이 불필요한 백슬래시 `\`를 쓴 경우에 만나볼 수 있다. {{{ \begin{\sffamily} }}} 한글 관련 매크로에서 이 에러가 발생하였을 때 쉽게 추적하기 어려운 경우도 많다. 이 에러를 만나면 적절한 곳([게시판])에 에러 발생 상황과 매크로 정의를 상세히 보고하여 질문해보는 수밖에는 없어 보인다. 1. '''Missing \endgroup inserted''' 이 TeX 에러가 발생하는 경우는 매우 다양하다. 대표적인 경우를 하나 들자면 displaymath 환경 안에 eqnarray 환경을 다시 넣은 경우와 같이 허용되지 않는 환경 nesting이 있었을 때 발생할 수 있다. 1. '''Missing number, treated as zero''' 에러 이것은 dimension 변수에 적절한 값이 할당되지 않았다는 의미이다. 일반적인 경우에는 dimension 값을 정의해줌으로써 해결된다. 그런데 한글 관련 매크로에서 한글을 숫자로 취급하여 어떤 동작을 하게 한 경우에도 만날 수 있는데 그 대부분은 매크로 정의가 잘못된 경우이다. 어떤 매크로에서 이 문제가 발생하였는지를 추적하는 것이 쉽지 않은 일일 수 있다. 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}''' 또는 '''\begin{document} ended by \end{itemize}''' 에러 \begin{enumerate} ~ \end{enumerate} 또는 \begin{itemize} ~ \end{itemize} 의 짝이 안 맞아서 일어난다. 1. '''can be used only preamble''' 에러 [Preamble]에서만 사용할 수 있도록 정의된 매크로가 document 환경 안에서 사용되었다는 LaTeX 에러이다. 1. '''Counter too large''' 에러 1. '''Missing \begin{document}''' 에러 See KTUGOperate:15101'''''' for example. 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''' 에러 [떠다니는 개체]를 적절한 곳에 위치짓지 못한 결과 유실되었음을 의미하는 LaTeX 에러 메시지. 실제로는 버그가 아닌 경우가 많고 \afterpage를 남용하였을 때 가끔 발생한다. 해결책은 float의 위치를 전후로 조금 이동시키거나 \afterpage를 사용하지 않는 것이다. 1. '''Too many unprocessed floats''' 에러 queue에 보관될 수 있는 [떠다니는 개체]의 수는 16개를 넘지 못한다. 이 이상의 플로트가 처리되지 않고 queue에 들어가면 발생하는 에러. 해결책은 \clearpage 명령을 적당한 곳에서 사용하여 queue의 float를 flush해주는 것이다. 1. '''Extra }, or forgotten $''' 에러 현재 작업하고 있는 소스 파일에서 } 또는 $ 를 잊어버렸을 때는 해당 위치에 넣으면 된다. 한글을 쓸 때 장-절의 명령, 머리말-꼬리말, 목차만들기, 인덱스 만들기, 여러 가지 환경 등의 장치 속에 "{한글}"와 같이 입력되어 있으면 이런 메시지가 나타나는 수가 있는 데 "{한글 }"와 같이 한글과 } 사이를 한 칸 띄움으로써 해결될 수도 있다. 1. '''Environment(Command)... already defined''' 에러 현재 작업 파일에서 정의한 환경 또는 명령어이면 환경명, 명령어를 약간 바꾸거나 \newcommand를 \renewcommand로 바꿈으로써 쉽게 해결할 수 있다. 만약 가령 amsbook 클래스를 쓰면서 \usepackage{makeidx}를 프리앰블에 넣으면 \see라는 명령어가 클래스 파일에도 정의되어 있고 makeidx.sty에도 정의되었기 때문에 나타난다. 이때는 \usepackage{makeidx}를 주석처리하거나 별도의 장치를 하여야 한다. see KTUGContrib:2845'''''' ''To be continued'' == Warnings == === Overfull, Underfull warning === 현재 설정된 행채움 허용치를 모두 사용하고도 justification에 실패했을 때 발생하는 경고이다. 이 경고가 발생하는 과정, 즉 badness와 tolerance를 이용한 TeX의 행정렬 과정에 대해서는 TeXbook을 볼 것. 사용자 입장에서 결과적으로 한 행의 모자람이나 넘침이 발생하는데, 이 행모자람 또는 넘침이 발생한 위치를 표시하게 하려면 {{{ \setlength\overfullrule{5pt} }}} 를 preamble에 적어주거나, {{{[draft]}}} 옵션으로 문서를 작성한다. sloppypar 환경 안이나 \sloppy 선언 이후에는 “엄격한 행나눔”을 행하지 않기 때문에 이 경고가 발생하지 않는다. 그러나 단어간격이 이상해지고 결과적으로 엉성한 판면이 만들어지게 되는 점에 대해서는 자신이 책임을 져야 한다. Warning을 보지 않기 위해서 품질을 희생하는 것은 좋은 선택이 아니다. === Font shape unavailable warning === 문서에서 요청된 속성을 가진 폰트를 모두 로드할 수 없었다는 경고임. 예를 들어 CMR 글꼴에 대하여 \fontseries{c}\selectfont를 요청하였으나 이 글꼴의 c-series가 정의되어 있지 않은 경우, 이 경고를 내고 실제로는 기본값(m-series)으로 대치하여 식자한다. 한글 폰트의 경우 각각의 series와 shape가 모두 정의되어 있는 글꼴은 찾기 어려우므로 한글 문서를 처리한 경우에 자주 발생하지만 불가피하다. == debugging과 tracing == === PlainTeX의 tracing === TeX의 특성 중의 하나는 프로그래밍이 가능하다는 것이다. 하지만, TeX은 보통의 프로그래밍과 약간 다른 점이 있어서 TeX 프로그래밍하는 이를 가끔 당혹케하기도 한다. 이에 TeX은 자신이 어떠한 이유와 방법을 통해서 그러한 결과를 만들어 냈는지를 프로그래밍하는 이에게 상세히 소개한다. 이때 TeX이 사용하는 방법은 \tracing... 또는 \show... 명령어를 이용하여 자신이 한 모든 일을 로그 파일로 남기거나 터미널에 뿌려주는 것이다. In the following list, only \show and \showthe display their output on the terminal by default, other \show... and \tracing... commands write to the log file. They will write in addition to the terminal if \tracingonline is positive. \meaning Give the meaning of a control sequence as a string of characters. * \show Display the meaning of a control sequence. *\showthe Display the result of prefixing a token with \the. * \showbox Display the contents of a box. * \showlists Display the contents of the partial lists currently built in all modes. This is treated on page 65. * \tracingcommands If this is 1 TEX displays primitive commands executed; if this is 2 or more the outcome of conditionals is also recorded. * \tracingmacros If this is 1, TEX shows expansion of macros that are performed and the actual values of the arguments; if this is 2 or more htoken parameteris such as \output and \everypar are also traced. * \tracingoutput If this is positive, the log file shows a dump of boxes that are shipped to the dvi file. * \showboxdepth The number of levels of box dump that are shown when boxes are displayed. * \showboxbreadth Number of successive elements on each level that are shown when boxes are displayed. * \tracingonline If this parameter is positive, TEX will write trace information to the terminal in addition to the log file. * \tracingparagraphs If this parameter is positive, TEX generates a trace of the line breaking algorithm. * \tracingpages If this parameter is positive, TEX generates a trace of the page breaking algorithm. * \tracinglostchars If this parameter is positive, TEX gives diagnostic messages whenever a character is accessed that is not present in a font. Plain default: 1. * \tracingrestores If this parameter is positive, TEX will report all values that are restored when a group ends. * \tracingstats If this parameter is 1, TEX reports at the end of the job the usage of various internal arrays; if it is 2, the memory demands are given whenever a page is shipped out. === [e-TeX]의 tracingall === [e-TeX]의 tracingall에는 다음 primitives가 추가되어 있다. * tracingassigns * tracinggroups * tracingifs * tracingnesting * tracingcantokens === LaTeX의 trace 패키지 === {{{ \usepackage[logonly]{trace} \traceon \traceoff }}} ---- Unknown Unicode Character 에러는 ucs 패키지 에러이기 때문에 이곳에는 적합하지 않은 것 같습니다. 삭제하였습니다. -- [Karnes] [[DateTime(2006-04-27T05:15:05)]]