문제 해결하기

오류 메시지는 대개 손봐야 할 소스 파일이나 동작을 이미 알려 줍니다.

실패한 빌드와 대기 중인 빌드는 상태 표시줄에서 비슷해 보이지만, 대응은 정반대입니다.

빌드가 실패하면 문제 패널을 열고 첫 번째 오류부터 보세요. 뒤의 것들은 대개 그 여파입니다.
메시지 자체가 모호하면 해당 진단에 AI의 설명이나 수정을 사용하세요.
컴파일은 한 사람당 한 번에 하나만 돌아갑니다. 새 자동 컴파일이 대기 중인 것을 대체하고, 직접 실행한 컴파일은 잠시 뒤 다시 시도하라고 안내할 수 있습니다.
컴파일 서비스가 요청을 끝내지 못했다는 메시지는 문서가 아니라 서비스를 가리킵니다. 다시 시도하고, 계속되면 지원팀에 문의하세요.
시간 제한을 넘겼거나 저장 공간이나 메모리를 다 써서 중단된 컴파일은 다시 시도해도 통과하지 못합니다. 반복 루프, 무거운 패키지, 매우 큰 이미지를 찾아보거나 문서를 나누세요.
낡은 보조 파일 때문에 빌드가 계속 실패하거나 소스와 PDF 사이의 이동이 동작하지 않으면, 컴파일 메뉴를 열어 ‘캐시를 지우고 다시 컴파일’을 고르세요.

어떤 실패는 오류가 가리키는 줄의 소스가 아니라 파일의 위치나 프로젝트에 담긴 양에서 비롯됩니다.

파일을 옮기거나 이름을 바꾼 직후에 파일이 없다는 오류가 나면, 대개 어떤 경로가 아직 예전 위치를 가리키는 것입니다. 이동 뒤에 나오는 알림에서 ‘업데이트’를 고르거나 경로(LaTeX에서는 \input 또는 \includegraphics, Typst에서는 #include 또는 #image)를 직접 고치세요.
프로젝트가 크기 한도에 가깝다는 경고는, 가득 차면 새 파일과 편집을 저장할 수 없다는 뜻입니다. 더 이상 필요 없는 파일을 지우거나 프로젝트를 나누세요.
컴파일 서비스가 붐비거나 사용할 수 없을 때는 알림이 데스크톱 앱을 안내합니다. 데스크톱 앱은 내 컴퓨터의 LaTeX로 컴파일할 수 있습니다. 앱 안에서는 서버에서 컴파일하도록 설정된 프로젝트에 ‘대신 이 컴퓨터에서 컴파일’이 제시됩니다.

무언가를 열 수 없는 것은 대개 계정이나 연결 상태의 문제이지, 프로젝트가 사라진 것이 아닙니다.

상태 표시줄의 저장 점에 포인터를 올렸을 때 오프라인으로 작업 중이라고 나오면 계속 쓰세요. 편집은 브라우저에 남아 있다가 연결이 돌아오면 동기화됩니다.
오프라인 상태에서는 로그아웃하지 마세요. 로그아웃하면 그 로컬 사본이 지워집니다.
더 이상 열리지 않는 프로젝트는 찾을 수 없다고 알립니다. 소유자에게 권한이 바뀌었는지, 휴지통으로 갔는지 물어보세요.
인증되지 않은 이메일 주소나 정지된 계정은 프로젝트 하나가 아니라 앱 전체를 막습니다.

Typst 프로젝트는 쓰는 동안에는 페이지에서, 브라우저에서는 다운로드용으로 서버에서 컴파일됩니다. 그래서 뜻밖의 동작은 대부분 둘 중 어느 쪽이 미리보기를 만들었느냐에서 비롯됩니다.

PDF가 입력을 따라오지 않거나 소스와 PDF 사이의 이동이 동작하지 않는다면, 페이지가 아니라 서버가 미리보기를 컴파일하고 있는 것입니다. 컴파일 메뉴에서 ‘자동 컴파일’을 확인하고, 브라우저를 업데이트한 뒤 페이지를 새로 고치세요. 페이지의 글꼴에 없는 글자가 들어 있는 문서도 서버에서 컴파일됩니다.
@local 가져오기에서 패키지를 찾을 수 없다는 오류가 나는 것은 정상입니다. @preview 패키지만 쓸 수 있습니다.
가져온 ZIP이나 저장소에 .typ 파일이 여러 개 있고 최상위에 main.typ가 없으면, 다른 .typ 파일이 import하거나 include하지 않는 .typ 파일이 루트가 됩니다. 그 파일이 원하는 문서가 아니면 프로젝트 설정을 열어 루트로 쓸 .typ 파일을 고르세요.
컴파일 서비스가 아직 Typst 문서를 컴파일할 수 없다는 메시지는 문서가 아니라 서비스에서 나온 것입니다. 나중에 다시 시도하세요.

도움말 센터