TeX 환경 / TeX 배포판

개요

TeX64는 latexmk, lualatex, latexindent 등의 명령줄 도구를 호출합니다. 기존 TeX 배포판을 사용하거나 TeX64의 관리되는 TeX Live 다운로드 및 설치를 승인하세요.

TeX 배포판이 필요한 이유

TeX64 앱 패키지에는 LaTeX 엔진이 내장되지 않으며, 기기의 기존 또는 앱에서 관리하는 TeX 배포판의 명령을 호출합니다. TeX 배포판이 없으면 컴파일할 수 없습니다.

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

선택지

MacTeX (권장)

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

BasicTeX (최소 설치)

TeX Live (수동)

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

설치 확인

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

which lualatex
which latexmk
which latexindent
which synctex

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

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

Windows 10/11 설정

Windows x64에서 관리되는 TeX Live, 일반 TeX Live 또는 MiKTeX를 사용할 수 있습니다.

관리되는 TeX Live

  • TeX64 > 설정 > 환경에서 관리되는 TeX Live 설치를 선택합니다.
  • 다운로드를 확인하고 승인합니다. 전체 설치에는 수 GB의 빈 공간이 필요하고 시간이 걸릴 수 있습니다.
  • 완료될 때까지 TeX64를 열어 두세요. 앱 관리 폴더에 설치되고 자동 감지됩니다.

TeX Live(수동)

  • TeX Users Group의 공식 Windows 설치 프로그램을 다운로드하여 실행합니다.
  • 수 GB의 여유 공간이 있다면 누락 패키지 오류를 줄이기 위해 전체 스키마를 선택합니다.
  • C:\texlive\<year>\bin\windows를 PATH에 추가한 후 TeX64를 완전히 종료하고 다시 시작합니다.
  • https://www.tug.org/texlive/acquire-netinstall.html

MiKTeX

  • MiKTeX를 설치한 후 MiKTeX Console에서 업데이트와 누락 패키지를 설치합니다.
  • 빌드 중 누락된 .sty를 해결하려면 필요 시 패키지 설치를 활성화합니다.
  • MiKTeX bin 디렉터리가 PATH에 있고 lualatex, latexmk, synctex를 사용할 수 있는지 확인합니다.
  • https://miktex.org/download

PowerShell에서 확인

새 PowerShell 창에서 다음 명령을 실행하고 TeX64 설정 > 환경을 확인합니다.

Get-Command lualatex
Get-Command latexmk
Get-Command latexindent
Get-Command synctex

명령을 찾지 못하면 Windows 설정 > 시스템 > 정보 > 고급 시스템 설정 > 환경 변수에서 PATH를 수정하고 PowerShell과 TeX64를 완전히 종료한 후 다시 시작하세요.

Windows 문제 해결

  • TeX Live: PATH의 연도가 실제 설치 폴더와 같고 \bin\windows로 끝나는지 확인합니다.
  • MiKTeX: MiKTeX Console에서 업데이트하고 latexmk 또는 빌드 로그에 표시된 누락 패키지를 설치합니다.
  • 관리 설치: 안정적인 연결과 수 GB의 여유 공간을 확인하고 설정 > 환경에서 다시 시도하며, 지원 문의 시 설정/빌드 로그를 포함합니다.

패키지 관리 (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 사용

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