그 패키지가 설치되어 있지 않습니다

tlmgr, MiKTeX, 그리고 Tectonic 또는 Oleafly의 필요 시 자동 내려받기.

그 패키지가 설치되어 있지 않습니다

언젠가는 컴파일이 ! LaTeX Error: File 'siunitx.sty' not found 같은 줄과 함께 멈춥니다. 이 메시지는 말 그대로의 뜻입니다. 문서가 \usepackage{siunitx}로 패키지를 요청했는데, 컴파일러가 이 컴퓨터에서 해당 패키지의 .sty 파일을 찾지 못했다는 것입니다. 문서에는 아무 문제가 없습니다. LaTeX 배포판은 모든 패키지를 기본으로 담아 배포하지 않으며, 해결 방법은 사용하는 배포판에 따라 다릅니다.

TeX Live

Linux와 macOS(MacTeX)의 표준 배포판인 TeX Live에는 tlmgr이라는 패키지 관리자가 들어 있습니다. 터미널에서 빠진 패키지를 설치하세요.

tlmgr install siunitx

수 기가바이트에 이르는 전체 TeX Live를 설치했다면 모든 패키지가 이미 있으므로 이 오류는 나오지 않아야 합니다. 보통은 더 작은 basic이나 small 설치 스킴에서 나타납니다. tlmgr에 넘기는 인수는 파일 이름이 아니라 패키지 이름이므로 .sty 확장자를 붙이지 않는다는 점에 유의하세요.

MiKTeX

Windows에서 많이 쓰는 MiKTeX에는 두 가지 방법이 있습니다. 하나는 즉시 설치(install-on-the-fly) 기능으로, 컴파일 중에 빠진 파일을 감지해서 내려받을지 물어보거나, 설정에 따라 자동으로 진행합니다. 다른 하나는 MiKTeX Console을 열고 Packages 탭으로 가서 패키지를 검색해 그곳에서 설치하는 방법입니다. 즉시 설치 때문에 컴파일이 멈춘 것처럼 보인다면, 대개 다른 창 뒤에 가려진 확인 대화 상자를 기다리고 있는 것입니다.

Tectonic

Oleafly에 내장된 Tectonic 엔진은 수동 단계를 건너뜁니다. 패키지는 컴파일 중에 필요할 때 내려받아 엔진의 로컬 캐시에 저장됩니다. siunitx를 처음 사용하는 컴파일에서 이 패키지를 가져오고, 이후 컴파일은 캐시를 재사용합니다. 처음 실행할 때는 의존 패키지를 내려받느라 시간이 더 걸릴 수 있고, 네트워크 연결이 필요합니다.

설치해도 해결되지 않을 때

패키지 관리자가 그런 패키지는 없다고 알려 주면, ctan.org에 있는 LaTeX 패키지 중앙 저장소인 CTAN의 해당 패키지 페이지에서 철자를 확인하세요. 해결되지 않는 사례 대부분은 두 가지 불일치로 설명됩니다. 첫째, 파일 이름과 패키지 이름이 다를 수 있습니다. 하나의 배포 패키지에 여러 .sty 파일이 들어 있을 수 있기 때문입니다. 오류 메시지에 나온 .sty 파일 이름을 그대로 CTAN에서 검색하면 해결됩니다. 둘째, 오류가 템플릿이 빠뜨린 클래스 파일처럼 내 프로젝트 안의 파일을 가리키는 경우가 있습니다. 이런 파일은 어떤 패키지 관리자도 제공할 수 없습니다. 템플릿이 있던 곳에서 가져와야 합니다.

옛날 조언에 대한 마지막 메모입니다. 인터넷에서 .sty 파일 하나만 내려받아 프로젝트 폴더에 넣는 방법은 실제로 동작합니다. LaTeX가 현재 디렉터리를 먼저 검색하기 때문입니다. 하지만 그러면 그 패키지가 임의의 버전에 고정되고 업데이트에서도 빠집니다. 패키지 관리자를 우선하고, 직접 복사하는 요령은 마감이 임박한 비상시에만 쓰세요.

런타임(으)로 돌아가기