설치하기MacOSX/Basic TeX

이 글은 Mac OS X에 BasicTeX을 설치하고 ko.TeX을 사용하기 방법을 설명합니다. 주의할 것은 BasicTeX은 TeX Live(혹은 MacTeX)의 일부만 포함하고 있다는 점입니다. 작은 크기에도 놀라울 정도로 강력하지만, 아무튼 TeX Live에 포함된 많은 패키지들이 빠져 있습니다. ko.TeX을 만들고 관리하시는 분들이 TeX Live 전체가 설치되어 있다는 점을 염두에 두고 있는 터라 사용하는데 문제가 생길 수도 있습니다. MacTeX을 기반으로 ko.TeX을 사용하고 싶다면, 해당 글 설치하기MacOSX/Mac TeX을 참조하십시오.

1. 설치

2. 설치 후

2.1. ko.TeX 설치하기
2.2. 사설저장소 설정과 폰트 등 내려받기

3. Homebrew를 이용하는 설치

1. 설치 ¶

BasicTeX을 내려 받습니다: http://tug.org/mactex/morepackages.html
내려받은 파일을 두번클릭하여 실행합니다.

Homebrew를 이용해서 설치할 수도 있습니다.

brew cask install basictex

작년 버전이 설치되어 있는 경우에는 다음처럼 업그레이드를 하면 됩니다.

brew cask upgrade basictex

이것으로 TeX Live의 일부인 BasicTeX이 설치되었습니다.

2. 설치 후 ¶

당연히 ko.TeX은 BasicTeX에 포함되어 있지 않아서 별도로 설치해야 합니다. 물론, TeX Live에 포함되어 있어서 tlmgr을 사용하여 쉽게 설치할 수 있습니다.

2.1. ko.TeX 설치하기 ¶

sudo tlmgr install cjk cjk-ko nanumtype1 kotex-plain kotex-utf kotex-utils

위에서 개인적인 경험상 최소로 필요한 것들만 나열한 것입니다. 디스크 공간이나 네트워크 속도에 크게 게의치 않는다면(그렇다면 애초에 MacTeX을 설치하는 것이 훨씬 유리할 것 같습니다) collection-langkorean을 설치해도 될 것입니다.

collection-langkorean을 설치하면 texmf는 400~500MB입니다. 참고로 MacTeX은 2020년 버전의 경우 약 4.0G입니다.

sudo tlmgr install collection-langkorean

2.2. 사설저장소 설정과 폰트 등 내려받기 ¶

한글 폰트나 한글 관련 특정 패키지들은 TeX Live에 포함되어 있지 않아서 KTUG의 사설저장소를 이용해야 합니다. 아래와 같이 사설저장소를 등록하고 필요한 패키지를 내려받습니다.

sudo tlmgr repository add https://cran.asia/KTUG/texlive/tlnet/ ktug
sudo tlmgr pinning add ktug "*"
sudo tlmgr install jiwonlipsum # optional
sudo tlmgr install nanumttf hcr-lvt # optional

3. Homebrew를 이용하는 설치 ¶

homebrew cask로 basictex을 설치한다. 설치 후에는 terminal을 종료하고 재실행.
```
# brew install basictex
```
- 설치를 위해 super user 권한을 요구한다.
- TeXLive는 /usr/local/texlive/2021basic 아래 설치된다. 이후 texliveonfly나 tinitex 유틸리티를 이용하여 자동 패키지 설치가 가능하게 하려면, 이 폴더를 사용자 권한 아래 두는 것이 좋다(권장). 다음 명령을 실행한다.
```
# sudo chown -R $(whoami) /usr/local/texlive
```
- 바이너리들은 /usr/local/bin에 심볼릭 링크가 걸린 상태로 설치된다. 만약 texliveonfly를 활용할 계획이라면 다음과 같이 하여 python을 만들어두어야 한다.
```
# sudo ln -s `which python3` /usr/local/bin/python
```
  - 참고: 만약 /usr/bin/python3이 존재하지 않는다면, homebrew로 python3을 설치하여야 한다.
- TeX Live tree를 업데이트한다.
```
# tlmgr update --all --self
```
- KTUG 사설 저장소를 추가한다.
```
# tlmgr repository add https://cran.asia/KTUG/texlive/tlnet/ ktug
# tlmgr pinning add ktug "*"
```
TeXShop을 설치한다.
```
# brew install texshop
```
pygments를 설치한다.
```
# brew install pygments
```
ghostscript가 필요하다면 별도로 설치한다.
```
# brew install ghostscript
```
한국어 문서를 작성하려면 한글 폰트와 패키지를 미리 설치해두면 좋다.
```
# tlmgr install kotex-plain kotex-utf nanumtype1 unfonts-core unfonts-extra
```
texmf.cnf을 수정. 수정할 파일은 `/usr/local/texlive/2021basic/ 폴더에 존재한다.
```
# nano `kpsewhich texmf.cnf`
```
현재 내용을 그대로 두고, 다음 행을 추가하고 저장한다.
```
OSFONTDIR = ~/Library/Fonts//;/Library/Fonts//;/System/Library/Fonts//
```

~/Library/Fonts 폴더에 다음 두 폴더를 심볼릭 링크로 건다.

# ln -s /usr/local/texlive/2021basic/texmf-dist/fonts/opentype ~/Library/Fonts/
# ln -s /usr/local/texlive/2021basic/texmf-dist/fonts/truetype ~/Library/Fonts/

자동 패키지 설치를 위하여 texliveonfly를 설치한다.
```
# tlmgr install texliveonfly
```
이후, 패키지 추가가 필요한 문서는 다음과 같이 컴파일한다.
```
# texliveonfly -c xelatex <filename>.tex
```
- 참고: texliveonfly 대신 설치하기/TinyTeX의 tinitex 유틸리티를 이용할 수 있다. TinyTeX Releases에서 macos용 tinitex 바이너리를 다운로드하여 /usr/local/bin에 넣어두고 다음과 같이 사용한다.
```
# tinitex --pdf-engine xelatex <filename>.tex
```
- 참고2: 대부분의 패키지는 이 유틸리티를 이용하여 설치가능하다. 그러나 오픈타입 폰트 등은 tlmgr로 별도로 설치해야 한다. XeLaTeX을 사용한다고 할 적에 다음 폰트 정도는 미리 설치해두면 좋다.
```
unfonts-core
unfonts-extra
hcr-lvt (사설저장소)
libertine
tex-gyre
tex-gyre-math
xits
stix
stix2-otf
```
- 참고3: Noto CJK 폰트는 한글 사용의 사실상 표준이다.
```
# brew install font-noto-serif-cjk-kr font-noto-sans-cjk-kr
```
  font-noto-serif-cjk 포뮬러를 설치하면 ttc 폰트가 설치된다. 조금 번거롭지만 -kr, -jp 등의 꼬리표가 붙는 포뮬러로 지정하여 설치하는 쪽을 권장한다.
필수 유틸리티 몇 개를 미리 설치해둔다.
```
# tlmgr install latexmk spix arara lcdftypetools xindy biber kotex-utils
```
pdfinfo, pdffonts 등의 유틸리티가 필요하면
```
# brew install poppler
```