MacTeX 설치 (rev. 1.1)

EDRSPIHCRSSRSS

Mac TeX 설치



1. MacTeX 설치하기

맥에서 텍 시스템을 설치하는 것은 TeXLive 기반의 MacTeX으로 표준화되었다. (MacTeX을 이용하지 않으려면 아래 "다른 방법들" 소절을 참고.)


Install_MacTeX2016_1.png
[PNG image (187.25 KB)]
Install_MacTeX2016_2.png
[PNG image (190.99 KB)]
Install_MacTeX2016_3.png
[PNG image (170.86 KB)]
Install_MacTeX2016_4.png
[PNG image (130.9 KB)]
Install_MacTeX2016_5.png
[PNG image (137.68 KB)]

1.1. 설치 후 업데이트

  • 설치 후, TeX Live Utility를 실행하여 메뉴에서 "Update All Packages"(단축키: Shift-Cmd-U)를 실행한다.
    • TeX Live Utility는 Applications(응용 프로그램) 아래 TeX 폴더 안에 있다.
  • 또는, 터미널을 열고 다음 명령을 내린다.
    • MacTeX 설치 이전부터 터미널이 실행 중이었다면 닫고 다시 실행한다.
    • # 기호는 터미널 프롬프트를 나타내는 것으로 직접 써넣어야 하는 것이 아님
      # sudo tlmgr update --all --self
      
tlmgr_update_all.png
[PNG image (121.66 KB)]

2. 한글 환경

2.1. MacTeX (full) 설치의 경우

  • 위에서 MacTeX을 설치한 후 업데이트하는 것만으로 한글 문서를 작성할 수 있다.
    \usepackage{kotex}
    

2.2. MacTeX-basic의 경우

  • 다음과 같이 ko.TeX 관련 패키지를 설치해준다.
    # sudo tlmgr install nanumtype1 cjk cjk-ko uhc kotex-utf kotex-plain kotex-oblivoir kotex-utils
    
  • 또는,
    # sudo tlmgr install collection-langkorean
    

3. XeTeX 사용을 위한 설정

3.1. texmf.cnf

맥의 시스템 폰트를 파일이름으로(즉 ExternalLocation으로) 찾으려면 다음 조치를 취해두어야 한다. /usr/local/texlive/texmf-local/web2c/texmf.cnf 또는 /usr/local/texlive/2016/texmf.cnf 파일을 텍스트파일로 열어서 제일 위에 다음 코드를 추가한 후 저장한다. 이미 만들어져 있다면 이 과정은 생략한다.
OSFONTDIR = {~/Library/Fonts;/Library/Fonts;/System/Library/Fonts}
superuser 권한이 필요할 수 있다.

파일을 열고 편집하는 것이 불편하다면 적당한 폴더에서 다음 명령을 터미널에서 차례로 내린다.(#은 프롬프트)
# echo "OSFONTDIR = {~/Library/Fonts;/Library/Fonts;/System/Library/Fonts}" >texmf.cnf # cat /usr/local/texlive/texmf-local/web2c/texmf.cnf >> texmf.cnf # sudo mkdir -p /usr/local/texlive/texmf-local/web2c # sudo cp ./texmf.cnf /usr/local/texlive/texmf-local/web2c/
두번째 명령에서 오류가 날 수도 있으나 무해하다. 마지막의 sudo 명령에서 password를 요구한다.

3.2. TeXLive의 폰트를 맥 OS 폰트 라이브러리로 등록하기

자세한 내용은 이 글토막의 출처인 http://doeun.tistory.com/172을 참조.
  1. 서체관리자 실행
  2. 파일 -> 새로운 보관함 (New Library) 메뉴
  3. 적당한 이름을 써넣는다.
  4. 파일 -> 서체 추가 (Add Fonts)를 선택한다. 또는 위의 이름에서 우클릭해서 서체 추가를 선택해도 된다.
  5. 파일 선택창이 열린다. 경로가 매우 길기 때문에 Shift-Cmd-G 를 눌러준 다음 경로를 입력한다.
    /usr/local/texlive/2016/texmf-dist/fonts/opentype/public
    
  6. 원하는 폰트들을 선택한다.

3.3. symbolic link

  • 사용자의 ~/Library/Fonts 아래에 TeX Live의 트루타입과 오픈타입 폴더를 링크해두는 방법이 있다. 이 방법은 TeX Live를 full로 설치하였을 때 등록되는 폰트가 너무 많아지기 때문에 선별적으로 등록하고자 하는 사용자에게는 적당하지 않지만 다른 고려 없이 TeX Live 폰트를 바로 사용할 수 있다는 장점이 있다.
# cd ~/Library/Fonts
ln -s /usr/local/texlive/2016/texmf-dist/fonts/truetype ~/Library/Fonts/
ln -s /usr/local/texlive/2016/texmf-dist/fonts/opentype ~/Library/Fonts/

  • 일부 폰트만 등록하려면 특정폰트 폴더를 입력한다. 예를 들어 XITS 폰트 패밀리를 등록하려면
# cd ~/Library/Fonts
ln -s /usr/local/texlive/2016/texmf-dist/fonts/truetype/public/xits ~/Library/Fonts/
texmf_font_symlink.png
[PNG image (128.92 KB)]
FontBook.png
[PNG image (387.47 KB)]

4. TeX Live Utility

패키지의 업데이트와 관리를 위해서 위에 언급한 명령행(tlmgr)을 써도 좋지만 TeX Live Utility라는 애플리케이션을 이용하는 것이 좋다. 만약의 경우 tlmgr이 self update에 실패하는 때라든가, 선택적인 패키지 업데이트를 Mac OS X 인터페이스로 작업할 수 있다.

모든 패키지를 업데이트하려면 Actions -> Update All Packages (단축키 Shift-Cmd-U)를 실행한다.

/Applications/TeX/TeX\ Live\ Utility.app

texliveutility1.png
[PNG image (188.3 KB)]

5. TeX Live를 설치하는 다른 방법들

5.1. MacPorts로 설치하기

상기와 같이 맥에서는 MacTex로 텍 시스템을 설치하는것을 권장하지만 MacPorts http://www.macports.orgTeXLive를 포함한 모든 포트들을 제어하기를 선호한다면 다음 명령어로 TeXLive를 쉽고 간단하게 설치할 수 있다.
  • 터미널을 열고 다음 명령을 내린다.
    • TeXLive 설치 이전부터 터미널이 실행 중이었다면 닫고 다시 실행한다.
    • $ 기호는 터미널 프롬프트를 나타내는 것으로 직접 써넣어야 하는 것이 아님
  • $ sudo port selfupdate && sudo port install texlive-latex texlive-lang-korean
    
MacTeX_through_MacPorts.png
[PNG image (187.28 KB)]
  • 상기된 방법대로 설치한 후 곧바로 한글 문서를 작성할 수 있다.
    \usepackage{kotex}
    

5.2. install-tl로 직접 설치하기

눅스에서 설치하기와 마찬가지로 install-tl-unx.tar.gz를 이용하여 설치할 수 있다.
  • 다운로드, install-tl 실행
    $ curl -O http://ftp.ktug.org/tex-archive/systems/texlive/tlnet/install-tl-unx.tar.gz
    $ tar zxvf install-tl-unx.tar.gz
    $ cd install-tl-XXXXXXXX
    $ sudo ./install-tl 
    
  • i+ENTER를 눌러서 설치를 시작한다.
  • /usr/local/texlive/2016/bin/ 아래의 x86_64-darwin을 /Library/TeX/texbin으로 링크를 건다.
    $ sudo ln -s /usr/local/texlive/2016/bin/x86_64-darwin/ /Library/TeX/texbin
    
  • 다음과 같은 내용으로 된 "TeX"이라는 이름의 파일을 /etc/paths.d/ 폴더에 만들어 넣는다.
    /Library/TeX/texbin
    
TeXLive_install_by_install-tl-unx_1.png
[PNG image (160.76 KB)]

TeXLive_install_by_install-tl-unx_2.png
[PNG image (233.22 KB)]
  • 다음 후처리를 추천한다. (MacTeX으로 설치한 경우와 동일)
    1. KTUG 사설 저장소의 등록
    2. 서체 관리자에 폰트 등록
    3. texmf.cnf의 수정
    4. TeXShop, BibDesk 등 에디터/유틸리티의 설치 (각각 별도로 다운로드받으면 된다.)

6. MacTeX 배포판 바꾸기

6.1. 명령행을 이용하는 방법

  • 현재 배포판이 무엇무엇이 있나 보여주기
    > texdist --list
    TeXLive-2015.texdist
    TeXLive-2016.texdist
    
  • 현재 배포판은 무엇을 사용하고 있는지 보여주기
    > texdist --current
    TeXLive-2016
    
  • 텍 배포판을 다른 것으로 고치기 (관리자 권한 필요할 수 있음)
    > texdist --setcurrent=TeXLive-2015
    Default TeX set to "TeXLive-2015"
    
Choosing_TeXdsit_1.png
[PNG image (184.46 KB)]

6.2. TeX Live Utility 앱을 이용하는 방법

  • TeX Live Utility를 실행하고 Configure-Reconfigure Distributions를 누른 다음, 원하는 배포판을 선택한다.
Choosing_TeXdsit_2.png
[PNG image (259.21 KB)]

7. 기타

  • 은글꼴, jiwonlipsum, kotex-midkor 등이 필요하다면 KTUG 사설 저장소를 참고.
  • MacTeX 2013과 달리 2014로는 ImageMagick convert가 설치되지 않는다.
    • 이미지 변환을 하려면 ghostscript를 직접 사용하거나 Mac OS의 sips를 이용할 수 있다.
    • 이전에 2013을 설치한 적이 있다면 /usr/local/bin에 convert가 삭제되지 않고 있을 것이다.
    • 그렇지 않을 경우 ImageMagick이 필요하다면 home brew로 설치한다.

8. FAQ

  • TeXShop에서 한글 문서 작성 실패.
    • 한글이 모두 ???로 나오는 경우.
      • 한글 인코딩 문제. TeXShop의 문자 인코딩 관련 사항을 참조.
      • 문서의 제일 처음에 인코딩 설정을 명시할 것.
        %!TEX encoding = UTF-8 Unicode
        


9. Yosemite (OS X 10.10) 관련 이슈

9.1. ghostscript 문제

  • ghostscript가 Yosemite 업그레이드 후 정상 실행되지 않을 수 있다.
  • 증상
    • 터미널에서 gs --version을 실행하였을 때 버전 번호를 보여주는 결과가 제대로 나타나지 않는다.
    • eps 파일 변환과 같은 gs가 필요한 기능이 정상 실행되지 않는다.
  • 해결책 :
    • XQuartz를 새로 설치한다.
    • mactex이 설치해주는 gs를 유지하고 싶다면 이 대화를 참고.
    • 이보다는 mactex 설치 후 home brew로 ghostscript를 새로 설치하여 교체하는 것이 좋다.
      $ brew install ghostscript
      $ brew link --overwrite ghostscript
      

9.2. TeXworks (해결된 문제)

  • -증상-
    • -TeXworks에서 XeLaTeX 실행 실패, eps 그림 변환 실패, --shell-escape 외부명령 실행 실패 등의 문제가 나타날 수 있다.-
    • -LyX에서 mactex으로 설치한 TeX 시스템을 인식하지 못하고 Reconfigure에 실패한다.-
  • 해결책
    • TeXworks나 -LyX- 명령행에서 실행한다.
      • /Applications/TeX/TeXworks.app/Contents/MacOS/TeXworks를 직접 부르거나
      • open -a "texworks" 로 실행
    • -또는, 임시 Launcher를 만들어서 실행한다.-
    • 또는, 이 문제는 TeXworks에서만 발생하므로 TeXShop과 같은 에디터를 이용한다.
  • 참고: TeXworks는 mactex에 포함되어 있지 않다(2014 이후). TeXworks 페이지에서 Mac용을 다운로드받는 링크를 찾을 수 있다.
  • TeXworks 안정 버전(0.4.6)과 개발 버전(0.5.0 r.068158f)이 Mac OS X 10.10.3에서 상기한 문제를 일으키지 않는 것을 확인하였음.
  • LyX은 요세미티를 위한 새로운 버전(2.1.2.1)이 나와서 이 문제가 해결되었다.


10. El Capitan (OS X 10.11) 관련 이슈

10.1. /usr

  • El Capitan에서 /usr에 읽고 쓰기는 (superuser에게도) 금지된다. 따라서 /usr/texbin에 실행 파일 symlink를 만들 수 없으며, /Library/TeX/texbin으로 그 위치가 바뀌었다.
    • 단, /usr/local/ 아래는 읽고 쓸 수 있다.
  • MacTeX은 위의 링크를 만들고 설정하는 일을 처리해준다. 그러나 /usr/texbin을 기본 PATH로 (이전부터) 사용하던 에디터가 있다면 실행 파일 폴더의 path를 위와 같이 수정해주어야 한다.
    • TeXShop은 최신 버전으로 업데이트하면 알아서 해준다.
  • 참고: http://www.tug.org/mactex/elcapitan.html


11. Sierra (macOS 10.12) 관련 이슈

11.1. PATH 문제

  • El Captian에 이어 Sierra에서 /usr에 읽고 쓰기는 (superuser에게도) 금지된다. /usr/texbin에 실행 파일 symlink를 만들 수 없으며, /Library/TeX/texbin으로 그 위치가 바뀌었다. 단, /usr/local/ 아래는 읽고 쓸 수 있다.
    • 운영체제를 El Captian에서 Sierra로 업데이트하고 MacTeX 2015를 MacTeX 2016으로 업그레이드 설치하면 PATH 문제를 겪지 않는다.
    • 사용하던 운영체제가 El Captian 이전 버전(즉 Yosemite, Mavericks, Mountain Lion 등)에서 Sierra로 업데이트하고 MacTeX 2016를 설치하면 PATH 문제를 겪을 수 있다. 이때는 FixLink.pkg를 내려받아 설치한다.
  • 참고: http://www.tug.org/mactex/sierra.html