LaTeX 엔진과 패키지
Tectonic 또는 latexmk 컴파일러를 고르고, 기존 TeX 배포판을 사용하거나, Oleafly가 관리하는 TinyTeX를 설치합니다.
Oleafly에는 Tectonic이 들어 있고, latexmk를 통해 컴파일할 수도 있습니다. 일상적인 빌드는 프로젝트 컴파일러 메뉴가 제어합니다. 설정 → 엔진에는 이 컴퓨터에서 사용할 수 있는 TeX 배포판과 패키지가 표시됩니다.
Tectonic: 일상적으로 쓰는 엔진
섹션 제목: “Tectonic: 일상적으로 쓰는 엔진”Tectonic은 설정 → 엔진 → LaTeX의 기본 컴파일 엔진에서 다른 것을 고르기 전까지 기본 컴파일 엔진입니다. 별도 설치가 필요 없고, 필요할 때 패키지를 가져오며, 오프라인에서 쓸 수 있도록 캐시합니다. 대부분의 프로젝트에 잘 맞으며, 시스템 TeX 배포판이 설치되어 있지 않아도 쓸 수 있습니다. 새 프로젝트의 기본값 설정을 참고하세요.
태그된 PDF에는 LuaLaTeX 작업 흐름을 사용하세요. 태그는 보조 기술이 쓸 수 있도록 문서 구조를 기술합니다. 컴파일한 뒤 프리플라이트로 결과를 확인하세요.
내장 엔진의 글꼴
섹션 제목: “내장 엔진의 글꼴”Tectonic은 글꼴 파일을 직접 읽는 XeTeX를 바탕으로 합니다. pdfLaTeX용으로 쓴 문서가 글꼴과 텍스트를 그대로 유지하도록 Oleafly가 몇 가지를 조정합니다.
-
Times, Helvetica, Courier, Palatino, Bookman, New Century Schoolbook, Avant Garde는 Latin Modern으로 대체되지 않고 각각의 TeX Gyre 버전을 씁니다.
-
\usepackage[T1]{fontenc}는 이 엔진에서 입력한 악센트와 기호를 깨뜨리므로, Oleafly는 문서를 유니코드 텍스트로 유지합니다. 문서가 쓰는 글꼴이 T1에만 있으면 문서는 T1에 머무르며, ß, §, «, 둥근 따옴표, €와 같은 문자가 잘못 인쇄되거나 사라질 수 있다고 컴파일이 경고합니다. 이 경고는 pdfLaTeX에서만 T1을 불러오는 형태의 줄을 알려 줍니다.\usepackage{iftex}\ifPDFTeX\usepackage[T1]{fontenc}\fi -
arXiv가 요구하는 대로
\pdfoutput=1을 설정한 문서는 그대로 컴파일됩니다. -
fontset을 지정하지 않은ctex문서는 Fandol 글꼴을 받으므로 어느 컴퓨터에서나 똑같이 보입니다. Mac 자체 글꼴을 쓰려면 클래스 옵션에fontset=mac을 추가하세요. -
내장 엔진에 포함된 글꼴은 파일 이름으로 찾습니다.
\setmainfont{UnBatang}은 실패하며, 오류 메시지가 대신UnBatang.ttf라고 쓰라고 알려 줍니다.
오프라인 모드에서는 글꼴과 인코딩 조정을 건너뛰므로, 이런 문서를 오프라인에서 빌드하면 온라인에서 빌드한 결과와 다르게 보일 수 있습니다.
latexmk와 시스템 TeX
섹션 제목: “latexmk와 시스템 TeX”프로젝트가 전통적인 TeX Live나 MiKTeX 작업 흐름에 의존한다면 프로젝트의 컴파일러 메뉴에서 pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX 중 하나를 고르세요. Oleafly는 이 컴파일러들을 latexmk로 실행합니다. 자동은 메인 파일을 읽고 하나를 고릅니다. 맨 위의 % !TeX program = xelatex 줄이 가장 우선하고, 그다음이 일본어 클래스이며, 그다음이 fontspec, ctex, xeCJK, luatexko처럼 XeLaTeX이나 LuaLaTeX이 필요한 패키지입니다. 메인 파일만으로 정해지지 않으면 자동은 프로젝트의 latexmkrc와 프리앰블이 불러오는 파일도 확인합니다. 그 밖에는 모두 pdfLaTeX을 씁니다. 자동이 고른 컴파일러와 다른 컴파일러가 패키지에 필요하면 컴파일이 전환을 제안하며, 예를 들어 XeLaTeX 사용 같은 버튼이 나타납니다.
이 툴체인을 마련하는 방법은 두 가지입니다.
- 기존 설치를 사용합니다. Oleafly는 시스템의 MacTeX, TeX Live, MiKTeX, TinyTeX를 감지합니다. 터미널이 쓰는 것과 같은
PATH를 살피고, Windows에서는 시스템과 사용자의Path설정도 살피므로, 직접 설치한 TeX는 앱을 Dock이나 시작 메뉴에서 열었더라도 찾아냅니다. 시스템 설치는 바이너리 디렉터리에latexmk, pdfLaTeX, XeLaTeX, LuaLaTeX,kpsewhich, Biber가 모두 있을 때만 Oleafly가 관리하는 사본보다 우선합니다. 일부만 갖춘 설치가 정상 동작하는 관리형 TinyTeX를 조용히 밀어낼 수는 없습니다. - 관리형 TinyTeX를 설치합니다. 다운로드는 약 250 MB이며 관리자 권한이 필요 없습니다. TinyTeX 설치와 업데이트를 참고하세요.
설정 → 엔진 → LaTeX의 TeX 배포판 관리에는 Oleafly가 찾은 모든 배포판이 나열됩니다. 사용 중은 latexmk가 컴파일에 쓰는 배포판을 표시하고, latexmk 배지는 컴파일할 수 있는 각 배포판에 붙습니다. 다른 행에서 컴파일에 사용을 선택하면 그 배포판으로 바뀝니다. 그러면 선택했던 행에는 자동이 표시되며, Oleafly가 다시 고르게 하는 값입니다. 완전한 시스템 TeX를 먼저, 그다음 TinyTeX를 고릅니다.
TeX가 Oleafly가 찾아보지 않는 폴더에 설치되어 있다면 TeX 폴더 선택을 클릭하고 latexmk가 들어 있는 폴더, 또는 그 위의 TeX Live 연도 폴더(예: texlive/2026)를 고르세요. Oleafly가 그 안에서 latexmk를 찾아 해당 설치로 컴파일하며, 목록에는 그 설치가 사용 중으로 표시됩니다. 자동을 선택하면 이 선택이 취소됩니다. 폴더에 latexmk가 없으면 대신 어느 폴더를 골라야 하는지 메시지로 알려 줍니다.
latexmk는 파일 시스템 샌드박스가 아닙니다. 셸 명령을 막아 두어도 TeX는 계정으로 접근할 수 있는 파일을 읽을 수 있습니다. 또한 프로젝트, 사용자, 시스템의 .latexmkrc 파일은 실행 가능한 Perl이므로 Oleafly가 모두 비활성화합니다. 시스템 TeX는 신뢰하는 프로젝트에만 쓰세요. 가져온 프로젝트는 기본 컴파일 엔진이나 프로젝트의 컴파일러 메뉴에서 직접 고를 때만 시스템 TeX를 씁니다. 제자리에서 연 폴더는 신뢰하기 전까지 Tectonic에 머뭅니다.
TeX가 설치되어 있지 않을 때
섹션 제목: “TeX가 설치되어 있지 않을 때”작동하는 TeX 배포판이 없는 컴퓨터에서 pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX, 자동 중 하나를 고르면 이 컴파일러에는 작동하는 TeX 배포판이 필요합니다라는 제목의 대화 상자가 열립니다. 선택지 세 가지가 다음 순서로 나옵니다.
- TinyTeX 내려받기, 권장으로 표시됩니다. TinyTeX 내려받아 사용은 TinyTeX를 설치하고 그것으로 프로젝트를 컴파일합니다.
- 내 시스템 LaTeX 사용(latexmk): TeX 배포판을 찾지 못했다는 것, 또는 이 컴퓨터의 배포판이 컴파일할 수 없는 이유를 알려 줍니다. 버튼은 없습니다.
- Tectonic 계속 사용. Tectonic으로 되돌리기는 프로젝트를 내장 엔진으로 돌려놓습니다.
먼저 컴파일했다면 미리보기도 같은 길을 제안합니다. TinyTeX 내려받아 사용, Tectonic 사용, 엔진 설정 열기입니다. TinyTeX를 내려받는 도중에 시작한 컴파일은 기다렸다가 설치가 끝나면 저절로 시작됩니다.
TeX 배포판은 있지만 latexmk가 없을 때도 같은 제안이 나타납니다. 배포판에 latexmk나 선택한 컴파일러, Biber가 없으면, Oleafly가 그 배포판을 아는 경우 메시지에 설치할 항목도 알려 줍니다. 예를 들어 MacTeX에서는 sudo tlmgr install latexmk, Ubuntu에서는 sudo apt install latexmk입니다.
공유 프로젝트에서는 컴파일러가 프로젝트에 저장되어 모든 공동 작업자에게 바뀌므로 버튼이 모두에게 Tectonic 사용이라고 표시됩니다. TinyTeX를 설치하는 것은 내 컴퓨터만 바꿉니다.
TinyTeX 설치와 업데이트
섹션 제목: “TinyTeX 설치와 업데이트”설정 → 엔진 → LaTeX을 열고 TeX 배포판 관리 아래에서 **TinyTeX 내려받기(약 250 MB)**를 선택하거나, 컴파일 대화 상자의 제안을 이용하세요. TinyTeX는 관리자 권한이 필요 없는 소형 TeX Live입니다. 학술지 템플릿이 나중에 패키지를 더해 전체가 약 1 GB까지 늘어날 수 있으며, Oleafly는 시작하기 전에 여유 디스크 공간이 약 2 GB 있는지 확인합니다. TinyTeX는 ~/.oleafly/tinytex 아래에 설치됩니다.
- 취소는 다운로드를 멈추고 이미 받은 부분을 남겨 둡니다. 그러면 버튼에 이미 받은 양과 함께 다운로드 이어가기가 표시됩니다. 설치 중에 Oleafly를 종료해도 같은 식으로 일시 중지되며, 다음에 앱을 열면 이어서 진행합니다.
- 다운로드는 Oleafly 미러에서 먼저 받고, 그다음 GitHub에서 받습니다. 어느 한 곳이 실패하거나 1분 동안 데이터를 보내지 않으면 Oleafly는 다음 곳으로 넘어가 멈춘 지점부터 이어서 받습니다. 설정 → 다운로드 → 다운로드 소스에서 다운로드를 받아 오는 곳을 바꿀 수 있습니다. 다운로드 소스 탭을 참고하세요.
- 관리형 TinyTeX가 이 버전의 Oleafly가 기대하는 릴리스보다 오래되면 그 행에 업데이트가 표시됩니다. 제거는 삭제합니다.
다른 배포판이 이미 사용 중이면 TinyTeX를 설치해도 그쪽으로 전환되지 않습니다. TinyTeX로 컴파일하려면 TinyTeX 행에서 컴파일에 사용을 선택하세요.
Linux에서 TinyTeX는 시스템 Perl로 실행됩니다. Oleafly는 무엇이든 내려받기 전에 Perl이 있는지 확인합니다. Perl이나 표준 모듈 중 하나가 없으면 메시지가 설치 명령을 알려 줍니다. sudo apt install perl, sudo dnf install perl, sudo pacman -S perl 중 하나입니다.
Windows에서는 폴더 이름에 악센트 문자나 비라틴 문자가 있으면 TeX Live가 그 폴더에서 실행되지 못합니다. 사용자 폴더 이름이 그렇다면 Oleafly는 TinyTeX를 대신 ProgramData 아래의 폴더에 둡니다. TinyTeX가 제자리로 옮겨지는 동안 바이러스 백신이 파일을 붙들고 있으면 Oleafly가 다시 시도하며, 그래도 끝내지 못하면 잠시 기다렸다가 설치를 다시 시도하세요.
MiKTeX와 Perl
섹션 제목: “MiKTeX와 Perl”MiKTeX의 latexmk는 Perl 스크립트인데 MiKTeX에는 Perl이 들어 있지 않습니다. Perl이 없으면 설정이 MiKTeX에 latexmk에 Perl이 필요합니다라고 표시하고, TinyTeX가 설치되어 있으면 Oleafly는 대신 TinyTeX로 컴파일합니다. 쓸 만한 다른 것이 없으면 컴파일이 멈추고 세 가지 방법을 알려 줍니다. 설정 → 엔진 → LaTeX에서 자체 Perl이 딸린 TinyTeX를 설치하거나, Strawberry Perl을 설치하거나, 프로젝트를 Tectonic으로 되돌리는 것입니다.
MiKTeX는 패키지를 MiKTeX Console에서 관리하므로 패키지 목록과 찾아서 설치는 적용되지 않습니다. 또한 MiKTeX는 컴파일하는 동안 EPS 그림을 변환하지 않으므로, EPS를 먼저 PDF로 변환하거나 TinyTeX를 쓰세요.
일본어 문서: upLaTeX와 pLaTeX
섹션 제목: “일본어 문서: upLaTeX와 pLaTeX”일본어 문서에는 컴파일러(이 프로젝트) 아래에서 upLaTeX 또는 pLaTeX를 고르거나, 컴파일러를 자동으로 두세요. 자동은 jsarticle, jsbook, jsreport에는 pLaTeX를(클래스에 uplatex 옵션이 있으면 upLaTeX를), uj 클래스와 jlreq에는 upLaTeX를, ltjsarticle과 그 밖의 LuaTeX-ja 문서에는 LuaLaTeX를 고릅니다.
두 컴파일러 모두 TeX Live의 일본어 지원이 필요합니다. 관리형 TinyTeX나 Oleafly가 쓸 수 있는 TeX Live에 이것이 없으면, 실패한 컴파일이 **일본어 지원 설치(약 450 MB)**를 제안합니다. 이를 선택하면 설치한 뒤 다시 컴파일합니다. 다른 설치본에서는 메시지가 그 배포판에 맞는 명령을 알려 줍니다. 예를 들면 sudo apt install texlive-lang-japanese입니다.
Tectonic으로 부족할 때
섹션 제목: “Tectonic으로 부족할 때”일부 문서에는 내장 Tectonic 엔진이 하지 못하는 기능이 필요합니다. EPS 그림이나 강제로 지정한 pdftex 드라이버가 그 예입니다. 프로젝트를 연 뒤 처음 컴파일하다가, 또는 직접 시작한 컴파일에서 이런 기능에 부딪히면 엔진 대화상자가 저절로 열립니다. 자동 컴파일이나 에이전트가 컴파일을 시작했을 때는 대화상자가 닫힌 채로 있고 대신 엔진 선택이 나타납니다. 그 버튼을 선택하면 대화상자가 열립니다. 버튼은 다음 컴파일까지 남아 있으므로 대화상자를 닫은 뒤에 다시 여는 데도 쓸 수 있습니다. 버튼이 어디에 있는지는 보기에 따라 다릅니다.
- 컴파일이 실패한 뒤에는 로그가 열려 있는 동안 미리보기 도구 모음 오른쪽에 있습니다. 컴파일이 PDF를 만들지 못했다면 미리보기가 저절로 로그로 전환됩니다. PDF가 아직 표시되어 있다면 로그를 선택해야 이 버튼이 보입니다.
- 비어 있는 미리보기에서는 컴파일 다시 시도 옆에 있습니다.
- 편집기 전용 보기, PDF가 별도 창에 있을 때, 컴파일이 성공한 뒤에는 다시 컴파일 왼쪽에 있습니다.
대화상자의 제목은 이 컴파일에는 내장 엔진 이상의 기능이 필요합니다이며, 찾아낸 문제를 나열합니다. 권장으로 표시된 옵션이 맨 앞에 나옵니다.
- TinyTeX 내려받기는 작동하는 TeX 배포판이 설치되어 있지 않을 때 나타납니다. 버튼인 TinyTeX 내려받아 사용은 TinyTeX를 설치하고, 프로젝트를
latexmk로 바꾸고, 다시 컴파일합니다. - **내 시스템 LaTeX 사용(latexmk)**에는 시스템 LaTeX 사용이 있으며, 프로젝트를 Oleafly가 찾은 TeX 배포판 위의
latexmk로 바꿉니다. 문서에 pdfLaTeX가 필요하면 옵션이 **내 시스템 LaTeX에서 pdfLaTeX 사용(latexmk)**으로 표시되고 그 버튼은 pdfLaTeX로 바꾸고 다시 컴파일입니다. 설치된 TeX가 없으면 이 옵션에는 버튼이 없습니다. - Tectonic 계속 사용에는 Tectonic 유지가 있으며, 프로젝트를 내장 엔진에 그대로 둡니다. 전환하면 대화상자가 나열한 문제가 해결될 때는 이 옵션이 문제들이 사라지지 않는다고 알려 줍니다.
Tectonic을 유지하고 나면 이 컴퓨터에서 이 프로젝트는 같은 문제로 대화상자가 열리거나 엔진 선택이 나타나지 않습니다. 나중에 바꾸려면 **컴파일러(이 프로젝트)**에서 컴파일러를 고르세요.
프로젝트가 외부 명령도 실행해야 한다면 시스템 LaTeX나 TinyTeX로 전환할 때 그것도 함께 허용되며, 대화상자가 클릭하기 전에 이를 알려 줍니다. 고른 컴파일러는 프로젝트에 저장되므로 공동 작업자도 같은 설정을 받습니다.
외부 명령 허용
섹션 제목: “외부 명령 허용”minted와 PythonTeX 같은 패키지, 그리고 \write18을 쓰는 문서는 컴파일하는 동안 다른 프로그램을 실행합니다. Oleafly는 기본적으로 이를 차단합니다. 컴파일이 차단되었거나 로그에 프로젝트가 그 명령을 필요로 한다고 나오면, 편집기 위쪽의 배너에 외부 명령 허용이 나타납니다.
내장 엔진에서도 이 차단은 유지됩니다. Tectonic은 프로젝트 폴더 밖에서 시작되며, Oleafly에 들어 있는 Biber는 문서의 참고문헌 설정을 일반 텍스트로만 취급하고 컴파일하는 동안 biber.conf를 건너뜁니다.
외부 명령은 파일을 신뢰할 수 있는 프로젝트에서만 허용하세요. 허용하면 LaTeX가 여러분의 권한으로 어떤 프로그램이든 실행할 수 있기 때문입니다. 이 권한은 시스템 LaTeX에서만 동작하며 이 컴퓨터에만 남습니다. project.json에 저장되지 않고 Git에 커밋되지도 않으므로, 공저자는 자기 컴퓨터에서 직접 허용해야 합니다. 공유 프로젝트에서는 켜기 전에 Oleafly가 경고합니다. 프로젝트를 편집할 수 있는 사람이 누구든, 여러분이 컴파일할 때 여러분의 컴퓨터에서 프로그램을 실행할 수 있게 되기 때문입니다. 프로젝트를 Tectonic으로 되돌리거나 삭제하면 권한이 제거됩니다. 제자리에서 연 폴더에서는 먼저 폴더를 신뢰하세요. 폴더를 신뢰하는 것만으로 외부 명령이 허용되지는 않습니다.
엔진이 있으면 프리플라이트 패널의 태그를 켜고 컴파일해 확인 버튼이 한 번에 LuaLaTeX로 태그된 PDF를 만들고 곧바로 감사할 수 있습니다. 직접 쓰는 툴체인을 선호하나요? 프리플라이트의 접근 가능한 내보내기 준비가 소스를 태그에 맞게 고쳐 쓰며, 앱 밖에서 TeX Live 2026의 LuaLaTeX, 또는 2025년 11월 이후에 업데이트한 TeX Live의 LuaLaTeX로 컴파일하면 됩니다.
PDF에서 빠진 문자
섹션 제목: “PDF에서 빠진 문자”TeX는 글꼴에 글리프가 없는 문자를 건너뛰며, 그래도 컴파일은 성공합니다. 한국어, 중국어, 일본어 문단이 오류 없이 빈 채로 나올 수 있습니다. Oleafly는 컴파일할 때마다 로그를 읽으므로, 문자가 빠지면 프로젝트마다 한 번 알림이 나타나고, 로그의 누락된 문자 아래에 그 목록이 나오며, 경고에는 그중 몇 개의 이름이 표시됩니다.
내장 엔진과 XeLaTeX에서는 경고가 찾아낸 문자 체계마다, 내장 엔진에 포함된 글꼴을 쓰는 설정도 함께 보여 줍니다. 필요한 것을 프리앰블에 붙여 넣으세요.
% Korean\usepackage[space]{xeCJK}\setCJKmainfont[AutoFakeBold]{UnBatang.ttf}
% Simplified Chinese\usepackage{xeCJK}\setCJKmainfont[AutoFakeBold]{gbsn00lp.ttf}
% Traditional Chinese\usepackage{xeCJK}\setCJKmainfont[AutoFakeBold]{bsmi00lp.ttf}
% Japanese\usepackage{xeCJK}\setCJKmainfont{ipaexm.ttf}[BoldFont=ipaexg.ttf]space 옵션은 일반 xeCJK가 없애 버리는 한국어 단어 사이의 공백을 유지합니다.
CJKutf8과 CJK 패키지는 pdfLaTeX에서만 작동합니다. 내장 엔진에서 이를 불러오는 프로젝트는 중국어, 일본어, 한국어 텍스트 없이 컴파일되므로, 알림이 pdfLaTeX로 전환하는 화면을 여는 엔진 선택을 제안합니다. 패키지와 그 CJK 환경을 지우고 위의 설정 중 하나를 써도 됩니다.
Mac 자체 글꼴을 쓰는 ctex 문서는 macOS가 글꼴을 내려받을지 물어보게 할 수 있으며, 컴파일은 답을 기다립니다. 대화 상자에 답하고 다시 컴파일하거나, \documentclass 옵션에 fontset=fandol을 추가하세요.
기호나 다른 문자 체계의 글자처럼 그 밖에 빠지는 문자는 그 문자를 가진 글꼴이 필요합니다. 프리앰블에서 그런 글꼴로 바꾸세요. Typst 프로젝트는 상자로 표시되는 문자를 참고하세요.
패키지 관리자
섹션 제목: “패키지 관리자”엔진 상태 아래에는 LuaLaTeX 쪽을 위한 필터링 가능한 패키지 목록이 있으며, tlmgr로 동작합니다.
- 추천 패키지 목록으로 시작하거나, 두 글자 이상을 입력하고 TeX Live 검색을 선택해 전체 카탈로그를 조회하세요.
- 패키지 이름이나 그 안에 든 파일로 검색하세요. 이름이 다르면 Oleafly가 해당 파일을 가진 TeX Live 패키지를 보여 줍니다.
- 한 번의 클릭으로 패키지를 추가하거나 제거하세요. 설치된 행에는 패키지가 시스템 트리, 개인 트리, 또는 두 곳 모두에 있는지 표시됩니다.
- 접근 가능한 내보내기 전에 태그 배지를 확인하세요. 태그 처리: 주의는 태그 품질을 낮출 수 있는 패키지를, 태그 처리 불가는 알려진 충돌을 표시합니다.
이 패키지 관리자는 latexmk가 쓰는 TeX Live와 TinyTeX 배포판에 적용됩니다. Tectonic은 자체 패키지 캐시를 관리합니다. MiKTeX에서는 MiKTeX Console을 쓰세요.
누락된 파일 복구
섹션 제목: “누락된 파일 복구”패키지 이름이 컴파일 로그에 나온 파일 이름과 항상 같지는 않습니다. 예를 들어 tikz.sty는 pgf 패키지가 설치합니다. 짐작으로 tikz라는 패키지를 설치하면 실패합니다.
latexmk 컴파일이 누락된 파일을 알려 주면 메시지의 찾아서 설치를 사용하세요. 패키지, 클래스, 참고문헌 스타일, 글꼴 파일, babel 언어 파일, TikZ 라이브러리가 모두 여기에 해당합니다. Oleafly가 그 파일을 가진 패키지를 TeX Live에 물어보고, 그 패키지를 설치한 다음 다시 컴파일합니다. 그 파일을 가진 TeX Live 패키지가 없다면 대학이나 출판사 템플릿에 딸려 온 파일일 가능성이 크므로, 원래 템플릿에서 프로젝트에 추가하세요. 여러 패키지에 그 파일이 있으면 메시지가 목록을 보여 주므로 템플릿에 필요한 것을 고르면 됩니다. 카탈로그에 연결할 수 없거나 설치로 컴파일이 해결되지 않으면 메시지가 어느 쪽인지 알려 줍니다.
권한 없이 시스템 설치를 바꾸려 하면 Oleafly가 대신 개인 TeX 트리에 설치할 수 있으며, 그 트리가 아직 없으면 먼저 만듭니다. 패키지 행에 어디에 설치되었는지 표시됩니다. 소유 패키지를 제거하면 그 패키지가 제공하는 다른 파일도 함께 제거되므로, 제거하기 전에 행의 ”…에 포함되어 있습니다” 안내를 읽으세요.
tlmgr과 이전 TeX Live 릴리스 계속 쓰기
섹션 제목: “tlmgr과 이전 TeX Live 릴리스 계속 쓰기”TeX Live의 패키지 관리자인 tlmgr이 온라인 TeX Live 저장소보다 뒤처지면, 스스로 업데이트하기 전까지는 아무것도 설치하지 않으려 합니다. Oleafly가 관리하는 TinyTeX에서는 Oleafly가 tlmgr을 업데이트하고 설치를 되풀이합니다. 직접 설치한 TeX Live나 TinyTeX에서는 메시지가 tlmgr update --self를 실행하라고 알려 줍니다.
저장소가 새 TeX Live 연도로 넘어가면 이전 설치본은 그 저장소에서 설치할 수 없습니다. 이때 Oleafly는 내 릴리스의 마지막 아카이브에서 설치합니다. 아카이브에도 그 패키지가 없으면 메시지가 TeX Live를 업데이트하라고 하거나, 설정에서 관리형 TinyTeX의 업데이트를 쓰라고 안내합니다.
패키지를 받아 오는 곳 고르기
섹션 제목: “패키지를 받아 오는 곳 고르기”tlmgr은 TeX Live 저장소에서 패키지를 설치합니다. Oleafly가 관리하는 TinyTeX는 설정 → 다운로드 → 다운로드 소스의 TeX 패키지 저장소에서 대학의 CTAN 미러 같은 특정 저장소를 고르지 않는 한 가장 가까운 CTAN 미러를 씁니다. 직접 설치한 TeX Live는 그곳에 주소를 입력하지 않는 한 자기 저장소를 그대로 씁니다. Oleafly는 실행할 때마다 tlmgr에 그 주소를 넘기며, 저장된 구성은 절대 바꾸지 않습니다.
저장소에 접속해야 하는 패키지 검색은 느린 연결에서는 오래 걸릴 수 있습니다. Oleafly는 최대 10분을 기다리며, 포기하면 메시지에 기다리던 저장소의 이름이 나옵니다. 다운로드 소스 탭을 참고하세요.
Linux 배포판의 TeX Live
섹션 제목: “Linux 배포판의 TeX Live”Debian, Ubuntu, Fedora에서는 TeX Live가 시스템 패키지 관리자에서 오므로 Oleafly가 거기에 패키지를 추가하지 않습니다. 패키지 목록은 apt나 dnf를 쓰라고 안내하고, 누락된 파일에는 찾아서 설치 대신 힌트가 담긴 알림이 나타납니다.
- Debian과 Ubuntu에서는
apt-file search와 파일 이름으로 패키지를 찾거나,sudo apt install texlive-full로 모두 설치하세요. - Fedora에서는 알림이 누락된 파일에 대한
sudo dnf install 'tex(file.sty)'명령을 알려 줍니다.
배포판의 TeX가 불완전하면 알림은 **TinyTeX 내려받기(약 250 MB)**도 제안하며, Oleafly는 이것에 대해서는 패키지를 관리할 수 있습니다. Debian과 Ubuntu에서 tlmgr init-usertree로 개인 트리를 만들어 두었다면 Oleafly는 그 트리에 패키지를 설치합니다.
편집기에서 패키지 추가
섹션 제목: “편집기에서 패키지 추가”LaTeX 편집기 도구 모음의 패키지 아이콘인 LaTeX 패키지를 선택하면 문서를 떠나지 않고 CTAN을 검색할 수 있습니다. 각 결과에는 문서가 이미 불러오고 있는지(문서에서 사용 중)가 표시됩니다. latexmk 프로젝트에서는 TeX 배포판에 있는지(설치됨)도 표시되며, 설치는 빠진 패키지를 tlmgr로 추가합니다. Linux 배포판의 TeX Live를 쓰는 경우 대화 상자는 대신 apt나 dnf로 패키지를 설치하라고 안내합니다.
프리앰블에 추가는 프리앰블에 \usepackage 줄을 씁니다. 옵션에서는 먼저 패키지 옵션을 추가할 수 있고, 줄 복사는 대신 그 줄을 복사합니다. Tectonic 프로젝트에는 설치할 것이 없습니다. Tectonic은 문서가 패키지를 처음 쓸 때 내려받습니다.
내 PDF는 어떤 엔진으로 컴파일됐나요?
섹션 제목: “내 PDF는 어떤 엔진으로 컴파일됐나요?”- 컴파일 메뉴, 즉 다시 컴파일 옆 화살표의 컴파일러(이 프로젝트) 항목은 현재 프로젝트에 저장된 컴파일러를 보여 줍니다.
- Tectonic 빌드는 번들된 엔진을 씁니다.
- pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX 빌드는
latexmk와 설정에서 사용 중으로 표시된 TeX 배포판을 씁니다. - 프리플라이트의 태그된 내보내기는 LuaLaTeX를 쓰고 일반 빌드 위치에 기록합니다.
템플릿과 패키지
섹션 제목: “템플릿과 패키지”템플릿은 필요한 패키지를 선언하고, Tectonic이 처음 컴파일할 때 그 패키지를 가져옵니다. 필요할 때 내려받는 글꼴이 있는 템플릿은 그 글꼴을 별도로 처리합니다. 템플릿을 참고하세요.