MiKTeX의 설치에 대해서는 MiKTeX 페이지를 참조.

이 페이지에서 논의되고 있던 "MiKTeX에서 한글 사용상의 여러 문제"들은 2022년 현재 모두 해결되었다. 따라서 해당 내용을 삭제한다. 어떤 문제점들이 지적되고 있었는지는 이 문서의 r1.31 이전 버전(http://wiki.ktug.org/wiki/wiki.php/HangulAndMiKTeX?action=recall&rev=1.31)을 참고하라.

MiKTeX을 사용할 때의 유일한 단점은 KTUG 사설저장소를 활용할 수 없다는 것이다. 이에 KTUG private repository를 사용하는 방법을 설명한다.

KTUG 사설저장소 패키지의 활용 ¶

제3자 기여 방식으로 이 문제를 해결할 수 있다.

필요성 ¶

영어 문서만 작성하거나 일반적인 상황에서는 설치할 필요 없다.
EUC-KR 인코딩의 한글 문서를 지원하는 kotex-euc가 필요하다면 이 패키지를 설치하여야 한다.
KTUG에서의 토론 중에 등장하는 샘플 파일을 컴파일하기 위하여 필요할 때가 있다.
몇 가지 요긴한 패키지를 활용하는 것이 가능하다.

적용 순서 ¶

압축 파일을 다운로드한다. 외부링크(http://mirror.doeun.kr/texlive/texmf-kpr.zip) (약 195M)
- (현재 버전): 2024-11-12
- (이전 버전): 2024-09-29
- (더 이전 버전): 2024-06-26
- (더 이전 버전): 2024-06-16
다운로드한 파일을 적당한 곳에 압축을 푼다. 권장하는 위치는 c:\usr을 만들고 이곳에 가져다둔 다음 여기서 해동하는 것이다. 이렇게 하면 c:\usr\texmf-kpr 폴더 아래에 압축이 풀린다.
cmd 또는 Terminal을 열고 다음 명령을 실행한다. (> 기호는 프롬프트를 의미하므로 직접 써넣는 것이 아니다. 압축을 푼 위치는 각자의 사정에 맞게 하라. 만약 빈 칸이 있는 위치에 압축을 풀었다면 따옴표로 감싸준다.)
```
> initexmf --register-root=C:\usr\texmf-kpr
> initexmf -u
```
updmap 설정 파일 편집 (중요): 커맨드 창에서 다음 명령을 실행한다.
```
> initexmf --edit-config-file updmap
```
그러면 Notepad가 열리면서 주석문 한 줄 있는 상태가 될 것이다.여기에 다음 내용을 적어넣고 저장한다.
```
Map unfonts-base.map
Map unfonts-other.map
Map nnmbrfonts.map
Map kotex-midkor.map
```
6 저장 후에 다음 명령을 실행한다.
```
> updmap
```

폰트 ¶

c:\usr\texmf-kpr\fonts\truetype 아래에 두 종류의 트루타입 폰트가 있다. 함초롬 LVT와 나눔 트루타입이다.
해당 디렉터리로 들어가서 윈도우즈에 설치한다.

komkindex arara rule ¶

arara에서 komkindex를 지시하기 위해서는 다음 절차가 필요하다.
1. c:\usr\texmf-kpr\scripts\arara\rules 폴더에 있는 arara-rule-komkindex.yaml 파일을 확인한다.
2. MiKTeX이 패키지를 설치하는 위치를 확인한다. winget으로 설치하였거나 인스톨러로 설치할 때, Installation Scope 단계에서 only for me로 설치(default)하였다면 다음 위치를 확인하라.
  - C:\Users\<username>\AppData\Local\Programs\MiKTeX\scripts\arara\rules
3. (1)에서 확인한 arara-rule-komkindex.yaml 파일을 (2)의 위치로 복사한다.
4. 명령행을 열고 initexmf -u를 한번 실행한다.
5. 만약 MiKTeX Console이 뭔가 불평하면 로그아웃하였다가 로그인한다.
이후 다음과 같은 문법으로 사용할 수 있다.
```
% arara: komkindex: { koreanfirst: yes, style: kotex }
```

자주 묻는 질문 ¶

업데이트는 어떻게 하나요?
- (답) 기존에 설치해 둔 폴더 texmf-kpr을 그냥 지우고, 새로 zip 파일을 다운로드하여 같은 위치에 푸십시오. 그 다음에 initexmf -u 또는 miktex fndb refresh를 한번 실행합니다. (지우지 않고 같은 위치에 풀어도 안 되는 건 아닌데 자잘한 파일이 많아서 덮어쓰는 데 시간이 걸릴 수도 있습니다. 그냥 날리는 게 좋습니다.)
texmf-kpr 안에 있는 문서를 texdoc으로 읽을 수 없나요?
- (답) KTUG 게시판 262108(http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=262108) 대화의 끝부분 정도에 소개되어 있는 kstexdoc(https://mirror.ischo.org/aux/ksminitex/kstexdoc.7z)을 이용하면 가능합니다. 예를 들어 koredumath의 문서를 읽으려면 kstexdoc koredumath.

Tags: