기본적으로 Mac OS X 의 경우 BSD Unix 를 기반으로한 darwin 이라는 운영체제위에서 만들어져 있기 때문에 거의 대부분의 기존 UNIX 설치 방법을 사용할 수 있지만 몇가지 유틸리티를 이용해서 더 간단하게 설치하는 것이 가능하다.

[[TableOfContents]]
== teTeX 설치하기 ==
[teTeX]을 설치하는 데는 세 가지 방법이 있다.
 1. i-installer를 이용한 설치
   1. i-installer를 이용한 개별 설치
   1. MacTeX을 이용한 일괄 설치
 1. Fink를 이용한 설치
 1. 컴파일 설치
세 가지 방법 가운데 어느 것이든 잘 작동한다. MacTeX을 이용한 i-installer 설치가 가장 바람직하다고 생각되는데 그 이유는 dvipdfmx, ttf2pk, ttf2tfm이 모두 포함되어 있기 때문에 별도로 프로그램을 빌드해야 하는 수고를 절약할 수 있는 데다가, 설치 인터페이스가 맥 환경에 친숙하고 유지 관리가 쉽다는 점 때문이다. 
혼란을 피하기 위하여 이 글에서는 MacTeX, i-installer로 설치하는 경우를 소개하기로 한다. Fink로 설치하는 경우에 대해서는 [MacOS에서설치하기/Alternative]를 참고하라.
=== 디렉토리 구조 ===
[teTeX]의 설치 운영에서 사용자가 신경써야 할 것은 디렉토리 구조이지만 i-installer를 이용하는 경우에는 많은 부분을 신경쓰지 않아도 된다는 점이 편리하다. 예컨대 많은 Mac 관련 TeX 유틸리티들은 i-installer를 이용하여 설치된 상태를 기본값으로 잡고 있다. TeXShop, iTeXMac, TeXShell in TeXTools 등이 대부분 그러하다. 다만 기본적으로 설치되는 시스템 위에 사용자가 customize해야 하는 부분의 디렉토리 위치인 ~/Library/texmf 를 기억해두는 것으로 충분하다.
 1. i-installer를 이용한 경우
   * 실행파일의 위치 : /usr/local/teTeX/bin/powerpc-apple-darwin-current/
   * main  texmf tree : /usr/local/teTeX/share/texmf
   * local texmf tree : /usr/local/teTeX/share/texmf.local
   * 설정 파일의 위치 : /usr/local/teTeX/texmf.cnf
 1. Hangul-ucs 설치에 이용할 texmf tree (이 글에서의 설정)
   * 주요 파일 : /usr/local/teTeX/share/texmf.local
   * 설정 파일 : $HOME/Library/texmf 를 이용한다.
=== MacTeX을 이용한 일괄 설치(권장) ===
TeXLive 버전의 [teTeX]을 [CTAN]에서 한꺼번에 내려받아 설치할 수 있다. 이 패키지는 i-Installer를 바탕으로 하여 TeXShop, BibDesk, GhostScript, Excalibur(스펠체커), XeTeX 등 TeX 운영에 필요한 거의 모든 프로그램은 물론이고 [i-Installer]까지도 한꺼번에 설치해준다. 이 프로그램으로 설치한 결과는 i-Installer로 설치한 것과 동일하다.
처음 설치하는 사람은 이 일괄 설치 패키지를 이용하면 TeXShop 등을 다운로드받아서 따로 설치해야 하는 부담을 줄일 수 있다.
 참고. MacTeX을 이용하지 않고 [i-Installer]로 하나씩 별도로 설치하려 한다면 [MacOS에서설치하기/I-Installer] 페이지를 볼 것.

CTAN:systems/mac/mactex/

단점이라면 파일 크기가 좀 크다는 점. 약 288 WikiPedia:Mebibyte''''''s.

'''설치방법''' : MacTeX.dmg 파일을 다운로드받아서 실행한다.
== Hangul-ucs 설치 ==
사용자의 한글 환경은 다음과 같이 구축하기로 하자.
 1. [Hangul-ucs]를 이용하여 UTF-8 한글 문서를 처리한다.
   그러므로 HLaTeX을 설치할 필요는 없다.
 1. DVI 파일 포맷을 이용하지 않는다.
   따라서 ttf2pk는 이용하지 않을 것이며, ttf2tfm은 새로운 폰트 사용을 위해서 사용할 것이다. i-installer로 설치하면 ttf2pk, ttf2tfm이 모두 설치되지만 Fink를 이용하는 경우 사용자가 직접 이 프로그램들을 빌드하여야 한다는 사실을 알아두자.
 1. [Hangul-ucs]를 설치하기 위해서 [KTUGCollection Project]의 공개판을 이용하는 방법도 있지만 간단히 [Hangul-ucs]만을 설치하고자 한다면 너무 부담스럽다. 그래서 간단 설치 방법을 이용하기로 한다.
=== 설치 파일 다운로드 ===
 * 2.7.2
  [http://ftp.ktug.or.kr/~karnes/PRIVATE/experimental/Hangul-ucs-2.7.2.dmg hangul-ucs-2.7.2.dmg]
=== 설치 순서 ===
Readme 파일을 읽고 그대로 따라한다.
 1. Hangul-ucs-X.dmg를 마운트한다.
 1. install 파일을 더블클릭한다.
=== 사소하지만 중요한 팁 (1) ===
i-installer 또는 MacTeX으로 teTeX을 설치한 경우 dvipdfm 맵 파일과 dvipdfmx가 약간 충돌하는 문제가 있다. 이를 해결하기 위하여 다음과 같이 처리한다. cf. KTUGSetup:8776
 1. {{{~/Library/texmf/fonts/map/dvipdfm/updmap/dvipdfm.map}}} 또는 만약 이 파일이 없다면 {{{/usr/local/teTeX/share/texmf.local/fonts/map/dvipdfm/updmap/dvipdfm.map}}} 파일을 찾는다. 다음의 명령을 실행하면 바로 수정할 수 있다. {{{
#> sudo vi `kpsewhich map dvipdfm.map`
}}}
 1. 여섯번째 줄의 다음 행을 삭제하거나 코멘트 처리한다. {{{
HoeflerTextOrnaments hoeflertextornaments <hoeflertextornaments.enc 
}}}
=== 사소하지만 중요한 팁 (2) ===
위의 설치 파일을 이용하여 hangul-ucs를 설치하면 makeindex-dhucs, gs-ebb.sh, tex2pdf 등의 스크립트가 {{{/usr/local/bin}}}에 설치된다. 그러므로 TeXShop에서 DVIPDFMx를 사용하기 위하여(see [TeXShop/DVIPDFMx]) tex2pdf 스크립트를 설정할 때, {{{/usr/local/bin/tex2pdf}}}와 같이 full path를 써주는 것이 좋다.

== MiKTeXTools 설치와 활용 ==
See MiKTeXTools.

(!) memhangul-ucs를 사용하기 위해서는 teTeX 배포판에 있는 몇 가지 패키지를 업그레이드하거나 별도의 패키지를 설치해야 할 경우가 있다. 이를 간단하기 처리하기 위해서 MiKTeXTools를 사용할 것을 권장한다. 만약 MiKTeXTools를 설치하였다면, memoir 업데이트는 다음과 같이 간단히 처리할 수 있다. 또한 memoir 이외에도 xcolor와 같은 (배포판에는 이전 판이 포함된) 패키지의 업그레이드도 쉽게 이루어진다. 다음은 권장하는 몇 가지 패키지의 설치 예들이다.
{{{
$ sudo mpm --install=memoir
$ sudo mpm --install=xcolor
$ sudo mpm --install=sttools
$ sudo mktexlsr
}}}== memhangul-ucs의 설치 ==
위의 간단 설치 패키지에는 memhangul-ucs가 포함되어 있지 않다. 혹시라도 이 패키지를 써보고자 한다면 다음과 같이 설치한다.

먼저 memoir 를 최신버전으로 업그레이드 한다.

MiKTeXTools를 이용하지 않고 수작업으로 업그레이드하려면
    * attachment:memoir.zip
    * 위의 zip 파일을 다운로드받아 풀면 memoir라는 폴더가 생긴다.
    * ~/Library/texmf 폴더를 열고 이 위치에서 {{{tex/latex}}} 폴더를 차례로 열고 들어간 다음, 위의 memoir라는 폴더를 이 위치에 가져다둔다. 즉 {{{~/Library/texmf/tex/latex/memoir}}}가 되도록 한다.

다음 순서로 memhangul-ucs를 설치한다.
 * [http://ftp.ktug.or.kr/~karnes/PRIVATE/experimental/memhangul-ucs-for-macosx.zip memhangul ucs : to your Library Folder and unzip on Terminal]
 1. 위의 파일을 다운로드받아서 홈 폴더 아래 라이브러리 폴더로 옮긴다.
 1. 터미널을 열어서 다음과 같이 풀어준 다음 mktexlsr한다.
{{{
cd ~/Library
unzip memhangul-ucs-for-macosx.zip
}}}== TrueType 폰트 설치하기 ==
위의 간단 설치 패키지를 이용하여 설치하면 은글꼴은 함께 설치되므로 기본적인 문서의 작성에는 어려움이 없다. 그러나 다른 트루타입 글꼴을 사용하려 하는 경우가 있을 수 있다.
SeeAlso. [트루타입글꼴사용하기]
=== 다른 글꼴의 설치 ===
한글 트루타입을 사용하려면 ttf2hlatexfont.pl을 이용하여야 한다. 이것은 설치가 이미 되었다.
i-installer로 설치한 teTeX 시스템은 ttf2tfm을 이미 포함하고 있으므로 즉시 사용이 가능하다.
=== 일본어/중국어 사용 ===
[Hangul-ucs]의 추가 패키지인 trivcj를 사용하여 일본어나 중국어를 식자할 수 있다. 그러나 이것은 DVIPDFMx를 통해서만 가능하며 pdfTeX으로는 되지 않는다는 사실을 명심해야 한다. trivcj 패키지는 간단 설치 팩으로 함께 설치된다.

테스트 결과, TeXShop의 previewer는 trivcj로 조성한 일본어와 중국어 폰트를 잘 보여주었다.(Mac OS X 10.4.3)

attachment:texshopshot.jpg
== Editor와 작업환경 ==
예전 Mac OS Classic(8.x)에서 CMacTeX 또는 OzTeX을 쓸 때 [BBEdit], 엑스칼리버, Texedit 등이 유명했던 것으로 기억한다. 그런데 지금은... 역시 습관은 무서운 것인지 맥에서도 터미널을 열고 명령행 컴파일을 하고 있는 자신을 발견할 때... 
=== TeXShop 이용하기 ===
TeXShop 은 teTeX을 편하게 사용하게 도와주는 IDE라고 생각하면 된다. TeXShop을 별도로 설치하려면 TeXShop 페이지를 참조하라. MacTeX으로 일괄설치하였다면 한꺼번에 설치되므로 편리하다.

기본적으로 Mac OS X는 UTF-8 유니코드를 지원하므로 에디터를 사용하는 데 큰 문제는 없다. 파일의 인코딩을 반드시 Unicode/UTF-8로 선택해둔다.

TeXShop 은 LaTeX/dvipdfmx 구조가 아니라 pdfLaTeX 을 사용하여 컴파일하는 것이 기본 설정이다. 그러나 이 설정은 사용자가 적절하게 수정할 수 있다. 
==== DVIPDFMx를 이용하기 ====
See TeXShop/DVIPDFMx
==== PDF sync ====
See TeXShop/PDFSync
=== AquamacsEmacs ===
 * 여러가지 Mac 용 이맥스 중에서 Mac 의 Aqua 환경에서 구축되고 한글입력도 문제없이 된다. [Emacs]에 익숙하다면 TeXShop에 의존할 필요가 없을 것이다.
 * http://aquamacs.org
 * emacs와 texshop을 이용하여 pdflatex을 편하게 사용하는 방법
  * http://www.evergreen.loyola.edu/~educkworth/emacs_texshop.html
  * TeXShop은 OSX의 preview의 pdf파일을 자동으로 refresh해주기 때문에(xdvi와 같이), 이를 이용하여 emacs와 preview를 사용하여 pdflatex의 편집을 쉽게 해주는 방법
   * DeleteMe 이거 쓰고 나니까 별로 dvi를 거치는 방법이 쓰고 싶어 지지 않더군요. :-) -- [Recypace] 

=== TeXTools의 TeXShell과 MacDviX 이용하기 ===
 * 만약 DVI 파일을 맥에서도 보고 싶다면 TeXTools의 일부인 MacDviX가 적당하다. 이것은 CMacTeX의 저자인 T. Kiffe 씨가 만든 것으로 Hangul-ucs의 은글꼴 등과도 비교적 잘 작동하는 것으로 보인다. MacDviX를 사용해보기로 하였다면 다음 사항에 주의하라.
   (그러나 개인적인 견해로 Mac OS X에서 예전 OzTeX이나 CMacTeX 기분을 느끼고 싶은 나름의 복고 취향이 아니라면 dvi를 이용해야 할 아무런 이유가 없다고 생각한다.)
   * TeX 시스템은 i-installer로 설치되어 있어야 한다.
   * TeXShell과 맞추는 것이 사용상 편리하다.
   * TeXShell은 TeX 사용 셸 환경이고 편집기를 내장하고 있지 않다. BBEdit과 같은 편집기를 위한 별도의 Addon을 같은 저자가 제공하고 있으므로 참고할 수 있다.
 * MacDviX의 기본값은 300dpi 폰트를 만드는 것이다. 인쇄에는 적당하지 않으므로 인쇄를 위해서는 dvipdfmx 등으로 얻어진 pdf를 이용하자.
 * 참고로 dvi viewer로서 MacDviX는 dvips 드라이버에 의존한다. 그러므로 dvipdfm이나 pdftex을 위한 코드는 제외하고 dvips 기본 옵션으로 문서를 컴파일하는 것이 좋다.
== 유틸리티 ==
 * Equation Editor 
   http://evolve.lse.ac.uk/software/EquationEditor
     Keynote에 수식을 붙여넣는 데 쓰이는 수식 편집기. 키노트의 화려함과 아름다운 TeX 수식을 결합할 수 있다. 강력 추천.
 * LaTeXiT
   http://ktd.club.fr/programmation/latexit_en.php
    OSX의 service에 등록되어 이를 지원하는 모든 application(KeyNote, WriterExpress, Mail, Pages, ...)에서 latex equation을 쓸 수 있게 해준다. 개인적으로는 Equation Editor보다 선호하고 있습니다.
 * TeXniscope
   PDF 뷰어. TeXShop이 아니라 Emacs나 alpha 에디터와 연동하여 작업하려 한다면 이 뷰어가 쓸 만하다.
== 기타 ==
=== 운영관련 팁 ===
 * dvipdfmx 는 [kpathsea] 기능을 이용해서 파일을 찾는다.
 * {{{kpsewhich --progname=dvipdfmx -format="truetype fonts" <FILE_NAME>}}} 로 해서 파일의 위치를 확인해 볼 수 있다.
 * jpg 을 includegraphics 하기 위해서 보통 graphicx 패키지를 사용한다. 
{{{
\usepackage{graphicx}
\DeclareGraphicsExtensions{.jpg,.pdf}
\DeclareGraphicsRule{.jpg}{eps}{.bb}{}
\DeclareGraphicsRule{.pdf}{eps}{.bb}{}
}}}
 * 그림은 pdf 또는 jpg 포맷으로 준비한다. PDFLaTeX을 이용하는 경우라면 별도로 더 준비할 것은 없지만 DVIPDFMx를 쓴다면 .bb 파일을 얻어둔다. [bb파일얻기]. 일러스트레이터 등으로 준비한 pdf 그림의 버전이 1.4보다 높으면 ebb가 잘 동작하지 않으므로 gs-ebb.sh를 사용하라.
 * 그림 자체의 여백이 너무 큰 경우 pdf 그림을 적당한 크기로 자르는 데는 pdfcrop 유틸리티를 이용하는 것이 편리하다. 예를 들면 example.pdf라는 그림이 있을 때 먼저 이 그림의 이름을 적당히 바꾼 다음 여기에 pdfcrop을 실행하여 example.pdf를 만들도록 된다.
{{{
$ mv example.pdf example_000.pdf
$ pdfcrop example_000.pdf example.pdf
}}}

=== 테스트 ===
==== 테스트 코드 ====
다음과 같은 코드로 테스트 해보자.
{{{#!vim tex
\documentclass{article}
\usepackage{dhucs}
\usepackage{dhucs-ucshyper}
%\usepackage{ifpdf} % dhucs-ucshyper보다 뒤에서는 필요없음.
\ifpdf
 \usepackage{dhucs-cmap}
 \pdfmapfile{+unttf-pdftex-dhucs.map}
 \usepackage{pdfsync}
\fi
\begin{document}
\section{헬로우}
안녕하세요, Hello World.
\end{document}
}}}==== 스크린샷 ====
한글 문서의 작업 결과

attachment:firsttestscreenshot.jpg

Uploads:macos.jpg
== 참고 ==
=== 바깥고리 ===
 * TeX on Mac OS X 
  * http://www.rna.nl/tex.html 
  *http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&item_id=xetex
 * For x86 OSX
  * http://maxxuss.hotbox.ru/index.html
=== 기타 ===
 * Mac OS X Tiger for Unix Geeks (O'reilly) 의 146페이지 [http://www.oreilly.com/catalog/macxtigerunix/index.html]
 * 한글 HLaTeX 의 경우 [MacOSX에서설치하기]를 참조한다.
 * KTUGSetup:7896
 * KTUGSetup:7864
 * KTUGSetup:7922
 * KTUGSetup:7929
 * KTUGSetup:7956
 * KTUGSetup:8541
 * KTUGSetup:8605
 * KTUGSetup:8616

----
CategoryFaq