Difference between r1.13 and the current
@@ -4,32 +4,43 @@
== Windows 설치 ==
=== 명령행 ===
Windows 10 이상의 OS인 경우 powershell 혹은 cmd 에서 {{{
winget install --id ChristianSchenk.MiKTeX
Windows 10 이상의 OS인 경우 powershell 혹은 cmd 에서 winget 명령을 써서 아래처럼 ID를 명확하게 알려주고 인스톨하는 것을 추천한다. {{{
winget install --exact --id MiKTeX.MiKTeX
}}} 귀찮으면 아래처럼 명령한다. {{{
winget install MiKTeX}}}
=== Installer 다운로드 ===
Windows 7 이하 이거나, winget을 이용한 설치가 불가능한 경우 설치본을 다운로드 받아서 설치한다.
* https://miktex.org/download
=== 설치 후 ===
* 반드시 MiKTeX-Console을 한 번 실행하여 "업데이트"한다.
* 다음 프로그램을 설치해두면 훨씬 쾌적하게 작업할 수 있다.
1. StrawberryPerl: {{{ winget install StrawberryPerl.StrawberryPerl }}}
2. Python + pygments: minted 패키지를 활용하기 위해서 필요하다. pygments는 {{{ pip install pygments }}} 명령으로 설치한다.
1. SumatraPDF: {{{ winget install SumatraPDF.SumatraPDF }}}
1. VS Code: 에디터로 [Visual Studio Code]를 권장한다.
=== 장점 ===
(texlive에 비교한 장점)
1. 설치/삭제가 매우 간단하다.
1. x64 바이너리
1. x64 바이너리[* TeXLive 2022까지 TeXLive는 x86용이며 x64는 별도로 설치하여야 한다.]
1. (texlive에 고질적인) 한글 사용자이름 설치 실패 문제가 없다.1. MiKTeX Console을 통한 관리가 Windows 친화적이다.
1. 한글 파일 이름, 경로명이 있더라도 synctex (inverse/forward search)가 동작한다.
1. 한글 파일 이름, 경로명이 있더라도 synctex (inverse/forward search)가 동작한다. (한글 폴더 및 파일 이름 사용)
1. XeTeX을 위해 "사용자 설치 폰트"에 대한 별도의 조치를 취할 필요가 없다. (폰트 설치시 "모든 사용자용으로 설치"를 강제하지 않음)
(그밖에)1. mpm (MiKTeX Package Manager)을 통한 실시간 패키지 설치/관리.
1. Windows 최고의 DVI 뷰어인 Yap이 탑재되어 있다.
1. texify 유틸리티
1. WinEdt 에디터가 MiKTeX을 잘 지원한다.
=== 단점 ===
1. 외부 유틸리티를 전부 별도 설치해야 한다. (texlive는 perl과 gs가 기본 설치된다)
1. 외부 유틸리티를 전부 별도 설치해야 한다. (texlive는 perl과 GhostScript가 기본 설치된다)
* latexmk를 실행하려 해도 perl을 설치해야 함. 원활한 tex 작업을 위해서 perl, python, ---ghostscript---, java jre 등을 일일이 하나하나 별도 설치해주어야 한다. 1. KTUG 사설저장소가 MiKTeX을 지원하지 않는다.
* pdfcrop을 실행하려 해도 perl을 설치하여야 한다. {{{ winget install -e --id "StrawberryPerl.StrawberryPerl" }}}의 명령으로 설치한다.
1. [[http://wiki.ktug.org/wiki/wiki.php/KtugPrivateRepository|KTUG 사설저장소]]가 MiKTeX을 지원하지 않는다.
1. 미러 서버가 동작하지 않거나 업데이트 중이면 mpm 운영에 곤란을 겪을 수 있다. == 운영상의 팁 ==
* 미러 서버가 응답하지 않는 에러가 발생했을 때는 MiKTeX Console을 닫지 말고 서버를 다른 곳으로 바꾸어본다.
@@ -41,10 +52,12 @@
일단 설치된 후에는 "폰트 이름"으로 호출해도 된다. 또는, 강제로 설치하는 방법도 있다. {{{
mpm --install tex-gyre
}}}
1. 한글 사용 관련 문제는 모두 해결되었다.
1. MiKTeX은 현재 Windows 이외에 Linux, Mac OS에서도 설치가 가능하다.
1. Dockerized MiKTeX이 있다. Debian Linux 기반에 MiKTeX을 설치한 상태의 docker image를 배포한다. [MiKTeXDockerized] 페이지 참조.
* [http://faq.ktug.org/faq/MiKTeX KTUGFaq:MiKTeX] 2007년 이후 업데이트되지 않음.
* [wiki:HangulAndMiKTeX 한글과 MiKTeX]
mpm --install tex-gyre
}}}
* [http://wiki.ktug.org/wiki/wiki.php/LocalTexmfTree|user local texmf] 는 %userprofile%\AppData\Local\MikTeX 아래에 [http://faq.ktug.org/faq/TDS|TDS] 규칙에 맞게 ~~적당히~~ 만들어 넣고, MiKTeX Console 에서 디렉토리를 등록하면 된다. https://miktex.org/kb/texmf-roots 를 참조하라. [* MiKTeX의 FAQ를 보면, TeXLive의 Local texmf tree를 등록하여 써도 될 것으로 보인다.]
== 기타 ==1. 한글 사용 관련 문제는 모두 해결되었다.
1. MiKTeX은 현재 Windows 이외에 Linux, Mac OS에서도 설치가 가능하다.
1. Dockerized MiKTeX이 있다. Debian Linux 기반에 MiKTeX을 설치한 상태의 docker image를 배포한다. [MiKTeXDockerized] 페이지 참조.
1. [http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=262108|ktug:MiKTeX 인스톨 가이드] MiKTeX을 설치하고 VS Code로 작업 환경을 구축하는 데까지 설명하는 안내 문서.
== 관련 페이지 ==* [http://faq.ktug.org/faq/MiKTeX KTUGFaq:MiKTeX] 2007년 이후 업데이트되지 않음.
* [wiki:HangulAndMiKTeX 한글과 MiKTeX]
윈도(MS Windows)에서 가장 유명한 TeX Implementations의 하나.
1.1. 명령행 ¶
Windows 10 이상의 OS인 경우 powershell 혹은 cmd 에서 winget 명령을 써서 아래처럼 ID를 명확하게 알려주고 인스톨하는 것을 추천한다.
winget install --exact --id MiKTeX.MiKTeX귀찮으면 아래처럼 명령한다.
winget install MiKTeX
2.1. 장점 ¶
2.2. 단점 ¶
- 외부 유틸리티를 전부 별도 설치해야 한다. (texlive는 perl과 GhostScript가 기본 설치된다)
- latexmk를 실행하려 해도 perl을 설치해야 함. 원활한 tex 작업을 위해서 perl, python, -
ghostscript-, java jre 등을 일일이 하나하나 별도 설치해주어야 한다. - pdfcrop을 실행하려 해도 perl을 설치하여야 한다.
winget install -e --id "StrawberryPerl.StrawberryPerl"
의 명령으로 설치한다.
- latexmk를 실행하려 해도 perl을 설치해야 함. 원활한 tex 작업을 위해서 perl, python, -
- 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. 관련 페이지 ¶
- KTUGFaq:MiKTeX 2007년 이후 업데이트되지 않음.
- 한글과 MiKTeX
- Dockerized MiKTeX