[[TableOfContents]]

== 장점과 단점 ==
=== 장점 ===
 1. MiKTeX 특유의 MPM 시스템 덕분에 작은 크기의 이미지만 설치하고도 이후의 작업에 지장이 없다. 패키지나 유틸리티가 필요해지면 스스로 다운로드받는다.
 1. 현재 MiKTeX (21.X)은 갱신이 빠르고 상당히 안정적이다. TeX Live와 큰 차이가 없다.
 1. texmf를 추가하여 운영할 수 있기 때문에 사용자 패키지를 활용하는 것이 가능하다. (KTUG 사설저장소 패키지들을 미리 설치해둔 후에 등록하여 쓸 수 있다.)
 1. Linux MiKTeX은 실행 속도에서도 만족스럽다.
 1. 호스트 운영체제가 무엇이든 상관없이 동일하게 동작한다.
 1. docker에서 돌아간다는 것이 장점이다. 
=== 단점 ===
 1. tlmgr이 없는 것은 단점이다. 그 결과 KTUG 사설저장소를 통합적으로 운용하지 못한다.
 1. MPM 다운로드가 서버 사정으로 동작하지 않을 가능성을 배제할 수 없다.
 1. docker에서 돌아간다는 것이 단점이다. 
   * Microsoft Windows는 docker를 돌리기 위해서 WSL2를 동작시킬 것이고, WSL2는 Hyper-V를 동작시킬 것이다. 이 경우 VMware, VirualPC등이 실행되지 않거나, 실행되더라도 자체 VM를 사용하지 못하고 Hyper-V에서 실행되므로 실행 속도등에서 손실이 많다고 알려져 있다.
== 설치 ==
 * miktex docker image {{{
docker pull miktex/miktex
}}}
   * miktex/miktex이 ARM 아키텍처를 제공하지 않는 듯한데, M1 Mac에서 Rosetta2로 어찌어찌 되는지 어떤지 해보지 않아서 모릅니다. 시도해보신 분은 추가바람.
 * build container {{{
docker run -ti \
  --name <unique_name> \
  -v miktex:/miktex/.miktex \
  -v <working_dir>:/miktex/work \
  miktex/miktex
}}}
    * ```<unique_name>```은 기억하기 쉬운 container 이름으로. (이하 ```mymiktex```으로 예를 들 것임.)
    * ```<working_dir>```는 host측 작업 디렉토리. Windows라면 ```C:/MyTeXWork```과 같은 방법으로 지정한다.
 * starting/stopping container {{{
docker start mymiktex
docker stop mymiktex
}}}
 * executing container {{{
docker exec -ti mymiktex /bin/bash
}}}
   * ```/bin/bash```를 실행하면 docker container 시스템 내부의 bash가 열린다. 이 시스템은 Debian Linux이다.
   * ```/bin/bash``` 대신 컴파일 명령을 줄 수 있다. ex) ```docker exec -ti mymiktex xelatex --shell-escape --synctex=1 mytex.tex```

== novadehi/miktexwktug ==
 * [http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=255839|소개글]
 * Dockerized MiKTeX에 [[KTUG Private Repository]]의 주요 패키지들과 미리 설정된 Emacs + Okular 작업 환경을 추가한 개인 배포 버전.
 * Windows 11, Linux, Mac OS에서 실행 가능하다.
 * Apple Silicon Mac을 위한 arm64 플랫폼의 MikTeX binary가 (아직) 없기 때문에 `--platform linux/amd64` 옵션을 주어서 (로제타를 경유하여) 실행하여야 한다. DeleteMe 확인요망.
 * 별도로 TeX 시스템과 에디터를 설치할 필요 없이 이 도커 이미지 하나로 TeX 사용환경을 설정할 수 있다.
=== 사용법 ===
==== 공통 ====
 아래 docker 명령은 `sudo`를 필요로 할 수 있음.
 1. 시작하기: {{{
$ docker pull novadehi/miktexwktug
}}}
 2. 볼륨 만들기 (처음 한 번만 하면 되고 볼륨은 docker로 관리 가능) {{{
$ docker volume create --name miktex
}}}
 3. 컴파일 명령으로 실행 (xelatex) {{{
$ docker -v miktex:/miktex/.miktex -v $(pwd):/miktex/work novadehi/miktexwktug xelatex <filename>.tex
}}}
==== Windows ====
 1. Windows 11 (build 22000) 필요. WSL 2 설정을 행한 다음 다음 순서로 진행한다.
   * ubuntu 설치 실행 {{{
> winget ubuntu
}}}
   * docker desktop 설치 실행 {{{
> winget "Docker Desktop"
}}}
 2. GUI 프로그램은 wsl 명령행에서 실행한다. {{{
# docker run -ti --rm \
   -v miktex:/miktex/.miktex \
   -v $(pwd):/miktex/work \
   -e DISPLAY=:0 \
   -v /tmp/.X11-unix:/tmp/.X11-unix \
   novadehi/miktexwktug emacs
}}}
 3. 윈도우즈 시스템 폰트를 컴파일에 사용하려면 다음 행을 추가한다. (wsl 명령행 기준) {{{
-v /mnt/c/Windows/Fonts:/root/.fonts/winfonts
}}}
 4. GUI Emacs 없이 컴파일러로만 사용하려면 cmd 명령행에서도 가능하다. 다만 `$(pwd)` 대신 현재 작업 디렉터리를 다음과 같은 형식으로 지정. {{{
 -v C:/Users/myname/Documents/texwork:/miktex/work
}}}
==== Mac OS ====
 1. XQuartz를 설치하고 Preferences에서 Security -> Allow connections from network clients 체크
 2. terminal에서 다음 명령을 한 번 실행 {{{
# xhost + localhost
}}}
 3. Emacs를 실행하는 명령 {{{
# docker run -ti --rm \
 -v miktex:/miktex/.miktex \
 -v $(pwd):/miktex/work \
 -e DISPLAY=host.docker.internal:0 \
 -v /tmp/.X11-unix:/tmp/.X11-unix \
 novadehi/miktexwktug emacs
}}}
    * `/tmp/.X11-unix` 부분은 없어도 된다.
==== Linux ====
 1. GUI를 위하여 다음 명령을 미리 실행해둔다. {{{
# xhost local:root
}}}
 2. Emacs 실행 {{{
# docker run -ti --rm \
 -v miktex:/miktex/.miktex \
 -v $(pwd):/miktex/work \
 -e DISPLAY
 -v /tmp/.X11-unix:/tmp/.X11-unix \
 novadehi/miktexwktug emacs
}}}
== Docker 운영 팁 ==
 * Windows는 Pro면 Hyper-V, Home이면 wsl2로 사용하는 것을 추천함.
=== Docker daemon 실행 방법 ===
 * Windows, Mac OS에서는 [https://www.docker.com/products/docker-desktop|Docker Desktop]을 이용하는 것이 제일 쉽다.
 * OpenSUSE의 경우, 다음과 같이. {{{
sudo systemctl start docker
}}}
 * Ubuntu에서는 {{{
sudo service docker start
}}}
=== 사용자에게 docker 그룹 권한 주기 (Linux) ===
{{{
sudo usermod -G docker -a <username>
}}}