Mac OS X (10.4+) 에서 MacTeX+Hangul-ucs(simple install)+MiKTeXTools 로 TeX을 설치하고, TeXShop+BibDesk를 이용하여 문서를 작성하는 환경은, 한글 문서 작성에 관한 한 운영체제를 막론하고 가장 편리하고 강력한 작업환경을 제공해준다. 취향에 따라 AquamacsEmacs를 이용해도 된다. 설치 자체가 매우 쉽다.
 종래 Mac User들은 HLaTeX 사용자가 많았으나, HLaTeX을 디폴트로 사용할 경우 spot light에 의해서 검색이 가능한 pdf를 만들기가 어렵다. 설치의 용이성이나 만들어진 문서의 관리 등을 고려한다면 이 페이지가 제시하는 방법을 따르는 것이 좋다고 생각한다. 이 방법으로 만들어진 pdf는 InverseSearch 및 ForwardSearch가 가능하며, spotlight에 의하여 검색이 되고, 예컨대 EndNote나 Macjournal, yojimbo와 같은 DB툴로 직접 관리가 가능하다.

[[TableOfContents]]
== teTeX 설치하기 ==
[teTeX]을 설치하는 데는 몇 가지 방법이 있다.
 1. MacTeX을 이용한 일괄 설치
 1. [i-Installer]를 이용한 설치
 1. Fink를 이용한 설치
 1. 컴파일 설치
위의 방법 가운데 어느 것이든 잘 작동한다. MacTeX을 이용한 설치가 가장 바람직하다고 생각되는데 그 이유는 dvipdfmx, ttf2pk, ttf2tfm이 모두 포함되어 있기 때문에 별도로 프로그램을 빌드해야 하는 수고를 절약할 수 있는 데다가, 설치 인터페이스가 맥 환경에 친숙하고 유지 관리가 쉽다는 점 때문이다. 
혼란을 피하기 위하여 이 글에서는 MacTeX으로 설치하는 경우를 소개하기로 한다. Fink로 설치하는 경우에 대해서는 [MacOS에서설치하기/Alternative]를, i-Installer에 대해서는 [i-Installer]를 참고하라. Hangul-ucs 간편 설치는 MacTeX만을 지원한다.
=== MacTeX을 이용한 일괄 설치(권장) ===
MacTeX을 [CTAN]에서 한꺼번에 내려받아 설치할 수 있다. 이 패키지는 TeX 시스템(teTeX) 이외에도 TeXShop, BibDesk(BibTeX 편집기), LaTeXIt 등 TeX 운영에 필요한 거의 모든 프로그램을 한꺼번에 설치해준다. 이 프로그램으로 설치한 결과는 i-Installer로 설치한 것과 (거의) 동일하다.
처음 설치하는 사람은 이 일괄 설치 패키지를 이용하면 TeXShop 등을 다운로드받아서 따로 설치해야 하는 부담을 줄일 수 있다.
 참고. MacTeX을 이용하지 않고 [i-Installer]로 하나씩 별도로 설치하려 한다면 [MacOS에서설치하기/I-Installer] 페이지를 볼 것.

CTAN:systems/mac/mactex/

단점이라면 파일 크기가 좀 크다는 점. 약 330 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]만을 설치하고자 한다면 너무 부담스럽다. 그래서 간단 설치 방법을 이용하기로 한다.
=== 설치 파일 다운로드 ===
 * 3.1.4
 [http://ftp.ktug.or.kr/~karnes/PRIVATE/experimental/Hangul-ucs-simple-install-3.1.4.dmg Hangul-ucs-simple-install-3.1.4.dmg]
    * MacTeX 20061110 버전에 맞춤.
    * Power PC or Intel Mac
=== 설치 순서 ===
Readme 파일을 읽고 그대로 따라한다.
 1. Hangul-ucs-X.dmg를 마운트한다.
 1. install 파일을 더블클릭한다.
=== DVIPDFMx 실행파일의 교체 ===
MacTeX에 들어 있는 dvipdfmx가 조금 낡은 버전이다. 새 버전을 사용해보려 한다면 다음 글을 참조.
See KTUGBoard:6271
 http://project.ktug.or.kr/dvipdfmx/contrib/bin/
내려받은 바이너리 파일을 {{{/usr/local/teTeX/bin/powerpc-apple-darwin-current/}}} 또는 {{{/usr/local/teTeX/bin/i386-apple-darwin-current/}}} 아래 dvipdfmx라는 이름을 가지도록 복사하면 된다. 원래 있던 파일을 대체하도록 한다.

=== hdvipdfm.def 파일의 변경 ===
PathFinder 의 viewer 를 사용하면 dvipdfmx 로 만든 pdf 파일의 링크가 동작하지 않는다. 이를 해결하기 위해서는 
${TEXMF}/tex/latex/hyperref/hdvipdfm.def 파일의 64번째 줄(새로운 버전의 hyperref 의 경우 114라인)을
  \@pdfm@mark{dest (#1) [@thispage /\@pdfview\space @xpos @ypos]}%
아래와 같이 고쳐야 한다. 단지 null 만 붙이면 된다.
  \@pdfm@mark{dest (#1) [@thispage /\@pdfview\space @xpos @ypos null]}%

See KTUGBoard:6273
=== 사소하지만 중요한 팁 (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.

예컨대 다음과 같이 하면 패키지를 간단히 설치할 수 있다.
{{{
$ sudo mpm --install=unicode
}}}

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

먼저 memoir 를 최신버전으로 업그레이드 한다. MiKTeXTools를 컴파일하여 사용하게 되었다면,
{{{
$ mpm --install=memoir
}}}
   Permission 관련 에러가 뜨면 {{{sudo mpm}}}과 같이 실행한다.

MiKTeXTools를 이용하지 않고 수작업으로 업그레이드하려면
    * [http://ftp.ktug.or.kr/tex-archive/macros/latex/contrib/memoir.zip memoir.zip]
    * 위의 zip 파일을 다운로드받아 풀어서 필요한 파일을 {{{~/Library/texmf/tex/latex}}} 아래 알맞게 가져다둔다.

oblivoir 패키지를 사용하는 경우 패키지 버전 때문에 몇 가지 오류가 생기는 경우가 있다. 대부분 해당 패키지를 업데이트해주면 문제가 해결되는데 그 가운데 중요한 것을 몇 가지 들면,
{{{
$ mpm --install=hyperref
$ mpm --install=oberdiek
$ mpm --install=xkeyval
$ mpm --install=xcolor
}}}
등이 있다. mpm으로 패키지를 설치한 후에는 {{{mktexlsr}}}를 실행하여야 한다.
== TrueType 폰트 설치하기 ==
위의 간단 설치 패키지를 이용하여 설치하면 은글꼴은 함께 설치되므로 기본적인 문서의 작성에는 어려움이 없다. 그러나 다른 트루타입 글꼴을 사용하려 하는 경우가 있을 수 있다.
SeeAlso. [트루타입글꼴사용하기]
=== 다른 글꼴의 설치 ===
한글 트루타입을 사용하려면 ttf2hlatexfont.pl을 이용하여야 한다. 이것은 설치가 이미 되었다.
MacTeX으로 설치한 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] 
 * AquamacsEmacs와 TeXniscope를 이용한 작업환경 구축
   * http://faq.ktug.or.kr/faq/Karnes/2006-04#d3fbdac4687e6fe3e709878f996d332e

=== TeXTools의 TeXShell과 MacDviX 이용하기 ===
 * 만약 DVI 파일을 맥에서도 보고 싶다면 TeXTools의 일부인 MacDviX가 적당하다. 이것은 CMacTeX의 저자인 T. Kiffe 씨가 만든 것으로 Hangul-ucs의 은글꼴 등과도 비교적 잘 작동하는 것으로 보인다. MacDviX를 사용해보기로 하였다면 다음 사항에 주의하라.
   (그러나 개인적인 견해로 Mac OS X에서 예전 OzTeX이나 CMacTeX 기분을 느끼고 싶은 나름의 복고 취향이 아니라면 dvi를 이용해야 할 아무런 이유가 없다고 생각한다.)
   * TeX 시스템은 MacTeX 또는 i-installer로 설치되어 있어야 한다.
   * TeXShell과 맞추는 것이 사용상 편리하다.
   * TeXShell은 TeX 사용 셸 환경이고 편집기를 내장하고 있지 않다. BBEdit과 같은 편집기를 위한 별도의 Addon을 같은 저자가 제공하고 있으므로 참고할 수 있다.
 * MacDviX의 기본값은 300dpi 폰트를 만드는 것이다. 600dpi(ljfour) 정도로 수정하는 것이 좋다. 인쇄에는 적당하지 않으므로 인쇄를 위해서는 dvipdfmx 등으로 얻어진 pdf를 이용하자.
 * 참고로 dvi viewer로서 MacDviX는 dvips 드라이버에 의존한다. 그러므로 dvipdfm이나 pdftex을 위한 코드는 제외하고 dvips 기본 옵션으로 문서를 컴파일하는 것이 좋다.
== 유틸리티 ==
 * Equation Editor 
   http://evolve.lse.ac.uk/software/EquationEditor
     Keynote에 수식을 붙여넣는 데 쓰이는 수식 편집기. 키노트의 화려함과 아름다운 TeX 수식을 결합할 수 있다. 강력 추천.
 * LaTeXiT : MacTeX에 포함되어 있음.
   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}
}}}
oblivoir를 이용한다면,
{{{#!vim tex
\documentclass{oblivoir}
\ifpdf
 \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
 * KTUGSetup:10879
----
CategoryFaq