#title MacTeX 설치
#keywords kotex,macos,mactex,tex,texlive,설치,한글,tex live

[[TableOfContents]]

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

http://www.tug.org/mactex/images/mactexlogoX5.png

 * [http://ftp.ktug.org/tex-archive/systems/mac/mactex/ CTAN] 또는 [http://tug.org/mactex]에서  [http://ftp.ktug.org/tex-archive/systems/mac/mactex/MacTeX.pkg MacTeX]을 내려받아 실행한다. 

attachment:Install_MacTeX2016_1.png
attachment:Install_MacTeX2016_2.png
attachment:Install_MacTeX2016_3.png
attachment:Install_MacTeX2016_4.png
attachment:Install_MacTeX2016_5.png

=== 설치 후 업데이트 ===
 * 설치 후, TeX Live Utility를 실행하여 메뉴에서 "Update All Packages"(단축키: Shift-Cmd-U)를 실행한다.
     * TeX Live Utility는 Applications(응용 프로그램) 아래 TeX 폴더 안에 있다.
 * 또는, 터미널을 열고 다음 명령을 내린다. 
     * MacTeX 설치 이전부터 터미널이 실행 중이었다면 닫고 다시 실행한다.
     * # 기호는 터미널 프롬프트를 나타내는 것으로 직접 써넣어야 하는 것이 아님 {{{
# sudo tlmgr update --all --self
}}}
attachment:tlmgr_update_all.png
== 한글 환경 ==
=== MacTeX (full) 설치의 경우 ===
 * 위에서 MacTeX을 설치한 후 업데이트하는 것만으로 한글 문서를 작성할 수 있다. {{{
\usepackage{kotex}
}}}
=== 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
}}}
== XeTeX 사용을 위한 설정 ==
=== 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 권한이 필요할 수 있다.

파일을 열고 편집하는 것이 불편하다면 적당한 폴더에서 다음 명령을 터미널에서 차례로 내린다.(#은 프롬프트) {{{#!vim
# 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를 요구한다.

=== TeXLive의 폰트를 맥 OS 폰트 라이브러리로 등록하기 ===
자세한 내용은 이 글토막의 출처인 [http://doeun.tistory.com/172]을 참조.
 1. 서체관리자 실행
 1. 파일 -> 새로운 보관함 (New Library) 메뉴
 1. 적당한 이름을 써넣는다.
 1. 파일 -> 서체 추가 (Add Fonts)를 선택한다. 또는 위의 이름에서 우클릭해서 서체 추가를 선택해도 된다. 
 1. 파일 선택창이 열린다. 경로가 매우 길기 때문에 Shift-Cmd-G 를 눌러준 다음 경로를 입력한다.{{{
/usr/local/texlive/2016/texmf-dist/fonts/opentype/public
}}}
 1. 원하는 폰트들을 선택한다.
=== symbolic link ===
 * 사용자의 `~/Library/Fonts` 아래에 TeX Live의 트루타입과 오픈타입 폴더를 링크해두는 방법이 있다. 이 방법은 TeX Live를 full로 설치하였을 때 등록되는 폰트가 너무 많아지기 때문에 선별적으로 등록하고자 하는 사용자에게는 적당하지 않지만 다른 고려 없이 TeX Live 폰트를 바로 사용할 수 있다는 장점이 있다.
{{{#!bash
# 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 폰트 패밀리를 등록하려면 
{{{#!bash
# cd ~/Library/Fonts
ln -s /usr/local/texlive/2016/texmf-dist/fonts/truetype/public/xits ~/Library/Fonts/
}}}
attachment:texmf_font_symlink.png?width=700
attachment:FontBook.png?width=800

== 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

attachment:texliveutility1.png?width=800

== TeX Live를 설치하는 다른 방법들 ==
=== MacPorts로 설치하기 ===
상기와 같이 맥에서는 MacTex로 텍 시스템을 설치하는것을 권장하지만 MacPorts [http://www.macports.org]로 TeXLive를 포함한 모든 포트들을 
제어하기를 선호한다면 다음 명령어로 TeXLive를 쉽고 간단하게 설치할 수 있다.
 * 터미널을 열고 다음 명령을 내린다. 
    * TeXLive 설치 이전부터 터미널이 실행 중이었다면 닫고 다시 실행한다.
    * $ 기호는 터미널 프롬프트를 나타내는 것으로 직접 써넣어야 하는 것이 아님 
 {{{
$ sudo port selfupdate && sudo port install texlive-latex texlive-lang-korean
}}}
attachment:MacTeX_through_MacPorts.png
 * 상기된 방법대로 설치한 후 곧바로 한글 문서를 작성할 수 있다. {{{
\usepackage{kotex}
}}}
=== install-tl로 직접 설치하기 ===
[wiki:"리눅스에서의 TeX Live와 ko.TeX의 설치" 리눅스에서 설치하기]와 마찬가지로 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
}}}
attachment:TeXLive_install_by_install-tl-unx_1.png

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

== MacTeX 배포판 바꾸기 ==
 * 여러 개 설치된 MacTeX 배포판을 지우지 않고 골라 사용할 수 있다. 
 * 참고: http://www.ktug.org/xe/index.php?document_srl=219284&mid=blog

=== 명령행을 이용하는 방법 ===
 * 현재 배포판이 무엇무엇이 있나 보여주기 {{{
> texdist --list
TeXLive-2015.texdist
TeXLive-2016.texdist
}}}
 * 현재 배포판은 무엇을 사용하고 있는지 보여주기 {{{
> texdist --current
TeXLive-2016
}}}
 * 텍 배포판을 다른 것으로 고치기 (관리자 권한 필요할 수 있음) {{{
> texdist --setcurrent=TeXLive-2015
Default TeX set to "TeXLive-2015"
}}}
attachment:Choosing_TeXdsit_1.png?width=800 

=== TeX Live Utility 앱을 이용하는 방법 ===
 * TeX Live Utility를 실행하고 [Configure]-[Reconfigure Distributions]를 누른 다음, 원하는 배포판을 선택한다.
attachment:Choosing_TeXdsit_2.png?width=800 

== 기타 ==
 * 은글꼴, jiwonlipsum, kotex-midkor 등이 필요하다면 [wiki:KtugPrivateRepository KTUG 사설 저장소]를 참고.
 * MacTeX 2013과 달리 2014로는 ImageMagick convert가 설치되지 않는다. 
   * 이미지 변환을 하려면 ghostscript를 직접 사용하거나 Mac OS의 sips를 이용할 수 있다. 
   * 이전에 2013을 설치한 적이 있다면 /usr/local/bin에 convert가 삭제되지 않고 있을 것이다. 
   * 그렇지 않을 경우 ImageMagick이 필요하다면 home brew로 설치한다.
== FAQ ==
 * TeXShop에서 한글 문서 작성 실패.
   * 한글이 모두 ???로 나오는 경우. 
      * 한글 인코딩 문제. [TeXShop]의 문자 인코딩 관련 사항을 참조.
      * 문서의 제일 처음에 인코딩 설정을 명시할 것. {{{
%!TEX encoding = UTF-8 Unicode
}}}

== Yosemite (OS X 10.10) 관련 이슈 ==
=== ghostscript 문제 ===
 * ghostscript가 Yosemite 업그레이드 후 정상 실행되지 않을 수 있다.
 * 증상
    * 터미널에서 `gs --version`을 실행하였을 때 버전 번호를 보여주는 결과가 제대로 나타나지 않는다.
    * eps 파일 변환과 같은 gs가 필요한 기능이 정상 실행되지 않는다.
 * 해결책 : 
    * [http://xquartz.macosforge.org/landing/ XQuartz]를 새로 설치한다. 
    * mactex이 설치해주는 gs를 유지하고 싶다면 [http://www.ktug.org/xe/index.php?document_srl=188321 이 대화]를 참고.
    * 이보다는 mactex 설치 후 home brew로 ghostscript를 새로 설치하여 교체하는 것이 좋다. {{{
$ brew install ghostscript
$ brew link --overwrite ghostscript
}}}
     * homebrew 설치가 필요한 경우 참고할 수 있는 안내 [[http://coolestguidesontheplanet.com/installing-homebrew-os-x-yosemite-10-10-package-manager-unix-apps/ yosemite에서 homebrew 설치하기]]
=== 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 이후). [wiki:TeXworks] 페이지에서 Mac용을 다운로드받는 링크를 찾을 수 있다.
 * TeXworks 안정 버전(0.4.6)과 개발 버전(0.5.0 r.068158f)이 Mac OS X 10.10.3에서 상기한 문제를 일으키지 않는 것을 확인하였음.
 * LyX은 요세미티를 위한 새로운 버전(2.1.2.1)이 나와서 이 문제가 해결되었다.


== El Capitan (OS X 10.11) 관련 이슈 ==
=== /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


== Sierra (macOS 10.12) 관련 이슈 ==
=== 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 문제를 겪을 수 있다. 이때는 [http://pages.uoregon.edu/koch/FixLink.pkg FixLink.pkg]를 내려받아 설치한다. 
 * 참고: http://www.tug.org/mactex/sierra.html