설치하기Windows/tlinstall

• TeXLive 이전 버전은 굳이 삭제하지 않아도 된다. 그러면 이전 연도 파일이 그대로 보존되면서 새로운 연도판이 설치된다. 예컨대 2022년판을 설치한 후 이를 삭제하지 않고 2023을 설치하면 C:\TeXLive\2022 폴더에 이전 연도 파일들이, C:\TeXLive\2023에 2023년 파일들이 보관되고 가장 최근에 설치한 것이 활성화된다.
• C:\TeXLive\texmf-local 폴더는 연도가 바뀌어도 그대로 유지된다.
• MiKTeX은 운용 방식이 전혀 다른 프로그램이므로 삭제할 것.

• 영미권에서 만들어진 많은 프로그램들은 알파벳이외의 글자에 대해서 오작동을 하는 경우를 종종 만난다. 그러므로 컴퓨터에서는 영어만 사용한다고 생각하고 쓰는 편이 좋다. 또한 사용자 이름도 철수, 영희 보다 Cheolsu, Yeonghui로 입력하는 편이 좋다. 그렇지 않은 경우, 질문게시판의 242049번 글 과 같은 경우를 만날 수 있다. 윈도우10 사용자 이름 바꾸는 방법 의 방법으로 사용자 이름을 바꿀 수도 있으나, 항상 잘된다고는 보장하기 어렵다.
• 자신의 사용자 이름에 한글이 포함되어 있는지 여부를 확인하려면 cmd (powershell 아님)를 열고 다음 명령을 실행해본다. 여기서 보이는 폴더 위치에 한글이 들어 있지 않아야 한다.

  echo %userprofile%
  

• 한글이 포함되어 있더라도 TeX Live를 설치할 수 없는 것은 아니다. 설치 자체는 TEMP 환경 변수를 일시적으로 변경하여 설치가 가능하다. | KTUG Q&A 게시물 참조.
• 설치에 성공했더라도 다음과 같은 문제를 만날 수 있다.
  1. 에디터와 뷰어 사이의 상호 바로가기(Forward / Inverse Search)가 동작하지 않는다.
  2. 사용자 권한으로 설치한 폰트를 XeLaTeX에서 사용할 수 없다.
  3. TeX Live 업데이트를 할 때 임시 화일 생성에 어려움이 생겨, 업데이트가 안될 수 있을 가능성도 있다.
• 따라서 사용자 이름이 한글인 경우에는 MiKTeX 설치를 고려해보는 것이 좋다.

• where.exe perl 명령을 실행하여 현재 설치된 perl의 위치를 확인한다. Strawberry Perl이 설치되어 있다면 설정->앱->설치된 앱에서 제거한다. (이 Perl이 반드시 필요하다면 TeXLive 설치 후 재설치한다.) winget으로 설치하였다면 winget uninstall StrawberryPerl.StrawberryPerl 명령을 주어서 삭제할 수 있다.
• 환경 변수 변경 사항을 활성화하기 위하여 로그아웃하였다가 다시 로그인한다.
• TeXLive 설치를 계속한다.
• 이 권고 사항은 스스로 해결할 수 있다면 적용할 필요 없다. 또한 Windows Perl 앱이 추후 버전업으로 문제가 해결될 가능성도 있다.

• 이 실행 파일은 두 단계로 실행된다. 먼저 설치에 필요한 파일의 압축을 풀고, 그 다음에 인스톨러를 실행하는 것이다. 각 단계는 자동으로 진행하므로 사용자가 할 일은 (인스톨러가 실행될 때까지) 기다리는 것이다.
• TeX Live 2021부터는 두 번째 단계, 즉 인스톨러가 실행될 때 CTAN mirror를 선택할 수 있게 되었다. Asia -> Korea를 찾아 들어가면 ktug, navercorp 등 몇몇 mirror의 목록이 나타난다. 되도록 ktug 서버를 선택하지 않는 것이 좋다.
• mirror를 지정하여 실행할 수 있다. 위의 목록에 나타나지 않는 미러 사이트를 지정하여 실행할 수 있다. 예를 들면 kakao.com의 미러는 목록에 없다. 다운로드 폴더에서 cmd를 열고 다음과 같이 명령을 내린다.

  install-tl-windows.exe --repository http://mirror.kakao.com/CTAN/systems/texlive/tlnet
  

  미러 사이트 주소는 아래 repository mirror 항목을 참조.
• Selected scheme이 scheme-full로 되어 있다. 원하는 것을 선택한다.
  • 시간이 오래 걸리더라도 scheme-full 설치하는 것이 사후관리를 위해서나 정신건강을 위해서나 좋다.
  • scheme full 설치가 망설여진다면 이 문서 9.1절 "small scheme으로 설치하기" 소절을 참고하라.

• 네트워크를 통하여 설치하는 것이므로 네트워크 사정에 따라 중간에 간간이 접속에 실패한 것같은 메시지가 나오지만 대부분 별 문제가 아니된다. 정말로 치명적인 오류가 발생하여 중단되었다면 처음부터 다시 한다.
• 패키지를 받아 오다가 속도가 느려져 중간에 끊기면서 설치가 종료되는 일이 종종 발생하고 있다. 이경우 다시 설치하거나, 좀 더 속도가 빨라 보이는 다른 서버를 찾아 보는 수 밖에 없다. 주로 졸업논문 작성 시즌에 발생하는 일로서, 접속량 증가에 따라 속도가 느려져 발생하는 일이므로 다른 대안을 찾기는 어렵다. 대안이라면 ISO화일을 받아서 설치하는 방법으로 해결한 경우도 종종 있다고 한다.

• 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에서 제공하는 미러를 사용하여도 된다.
  • JAIST :

    http://ftp.jaist.ac.jp/pub/CTAN/systems/texlive/tlnet/

> tlmgr repository add https://cran.asia/KTUG/texlive/tlnet ktug
> tlmgr pinning add ktug *
> tlmgr install ktugbin
> tlmgr install nanumttf hcr-lvt

• 참고사항 1: 수동설정시 참고할 점
  • cmd 프로그램 열기에 익숙하지 않으면, 명령창열기 참고.
  • 띄어쓰기와 대소문자에 주의한다. 특히 첫 줄 명령에서 마지막의 tlnet과 ktug 사이를 반드시 띄어야 한다.
  • pinning add 명령의 별표(*)는 "*"처럼 따옴표로 둘러싸서 입력할 수 있다.
  • Tip: 타이핑하면서 오타가 나는 경우가 있으므로, 복사-붙이기로 하면 편리하다.
    • 첫줄에서 tlmgr ... ktug를 복사하여 명령창에 붙이기한 후 엔터를 쳐서 실행하고
    • 차례로 다음 줄을 복사-붙이기 하여 실행해나가면 끝.
• 참고사항 2: 위의 수동설정 과정을 클릭 한 번으로 자동설정하는 방법
  • ko. TeX Live 설정 과정 전체 자동화 배치파일. tl-kotex-2019.zip (548 Bytes) (설치연도에 무관하게 실행 가능)
    • 위에 설명된 과정 중에서 texworks-config와 hcr-lvt 설치 과정은 제외함. (texworks-config는 사용자 취향에 따라 선택할 수 있도록, 그리고 hcr-lvt는 ktug 서버가 너무 느리기 때문에 시간 관계상.)
  • zip 파일을 풀면 나오는 배치파일을 실행. (TeX Live 설치가 완전히 종료된 후 실행)
  • cmd를 관리자 권한으로 여는 것이 필요할 수 있다.

> tlmgr update --all --self

• 텍라이브 매니저 자체가 업데이트 되지 않아 업데이트가 잘 동작하지 않을 수 있다. 이 경우 이 링크에서 update-tlmgr-latest.exe 파일을 받아 실행 후 업데이트를 다시 시도한다. (참고링크, KTUG게시판 191705글)
• 또는 Windows 메뉴 (찾기)에서] TeX Live Manager를 실행하여 업데이트할 수 있다.

> tlmgr remove <package>

• 프로그램 추가/제거에서 TeX Live 20XX를 삭제하고
• c:\usr\texlive 폴더를 직접 삭제
  • 참고: 이전에 설치된 버전을 제거하고 다음 연도 TeX Live를 설치하기 위해서라면 폴더 삭제는 하지 않아도 상관없다. 참고: TeXLiveUpdate

• install-tl-windows.exe를 다운로드받은 폴더에서 명령 프롬프트(cmd)를 연다. (powershell이 아님에 유의)
• 명령 프롬프트 상에서 다음 명령을 써넣는다.

  set LANG=C
  set LC_ALL=C
  

• 그런 다음 명령줄에 직접 다음 명령을 적어넣어서 설치 프로그램을 실행한다. 탐색기의 더블 클릭으로는 문제가 해결되지 않을 것이다.

  > install-tl-windows
  

• tlmgr로 업데이트 등을 시도할 때도 명령 프롬프트를 열고 LANG 설정한 다음 tlmgr을 실행하면 된다.

  > set LANG=C
  > set LC_ALL=C
  > tlmgr update --all --self
  

• windows key + R 을 누른후 cmd를 입력하고 enter를 누르면 DOS 시절과 같은 terminal 창이 뜬다.

• cmd에서 tlmgr update --all --self를 실행하거나
• TeX Live Manager를 실행하여 update