#title Mac OS X에서 TeX Live 설치하기
#alias MacTeX
#keywords kotex,macos,mactex,tex,texlive,설치,한글,tex live
[[TableOfContents]]

'''2013년 11월 이후 맥에서 한글 텍을 사용하기 위해서는 TeX Live만을 설치하면 됩니다.'''

== 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]을 내려받아 실행한다. 약 2.2 WikiPedia:Gigabytes 이상.

attachment:MacOSInstall3.png?width=800

attachment:MacOSInstall2.png

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

== 한글 환경 ==
=== 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 파일을 텍스트파일로 열어서 제일 위에 다음 코드를 추가한 후 저장한다. 이미 만들어져 있다면 이 과정은 생략한다. {{{
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/2014/texmf-dist/fonts/opentype/public
}}}
 1. 원하는 폰트들을 선택한다.
== 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
}}}
 * 상기된 방법대로 설치한 후 곧바로 한글 문서를 작성할 수 있다. {{{
\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/2014/bin/}}} 아래의 x86_64-darwin을 /usr/texbin으로 링크를 건다. {{{
$ sudo ln -s /usr/local/texlive/2014/bin/x86_64-darwin/ /usr/texbin
}}}
 * 다음과 같은 내용으로 된 "TeX"이라는 이름의 파일을 /etc/paths.d/ 폴더에 만들어 넣는다. {{{
/usr/texbin
}}}
 * 다음 후처리를 추천한다. (MacTeX으로 설치한 경우와 동일)
    1. [KTUG 사설 저장소]의 등록
    1. 서체 관리자에 폰트 등록
    1. texmf.cnf의 수정 
    1. TeXShop, BibDesk 등 에디터/유틸리티의 설치 (각각 별도로 다운로드받으면 된다.)
== 기타 ==
 * 은글꼴, 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 ==
=== 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를 만들어서 실행한다.
        * [http://doeun.blogspot.kr/2014/10/platypus-texworks-launcher.html Platypus로 TeXworks Launcher 만들기(외부링크)]
 * 이 문제는 요세미티의 버그라고 추정되므로 업그레이드 이후에 해결될 수도 있다.
 * 참고: TeXworks는 mactex에 포함되어 있지 않다(2014 이후). [wiki:TeXworks] 페이지에서 Mac용을 다운로드받는 링크를 찾을 수 있다.
 * LyX은 요세미티를 위한 새로운 버전(2.1.2.1)이 나와서 이 문제가 해결되었다.