기타 유틸리티

차례: Windows에서 MiKTeX 시작하기
  1. 개요
  2. 준비하기
  3. MiKTeX 설치
  4. TeXworks 설정
  5. 첫 문서 작성하기
  6. 폰트 설치
  7. KTUG 사설저장소 패키지
  8. Visual Studio Code 사용하기
  9. lshort-ko를 읽자
  10. 기타 유틸리티
  11. KTUG 사설저장소 추가 설정

Python과 latexminted

MiKTeX에서 Python이 필요한 이유는 주로 latexminted라는 유틸리티 때문입니다. minted 패키지로 소스코드리스팅을 하는 경우에 이 유틸리티의 도움이 필요합니다. (참고로, latexminted를 설치하면 pygments 패키지도 함께 설치해줍니다. TeX Live와 달리 MiKTeX은 이 유틸리티들을 별도로 설치하여야 합니다.)

Python도 터미널에서 winget으로 설치할 수 있습니다. 다른 목적으로 Python을 이용하는 경우가 아니고 오로지 이 안내서의 상황만을 고려한다면, 다음과 같은 명령을 내리면 됩니다.

winget install Python.Python.3.13

설치 후에 터미널을 한 번 닫았다가 열어줍니다. 그리고 다음 명령을 다시 내립니다.

pip install latexminted

참고 만약 이 단계에서 pip라는 명령이 없다고 하면서 실행되지 않으면 Python이 설치된 폴더를 PATH 환경 변수에 추가하여야 하는데, 이 문제는 일반적으로 winget으로 설치한 경우에 발생하지 않을 것입니다.

참고 minted 패키지가 사용된 문서는 -shell-escape라는 옵션을 붙여서 컴파일하여야 합니다.

참고 pip로 설치한 스크립트의 실행 위치가 Path에 포함되어 있지 않다면 이를 수동으로 등록해주어야 합니다. 예를 들면 C:\Users\<username>\AppData\Roaming\Python\Python313\Scripts와 같은 주소를 사용자 PATH에 추가하여야 합니다.

VS Code의 외부 뷰어

VS Code의 PDF Viewer를 (내장 뷰어가 아니라) SumatraPDF라는 외부 유틸리티로 설정하려면 다음과 같이 합니다.

SumatraPDF 설치

터미널에서 다음 명령을 내립니다.

winget install SumatraPDF.SumatraPDF

참고 SumatraPDF는 웹페이지로부터 다운로드하여 설치할 수 있습니다. 이 경우에는 설치 위치와 권한을 지정할 수 있는데, 이 안내서는 그렇게 설치된 경우를 고려하지 않습니다.

외부 뷰어 설정

내장 뷰어는 화면이 좁은 경우에 에디터의 일부를 차지하게 되어 답답한 느낌이 들 때가 있고 그외에도 몇 가지 불만스러운 점이 있어서 SumatraPDF라는 pdf 뷰어를 설치하고 이를 외부 뷰어로 활용하는 것이 좋을 때가 있습니다.

그러므로, 만약 외장 뷰어가 자신이 원하는 바가 아니고 내장 뷰어로 충분하다면 이 절의 내용은 무시해도 좋으며, 혹시 이 설정이 뜻대로 되지 않는다고 해도 그냥 내장 뷰어를 쓰면 되는 것입니다.

이를 위하여, 한 가지 확인하여야 할 것이 있습니다. 그것은 자신의 이름입니다. 터미널을 열었을 때 프롬프트에 표시되는 자신의 이름을 확인합니다. 예를 들어 프롬프트가 대략 다음과 같다면

C:\Users\sungguri>

자신의 이름은 sungguri인 것입니다.

참고 터미널 명령행에서 echo %userprofile% 명령을 내리면 자신의 홈 폴더 위치를 출력합니다. 이것으로 자신의 홈 폴더와 “이름”을 확인할 수 있습니다.

Ctrl+Shift+P로 명령 팔레트를 연 다음 “사용자 설정 열기(JSON)”을 선택하여 설정 편집 상태로 들어갑니다. 여기에 다음 내용을 복사하여 넣습니다.

그리고 C:/Users/sungguri 부분을 자신의 “이름”으로 바꾸어 넣습니다. 예컨대 이름이 chunhyang이라면

C:/Users/chunhyang/AppData/....

와 같은 모양이 되게 해야 합니다. 이렇게 고쳐야 할 곳이 두 곳 있습니다.

"latex-workshop.view.pdf.viewer": "external",
"latex-workshop.view.pdf.external.synctex.command": "C:/Users/sungguri/AppData/Local/SumatraPDF/SumatraPDF.exe",
"latex-workshop.view.pdf.external.synctex.args": [
    "-forward-search",
    "%TEX%",
    "%LINE%",
    "-reuse-instance",
    "-inverse-search",
    "code.cmd -r -g \"%f:%l\"",
    "%PDF%"
],
"latex-workshop.view.pdf.external.viewer.command": "C:/Users/sungguri/AppData/Local/SumatraPDF/SumatraPDF.exe",

설정 저장 후 VS Code를 재실행합니다.

SyncTeX

SyncTeX이란 편집기와 PDF Viewer 사이에서 원하는 위치로 이동하는 것입니다. 이 상태에서 Ctrl+Alt+V를 누르면 SumatraPDF가 열려야 합니다.

참고 기존에 SumatraPDF가 열려 있지 않은 것이 좋습니다.

SumatraPDF의 특정한 위치에서 더블 클릭해봅니다. 그러면 (잠깐 검은 화면이 뜨면서) 편집기 상의 커서 위치가 PDF에서 클릭한 위치에 해당하는 곳으로 이동하여야 합니다.

이번에는 에디터의 특정한 행(예를 들면 800행)에 커서를 두고 Ctrl+Alt+J를 눌러봅니다. 열려 있는 SumatraPDF에서 화면 이동이 일어나면서 잠깐 파랗게 위치를 보여줄 것입니다.

arara와 Java Runtime

arara 유틸리티를 사용하려면 Java Runtime이 설치하여야 합니다. 이 안내서는 이에 대하여 더 상세히 다루지 않습니다.

다음 단계

기타 유틸리티 설치가 완료되었습니다. 필요에 따라 KTUG 사설저장소 추가 설정을 참고하세요.