이 페이지는 네트워크(인터넷)를 통한 설치 방법을 설명한다. 네트워크 안정성을 확신할 수 없다면,
isoimage를 통한 설치 방법을 고려해보라. 이 페이지에서 설명하는 방법과 큰 차이는 없으나 설치에 필요한 모든 파일을 미리 다운로드받은 다음에 시도하는 것이므로 실패할 가능성이 훨씬 적다.
- 일반적인 상황은 아니나, 일부 Windows에서
C:\Windows\System32
폴더가 PATH 변수에 포함되어 있지 않은 경우가 있다. 설치 프로그램이 cmd.exe
를 부르기 때문에 이 폴더가 PATH에 포함되어 있을 것이 필수적이다. 만약 설치 후에 fmt를 만드는 데 실패한다면 십중팔구 이 문제일 것이므로 확인이 필요하다.
- MiKTeX이나 TeXLive 이전 버전이 설치되어 있다면 프로그램 추가/삭제에서 지운다.
- TeXLive 이전 버전은 굳이 삭제하지 않아도 된다. 그러면 이전 연도 파일이 그대로 보존되면서 새로운 연도판이 설치된다. 예컨대 2022년판을 설치한 후 이를 삭제하지 않고 2023을 설치하면 C:\TeXLive\2022 폴더에 이전 연도 파일들이, C:\TeXLive\2023에 2023년 파일들이 보관되고 가장 최근에 설치한 것이 활성화된다.
- C:\TeXLive\texmf-local 폴더는 연도가 바뀌어도 그대로 유지된다.
- MiKTeX은 운용 방식이 전혀 다른 프로그램이므로 삭제할 것.
- 윈도우즈 사용자 이름을 영문자와 숫자만으로 한다.
- 영미권에서 만들어진 많은 프로그램들은 알파벳이외의 글자에 대해서 오작동을 하는 경우를 종종 만난다. 그러므로 컴퓨터에서는 영어만 사용한다고 생각하고 쓰는 편이 좋다. 또한 사용자 이름도 철수, 영희 보다 Cheolsu, Yeonghui로 입력하는 편이 좋다. 그렇지 않은 경우, 질문게시판의 242049번 글(http://www.ktug.org/xe/index.php?document_srl=242049) 과 같은 경우를 만날 수 있다. 윈도우10 사용자 이름 바꾸는 방법 (https://answers.microsoft.com/ko-kr/windows/forum/all/%ec%9c%88%eb%8f%84%ec%9a%b010/16602844-2334-4195-975d-d968ae129e4c)의 방법으로 사용자 이름을 바꿀 수도 있으나, 항상 잘된다고는 보장하기 어렵다.
- 자신의 사용자 이름에 한글이 포함되어 있는지 여부를 확인하려면 cmd (powershell 아님)를 열고 다음 명령을 실행해본다. 여기서 보이는 폴더 위치에 한글이 들어 있지 않아야 한다.
echo %userprofile%
- 한글이 포함되어 있더라도 TeX Live를 설치할 수 없는 것은 아니다. 설치 자체는 TEMP 환경 변수를 일시적으로 변경하여 설치가 가능하다. | KTUG Q&A(http://www.ktug.org/xe/index.php?document_srl=252433&mid=KTUG_QnA_board) 게시물 참조.
- 설치에 성공했더라도 다음과 같은 문제를 만날 수 있다.
에디터와 뷰어 사이의 상호 바로가기(Forward / Inverse Search)가 동작하지 않는다.
- 사용자 권한으로 설치한 폰트를 XeLaTeX에서 사용할 수 없다.
- TeX Live 업데이트를 할 때 임시 화일 생성에 어려움이 생겨, 업데이트가 안될 수 있을 가능성도 있다.
- 따라서 사용자 이름이 한글인 경우에는 MiKTeX 설치를 고려해보는 것이 좋다.
- 아래 "문제상황 목록"에 보면 Perl이 이미 설치되어 있는 경우의 예상되는 문제 상황에 대한 설명이 있다. 이 절차가 번거로우므로 TeXLive를 처음 설치하고 TeX과 Perl에 대하여 잘 안다고 자신하지 않는 일반 사용자라면, TeXLive 설치 과정에서 Perl을 일시적으로 무력화해두는 것이 편리하다.
where.exe perl
명령을 실행하여 현재 설치된 perl의 위치를 확인한다. Strawberry Perl이 설치되어 있다면 설정->앱->설치된 앱에서 제거한다. (이 Perl이 반드시 필요하다면 TeXLive 설치 후 재설치한다.) winget으로 설치하였다면
winget uninstall StrawberryPerl.StrawberryPerl
명령을 주어서 삭제할 수 있다.
- 환경 변수 변경 사항을 활성화하기 위하여 로그아웃하였다가 다시 로그인한다.
- TeXLive 설치를 계속한다.
- 이 권고 사항은 스스로 해결할 수 있다면 적용할 필요 없다. 또한 Windows Perl 앱이 추후 버전업으로 문제가 해결될 가능성도 있다.
- 설치 프로그램 파일 install-tl-windows.exe(http://mirror.navercorp.com/CTAN/systems/texlive/tlnet/install-tl-windows.exe)를 다운로드받는다.
- 실행한다.
- Install TeXLive 버튼을 누르고 기다린다.
- 네트워크를 통하여 설치하는 것이므로 네트워크 사정에 따라 중간에 간간이 접속에 실패한 것같은 메시지가 나오지만 대부분 별 문제가 아니된다. 정말로 치명적인 오류가 발생하여 중단되었다면 처음부터 다시 한다.
- 패키지를 받아 오다가 속도가 느려져 중간에 끊기면서 설치가 종료되는 일이 종종 발생하고 있다. 이경우 다시 설치하거나, 좀 더 속도가 빨라 보이는 다른 서버를 찾아 보는 수 밖에 없다. 주로 졸업논문 작성 시즌에 발생하는 일로서, 접속량 증가에 따라 속도가 느려져 발생하는 일이므로 다른 대안을 찾기는 어렵다. 대안이라면 ISO화일을 받아서 설치하는 방법으로 해결한 경우도 종종 있다고 한다.
2.1. repository mirror ¶
- KTUG에서도 CTAN을 미러하고 있으나 서버의 대역폭이 좁아서 ftp.ktug.org로부터 TeX Live를 설치하면 20시간 정도 걸릴 수 있다. 그러므로 다른 미러 사이트를 사용하는 것을 권한다.
- 다음은 현재 알려진 국내의 미러 사이트 주소이다. 다음 주소는
--repository
옵션 다음에 적어주면 된다.
- install-tl-windows.bat --repository URL 의 명령으로 설치간 필요한 패키지를 받아올 repository를 지정할 수 있다. 현재 한국내에서 사용가능한 곳과 설치 명령은 아래와 같다.
- 카카오(다음):
http://mirror.kakao.com/CTAN/systems/texlive/tlnet/
- 네이버 주식회사 :
http://mirror.navercorp.com/CTAN/systems/texlive/tlnet/
- harukasan :
http://ftp.harukasan.org/CTAN/systems/texlive/tlnet/
- Yongbok.net:
http://mirror.yongbok.net/ctan/systems/texlive/tlnet/
- CRAN (Comprehensive R Archive Network) mirror, 동아시아 권역 (0-Cloud-East-Asia)
https://cran.asia/tex/systems/texlive/tlnet/
(2020-07-29부터)
- KAIST :
http://ftp.kaist.ac.kr/tex-archive/systems/texlive/tlnet/
- KTUG : 살아 있지만 매우 느리다.
http://ftp.ktug.org/tex-archive/systems/texlive/tlnet/
- 물론 URL에 다른 곳을 넣어도 된다. 예를 들어 JAIST에서 제공하는 미러를 사용하여도 된다.
3. 설치 종료 후 ¶
- 가장 안전한 것은 시스템을 한 번 리부팅해주거나 로그아웃했다가 다시 로그인하는 것이다. 그렇지 않다면 적어도 실행중인 모든 프로그램을 다 중단했다가 다시 실행하라.
- 설치 종료 후
tlmgr update --all --self
를 한번 실행할 것을 권장한다.
5. 사용자 환경 만들기 ¶
- TeX Live를 설치하면 TeXworks 에디터를 바로 사용할 수 있다. pdf viewer를 내장한 에디터이다.
- 설치한 패키지만 삭제하려 하는 경우
> tlmgr remove <package>
- TeX Live 전체 삭제
- 프로그램 추가/제거에서 TeX Live 20XX를 삭제하고
- c:\usr\texlive 폴더를 직접 삭제
- 참고: 이전에 설치된 버전을 제거하고 다음 연도 TeX Live를 설치하기 위해서라면 폴더 삭제는 하지 않아도 상관없다. 참고: TeXLiveUpdate
8. 발생 가능한 문제상황 목록 ¶
- 일부 바이러스 진단 프로그램이 TeX Live 2016에 대하여 바이러스로 진단하는 경우가 있다고 한다. 대부분은 오진일 가능성이 높다.
- 일부 바이러스 진단 프로그램이 TeX Live 2016의 실행을 방해하는 경우가 있다. 바이러스 진단 프로그램의 실행을 잠시 중단하고 설치하는 수밖에 없다. 대부분의 잘 알려진 바이러스 진단 프로그램은 이런 동작을 보이지 않는다. (바이러스 진단 프로그램을 종료하고 설치할 것을 권한다.)
- perl.exe 에러(http://www.ktug.org/xe/194549)
- Can't spawn "cmd.exe"(http://www.ktug.org/xe/192172)
- biber.win32 설치중 중단(http://www.ktug.org/xe/191679)
- 패키지 다운로드 중 설치가 멈추는 경우(http://www.ktug.org/xe/index.php?document_srl=226539)
- 네트웍 상태가 나빠서 설치가 어려운 경우, iso를 다운로드 받아서 설치하는 것이 편리할 수도 있다. 이방법은 위의 다른 방법 항을 참조한다.
- 한글 문서를 XeLaTeX으로 컴파일 시 시간이 오래 걸리는 경우 설치 후 ko.TeXLive 설정 부분을 수행하지 않은 경우 한글 문서를 XeLaTeX으로 컴파일 시 시간이 오래 걸릴 수 있다. 이 경우 ko.TeXLive 설정을 참고하여 nanumttf를 설치하여 해결할 수 있다.
Locale 'Korean_Korea.949' is unsupported
메시지가 나오면서 설치가 진행되지 않는 문제가 보고되었다. KTUG 게시판 268453(http://www.ktug.org/xe/index.php?document_srl=268453&mid=KTUG_QnA_board) 이 문제는 시스템에 이미 다른 Perl이 설치되어 있고 그 Perl이 Locale을 설정해두었는데 TeXLive 설치 스크립트가 이를 이해하지 못하기 때문에 발생하는 일로 보인다. 다음과 같이 설치를 시도한다.
9.1. small scheme으로 설치하기 ¶
- 이 문서는 TeX Live를 전체 설치(full scheme)하는 것을 기준으로 서술하고 있으나 이것은 시간이나 용량 면에서 부담스러울 수 있다. 따라서 설치 시에
Advanced
버튼을 눌러서 설치 옵션을 medium이나 small을 선택하고 운영 시에 필요한 패키지를 추가해가면서 활용하는 방법이 있다.
- 이 방법에 대해서는 KTUG게시판(http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=262768)의 관련 글을 참고하라.
9.2. 환경 변수의 확인 ¶
개인이 설치한 폰트나 매크로를 위한 디렉토리는 아래의 명령으로 확인할 수 있다.
- kpsewhich --var=value=TEXMFHOME : 혼자만 사용하는 글꼴, 매크로등을 설치할 위치
- kpsewhich --var=value=TEXMFLOCAL : TeX Live로 설치되지 않았으나, system안에서 함께 사용할 글꼴, 매크로등을 설치할 위치
9.3. exe 대신 설치 압축파일을 이용하는 방법 ¶
- 위의 설치 exe는 압축을 풀고 install-tl-windows.bat라는 배치파일을 실행하는 일을 하는 파일이다. 이 과정을 수동으로 할 수 있다.
- http://mirror.navercorp.com/CTAN/systems/texlive/tlnet/install-tl.zip 다운로드
- 압축을 풀고 intall-tl-YYYYMMDD라는 폴더로 들어간다.
- command 명령창을 연다
- windows key + R 을 누른후 cmd를 입력하고 enter를 누르면 DOS 시절과 같은 terminal 창이 뜬다.
- install-tl-windows.bat 를 입력하고 실행한다.
설치되는 디렉토리를 기본값에서 바꾸어 설치할 필요가 있을 수도 있다. 위의 항목 "미러 사이트"를 참고하여 가까운 서버를 지정하자.
- 커맨드창 실행 시 GUI가 안 뜨고 바로 goodbye로 꺼지는 경우(오류메시지: cmd.exe를 찾을 수 없다고 함)가 있는데, 윈도우 환경에서 시스템 속성 > 환경 변수의 시스템 변수 'Path'에 C:\Windows\system32; 를 추가하면 된다.
9.4. 64bit binaries ¶
- TeXLive 2023부터 windows binaries는 x64이다. win32는 더이상 제공하지 않는다.
- (권현우, 2017)(https://youtu.be/V1Q6vEuoAQ0)
- (허혁재, 2020)(https://www.youtube.com/watch?v=u2Xi6v6iZaM&list=PL9GgNvw43lhJbF0wu6GHuvP8rBMgKuarr&index=1)
11. 이전(전년도) 버전으로부터 업그레이드 ¶
- 매년 TeXLive는 새 버전이 나온다. 매년 새로이 설치하는 것도 한 가지 방법이다.
- 이전 년도에 설치된 상태를 그대로 두고 버전을 새 년도의 것으로 업그레이드 하려면 다음과 같이 한다. 이 때에는 설치 위치의 연도 표시가 처음 설치된 연도(예: c:\texlive\2019)를 그대로 유지한다. 그러나 시스템 자체는 새 연도 버전으로 바뀐다. 설치 연도를 새 연도로 고치고 싶으면 새로 설치한다.
- |update-tlmgr-latest.exe(http://mirror.navercorp.com/CTAN/systems/texlive/tlnet/update-tlmgr-latest.exe)를 다운로드 받는다.
- 실행한다.
- 실행이 끝난 후에 시스템 전체를 업데이트한다.
- cmd에서
tlmgr update --all --self
를 실행하거나
- TeX Live Manager를 실행하여 update
12. 이 문서를 수정하시는 분께 드리는 말씀 ¶
wiki에서
URLs의 문법이 다른 점에 주의 바랍니다.
[:koTeXLive ko.TeX Live]
로 적으시면 안되고
[koTeXLive ko.TeX Live]
로 적으셔야 합니다. 혹은
[wiki:명령창열기]
과 같은 문법도 검토하시길 바랍니다.