TeX 환경 / TeX 배포판

개요

TeX64는 latexmk, lualatex, latexindent 등의 명령줄 도구를 호출하여 문서를 컴파일합니다. 시스템에 TeX 배포판이 미리 설치되어 있어야 합니다.

TeX 배포판이 필요한 이유

TeX64 자체에는 LaTeX 엔진이 포함되어 있지 않으며, Mac의 시스템 명령을 호출합니다. TeX 배포판이 없으면 컴파일이 불가능합니다.

• TeX64는 외부 TeX 도구(latexmk, lualatex, synctex)에 의존합니다
• TeX 배포판 설치는 전제 조건입니다
• 배포판이 없으면 TeX64는 컴파일 오류를 표시합니다

선택지

MacTeX (권장)

• 크기: 약 4GB
• URL: https://www.tug.org/mactex/
• 설치: .pkg를 다운로드하여 인스톨러 실행
• 포함된 것: 전부 (latexmk, lualatex, latexindent, synctex, 모든 패키지)
• 일본어 사용자용: CJK 패키지가 기본 포함됨
• 권장 대상: 초보자, 무설정을 원하는 사용자

BasicTeX (최소 설치)

• 크기: 약 100MB
• URL: https://www.tug.org/mactex/morepackages.html
• 설치 후: tlmgr로 누락된 패키지를 수동 추가
• 권장 대상: 디스크 사용을 최소화하고 싶은 숙련된 사용자

TeX Live (수동)

• MacTeX 외부에서 TeX Live를 직접 관리
• Homebrew 사용자: brew install texlive

설치 확인

터미널에서 다음 명령을 실행하여 모든 도구가 인식되는지 확인하십시오:

which lualatex
which latexmk
which latexindent
which synctex

모두 경로를 반환해야 합니다. 비어 있다면 해당 도구가 설치되지 않았거나 PATH에 없습니다.

TeX64에서: 설정 > 환경에서 각 도구의 녹색/빨간색 상태를 확인할 수 있습니다.

패키지 관리 (tlmgr)

• 패키지 관리자 업데이트: sudo tlmgr update --self
• 전체 패키지 업데이트: sudo tlmgr update --all
• 패키지 설치: sudo tlmgr install <package>
• 패키지 검색: sudo tlmgr search --global --file <filename>

PATH 설정

• MacTeX는 /Library/TeX/texbin을 자동으로 추가합니다
• Homebrew는 /opt/homebrew/bin을 사용합니다
• PATH가 설정되지 않은 경우: ~/.zshrc에 export PATH="/Library/TeX/texbin:$PATH"를 추가
• PATH 변경 후 터미널과 TeX64를 재시작하십시오

일본어 LaTeX 설정

• MacTeX: 기본적으로 CJK 패키지가 포함됩니다
• BasicTeX: 일본어 패키지를 별도로 설치: sudo tlmgr install collection-langjapanese
• lualatex와 함께 luatexja 패키지 사용
• .tex 파일에 \usepackage{luatexja} 추가

자주 발생하는 문제

latexmk를 찾을 수 없음

MacTeX를 설치하거나 sudo tlmgr install latexmk 실행

.sty 파일 누락

sudo tlmgr install <package> 실행

PATH 문제

셸 프로필에 추가

권한 거부

sudo 사용

문의나 지원이 필요하시면 지원 페이지를 방문하십시오.