MiKTeX - KTUG Wiki

윈도(MS Windows)에서 가장 유명한 TeX Implementations의 하나.

1. Windows 설치 ¶

1.1. 명령행 ¶

Windows 10 이상의 OS인 경우 powershell 혹은 cmd 에서 winget 명령을 써서 아래처럼 ID를 명확하게 알려주고 인스톨하는 것을 추천한다.

winget install --exact --id MiKTeX.MiKTeX

귀찮으면 아래처럼 명령한다.

winget install MiKTeX

1.2. Installer 다운로드 ¶

Windows 7 이하 이거나, winget을 이용한 설치가 불가능한 경우 설치본을 다운로드 받아서 설치한다.

1.3. 설치 후 ¶

반드시 MiKTeX-Console을 한 번 실행하여 "업데이트"한다.
다음 프로그램을 설치해두면 훨씬 쾌적하게 작업할 수 있다.
1. StrawberryPerl: winget install StrawberryPerl.StrawberryPerl
2. Python + pygments: minted 패키지를 활용하기 위해서 필요하다. pygments는 pip install pygments 명령으로 설치한다.
3. SumatraPDF: winget install SumatraPDF.SumatraPDF
4. VS Code: 에디터로 Visual Studio Code를 권장한다.

2. 장단점 ¶

2.1. 장점 ¶

(texlive에 비교한 장점)

(그밖에)

2.2. 단점 ¶

외부 유틸리티를 전부 별도 설치해야 한다. (texlive는 perl과 GhostScript가 기본 설치된다)
- latexmk를 실행하려 해도 perl을 설치해야 함. 원활한 tex 작업을 위해서 perl, python, -~~ghostscript~~-, java jre 등을 일일이 하나하나 별도 설치해주어야 한다.
- pdfcrop을 실행하려 해도 perl을 설치하여야 한다. winget install -e --id "StrawberryPerl.StrawberryPerl" 의 명령으로 설치한다.
KTUG 사설저장소가 MiKTeX을 지원하지 않는다.
미러 서버가 동작하지 않거나 업데이트 중이면 mpm 운영에 곤란을 겪을 수 있다.

3. 운영상의 팁 ¶

미러 서버가 응답하지 않는 에러가 발생했을 때는 MiKTeX Console을 닫지 말고 서버를 다른 곳으로 바꾸어본다.
- MiKTeX Console -> Updates -> Retrieve from -> Change -> Next
KTUG 사설저장소 패키지가 필요하다면 한글과 MiKTeX 페이지를 참고.
mpm으로 자동 설치되지 않는 폰트의 경우: xetex/luatex 문서를 작성할 때 \setmainfont 등에 폰트의 "파일 이름"을 명시하면 자동 설치가 잘 동작한다. 예를 들면
```
\setmainfont{texgyretermes-regular.otf}
```
일단 설치된 후에는 "폰트 이름"으로 호출해도 된다. 또는, 강제로 설치하는 방법도 있다.
```
mpm --install tex-gyre
```
user local texmf 는 %userprofile%\AppData\Local\MikTeX 아래에 TDS 규칙에 맞게 ~~적당히~~ 만들어 넣고, MiKTeX Console 에서 디렉토리를 등록하면 된다. https://miktex.org/kb/texmf-roots 를 참조하라. [2]

4. 기타 ¶

한글 사용 관련 문제는 모두 해결되었다.
MiKTeX은 현재 Windows 이외에 Linux, Mac OS에서도 설치가 가능하다.
Dockerized MiKTeX이 있다. Debian Linux 기반에 MiKTeX을 설치한 상태의 docker image를 배포한다. MiKTeXDockerized 페이지 참조.
ktug:MiKTeX 인스톨 가이드 MiKTeX을 설치하고 VS Code로 작업 환경을 구축하는 데까지 설명하는 안내 문서.

5. 관련 페이지 ¶

----

MiKTeX

Contents