# Engine và gói LaTeX

Chọn Tectonic hoặc bộ biên dịch latexmk, dùng một bản phân phối TeX sẵn có, hoặc cài bản TinyTeX do Oleafly quản lý.

Oleafly đi kèm Tectonic và cũng có thể biên dịch qua `latexmk`. Menu trình biên dịch của dự án điều khiển các lần dựng hằng ngày. **Settings → Engines** hiển thị các bản phân phối TeX và gói có sẵn trên máy của bạn.

## Tectonic: engine hằng ngày

**Tectonic** là engine biên dịch mặc định cho đến khi bạn chọn engine khác dưới **Default compile engine** trong **Settings → Engines → LaTeX**. Nó không cần cài đặt riêng, tự tải gói khi cần và lưu vào bộ nhớ đệm để dùng ngoại tuyến. Nó phù hợp với hầu hết dự án và vẫn sẵn dùng kể cả khi máy không cài bản phân phối TeX của hệ thống. Xem [Đặt mặc định cho dự án mới](/docs/engines/#set-a-default-for-new-projects).

Với **PDF có gắn thẻ**, hãy dùng quy trình LuaLaTeX. Các thẻ mô tả cấu trúc tài liệu cho công nghệ hỗ trợ. Kiểm tra kết quả bằng Preflight sau khi biên dịch.

### Phông chữ trên engine tích hợp sẵn

Tectonic dựa trên XeTeX, engine đọc trực tiếp tệp phông chữ. Oleafly điều chỉnh một vài điểm để các tài liệu viết cho pdfLaTeX giữ nguyên phông chữ và văn bản:

- Times, Helvetica, Courier, Palatino, Bookman, New Century Schoolbook và Avant Garde dùng phiên bản TeX Gyre của chúng thay vì rơi về Latin Modern.
- `\usepackage[T1]{fontenc}` làm hỏng các dấu và ký hiệu gõ vào trên engine này, nên Oleafly giữ tài liệu ở dạng văn bản Unicode. Nếu một phông chữ mà tài liệu dùng chỉ có ở T1, tài liệu ở lại T1 và lần biên dịch cảnh báo rằng các ký tự như ß, §, «, dấu nháy cong và € có thể in sai hoặc biến mất. Cảnh báo đưa ra một phiên bản của dòng đó, chỉ nạp T1 dưới pdfLaTeX:

  ```latex
  \usepackage{iftex}
  \ifPDFTeX
    \usepackage[T1]{fontenc}
  \fi
  ```

- Một tài liệu đặt `\pdfoutput=1`, như arXiv yêu cầu, biên dịch như nguyên bản.
- Một tài liệu `ctex` không đặt `fontset` nhận phông Fandol, nên trông giống nhau trên mọi máy tính. Thêm `fontset=mac` vào các tùy chọn của lớp để dùng phông của chính máy Mac.
- Phông chữ đi kèm engine tích hợp sẵn được tìm theo tên tệp. `\setmainfont{UnBatang}` thất bại, và thông báo lỗi bảo bạn viết `UnBatang.ttf` thay vào đó.

Offline mode bỏ qua các điều chỉnh về phông chữ và bảng mã, nên một bản dựng ngoại tuyến của tài liệu như vậy có thể trông khác bản dựng trực tuyến.

## latexmk và TeX hệ thống

Chọn pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX hoặc pLaTeX từ menu trình biên dịch của dự án khi dự án phụ thuộc vào quy trình TeX Live hoặc MiKTeX truyền thống. Oleafly chạy các trình biên dịch đó qua `latexmk`. **Auto** đọc tệp chính và chọn một trình biên dịch: dòng `% !TeX program = xelatex` ở đầu tệp được ưu tiên nhất, rồi đến các lớp tiếng Nhật, rồi đến các gói cần XeLaTeX hoặc LuaLaTeX, chẳng hạn `fontspec`, `ctex`, `xeCJK` hoặc `luatexko`. Nếu tệp chính chưa quyết định được, Auto còn xem `latexmkrc` trong dự án và các tệp mà phần preamble nạp. Mọi trường hợp còn lại dùng pdfLaTeX. Nếu một gói cần trình biên dịch khác với trình Auto đã chọn, lần biên dịch đề nghị chuyển, chẳng hạn bằng **Use XeLaTeX**.

Có hai cách cung cấp bộ công cụ đó:

1. **Dùng một bản cài sẵn có.** Oleafly phát hiện MacTeX, TeX Live, MiKTeX và TinyTeX trên hệ thống của bạn. Nó tìm trên cùng `PATH` mà terminal của bạn dùng và, trên Windows, cả trong các thiết lập `Path` của hệ thống và người dùng, nên bản TeX bạn tự cài vẫn được tìm thấy ngay cả khi ứng dụng được mở từ Dock hoặc menu Start. Một bản cài hệ thống chỉ được ưu tiên hơn bản TinyTeX do Oleafly quản lý khi thư mục binary của nó chứa `latexmk`, pdfLaTeX, XeLaTeX, LuaLaTeX, `kpsewhich` và Biber. Một bản cài một phần không thể âm thầm vượt qua một TinyTeX quản lý đang hoạt động.
2. **Cài TinyTeX do Oleafly quản lý.** Bản tải khoảng 250 MB và không cần quyền quản trị viên. Xem [Cài đặt và cập nhật TinyTeX](#install-and-update-tinytex).

**Manage TeX distributions** trong **Settings → Engines → LaTeX** liệt kê mọi bản phân phối Oleafly tìm thấy. **In use** đánh dấu bản mà `latexmk` dùng để biên dịch, và một huy hiệu **latexmk** đánh dấu từng bản có thể biên dịch. Chọn **Use for compiles** trên một dòng khác để chuyển sang nó. Dòng bạn đã chọn khi đó hiển thị **Automatic**, để Oleafly tự chọn lại: một bản TeX hệ thống đầy đủ trước, rồi đến TinyTeX.

Nếu TeX được cài trong một thư mục mà Oleafly không tìm, hãy nhấp **Choose a TeX folder** và chọn thư mục có `latexmk` bên trong, hoặc thư mục năm TeX Live ở trên nó, chẳng hạn `texlive/2026`. Oleafly tìm `latexmk` bên trong và biên dịch bằng bản cài đó, bản mà danh sách đánh dấu **In use**. **Automatic** hoàn tác lựa chọn. Nếu thư mục không có `latexmk`, thông báo cho biết nên chọn thư mục nào thay thế.

`latexmk` không phải là một sandbox hệ thống tệp. Ngay cả khi các lệnh shell bị chặn, TeX vẫn có thể đọc mọi tệp mà tài khoản của bạn truy cập được. Oleafly cũng vô hiệu hóa các tệp `.latexmkrc` cấp dự án, cấp người dùng và cấp hệ thống vì chúng là mã Perl có thể thực thi. Chỉ dùng TeX hệ thống cho những dự án bạn tin tưởng. Một dự án nhập vào chỉ dùng TeX hệ thống khi bạn chọn nó, hoặc làm engine biên dịch mặc định hoặc từ menu trình biên dịch của dự án. Một thư mục mở tại chỗ vẫn dùng Tectonic cho đến khi bạn tin tưởng nó.

### Khi chưa cài TeX

Chọn pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX hoặc Auto trên một máy tính không có bản phân phối TeX nào dùng được sẽ mở một hộp thoại có tiêu đề **This compiler needs a working TeX distribution**. Nó có ba lựa chọn, theo thứ tự này:

- **Download TinyTeX**, được đánh dấu **Recommended**. **Download and use TinyTeX** cài TinyTeX và biên dịch dự án bằng nó.
- **Use my system LaTeX (latexmk)**, cho biết không tìm thấy bản phân phối TeX nào, hoặc lý do bản có trên máy tính này không thể biên dịch. Lựa chọn này không có nút.
- **Keep using Tectonic**. **Switch back to Tectonic** đưa dự án về engine tích hợp sẵn.

Nếu bạn biên dịch trước, bản xem trước đề xuất cùng lối thoát đó: **Download and use TinyTeX**, **Use Tectonic** và **Open engine settings**. Một lần biên dịch bạn bắt đầu khi TinyTeX vẫn đang tải sẽ chờ và tự bắt đầu khi quá trình cài hoàn tất.

Lời đề nghị tương tự xuất hiện khi có một bản phân phối TeX nhưng thiếu `latexmk`. Khi bản phân phối thiếu `latexmk`, trình biên dịch đã chọn hoặc Biber, thông báo còn nêu rõ cần cài gì nếu Oleafly nhận ra bản phân phối đó, chẳng hạn `sudo tlmgr install latexmk` trên MacTeX hoặc `sudo apt install latexmk` trên Ubuntu.

Trong một dự án chia sẻ, nút ghi **Use Tectonic for everyone**, vì trình biên dịch được lưu trong dự án và thay đổi với mọi cộng sự. Cài TinyTeX chỉ thay đổi máy tính của bạn.

### Cài đặt và cập nhật TinyTeX

Mở **Settings → Engines → LaTeX** và chọn **Download TinyTeX (~250 MB)** dưới **Manage TeX distributions**, hoặc dùng lời đề nghị trong hộp thoại biên dịch. TinyTeX là một bản TeX Live gọn nhẹ, không cần quyền quản trị. Các mẫu tạp chí có thể thêm gói sau đó, tổng cộng tới khoảng 1 GB, và Oleafly kiểm tra còn khoảng 2 GB dung lượng đĩa trống trước khi bắt đầu. TinyTeX được cài dưới `~/.oleafly/tinytex`.

- **Cancel** dừng lượt tải và giữ phần đã về. Nút khi đó ghi **Resume download** kèm dung lượng đã tải. Thoát Oleafly giữa lúc cài cũng tạm dừng nó theo cách tương tự, và nó tiếp tục vào lần bạn mở ứng dụng tiếp theo.
- Bản tải xuống đến từ mirror của Oleafly trước, rồi đến GitHub. Nếu một nguồn thất bại, hoặc ngừng gửi dữ liệu trong một phút, Oleafly chuyển sang nguồn kế tiếp và tiếp tục từ chỗ đã dừng. **Settings → Downloads → Sources** thay đổi nơi các bản tải xuống đến từ. Xem [Thẻ Sources](/docs/settings/downloads/#sources-tab).
- Khi TinyTeX được quản lý cũ hơn bản phát hành mà phiên bản Oleafly này mong đợi, dòng của nó hiển thị **Update**. **Remove** xóa nó.

Nếu một bản phân phối khác đang **In use**, cài TinyTeX không chuyển sang nó. Chọn **Use for compiles** trên dòng TinyTeX khi bạn muốn nó biên dịch.

Trên Linux, TinyTeX chạy trên Perl của hệ thống. Oleafly kiểm tra Perl trước khi tải bất cứ thứ gì. Nếu thiếu Perl hoặc một trong các module chuẩn của nó, thông báo đưa ra lệnh để cài: `sudo apt install perl`, `sudo dnf install perl` hoặc `sudo pacman -S perl`.

Trên Windows, TeX Live không chạy được từ một thư mục có tên chứa chữ có dấu hoặc chữ không phải Latin. Nếu thư mục người dùng của bạn có tên như vậy, Oleafly đặt TinyTeX vào một thư mục dưới ProgramData. Nếu phần mềm diệt virus giữ một tệp mở trong lúc TinyTeX được chuyển vào chỗ, Oleafly thử lại, và nếu vẫn không hoàn tất được, hãy chờ một lát rồi thử cài lại.

### MiKTeX và Perl

`latexmk` của MiKTeX là một script Perl, và MiKTeX không kèm Perl. Khi thiếu Perl, Settings đánh dấu MiKTeX bằng **latexmk needs Perl**, và Oleafly biên dịch bằng TinyTeX thay vào đó nếu nó đã được cài. Khi không còn gì khác để dùng, lần biên dịch dừng lại và đưa ra ba hướng đi: cài TinyTeX từ **Settings → Engines → LaTeX**, bản này tự mang theo Perl, cài Strawberry Perl, hoặc chuyển dự án về Tectonic.

MiKTeX quản lý gói của nó trong MiKTeX Console, nên danh sách **Packages** và **Find and install** không áp dụng cho nó. MiKTeX cũng không chuyển đổi hình EPS khi biên dịch, nên hãy chuyển chúng sang PDF trước hoặc dùng TinyTeX.

### Tài liệu tiếng Nhật: upLaTeX và pLaTeX

Chọn **upLaTeX** hoặc **pLaTeX** dưới **Compiler (this project)** cho một tài liệu tiếng Nhật, hoặc để trình biên dịch ở **Auto**. Auto chọn pLaTeX cho `jsarticle`, `jsbook` và `jsreport` (upLaTeX khi lớp có tùy chọn `uplatex`), upLaTeX cho các lớp `uj` và `jlreq`, và LuaLaTeX cho `ltjsarticle` cùng các tài liệu LuaTeX-ja khác.

Cả hai trình biên dịch đều cần phần hỗ trợ tiếng Nhật của TeX Live. Khi phần này thiếu trong TinyTeX được quản lý, hoặc trong một bản TeX Live mà Oleafly ghi được, lần biên dịch thất bại đề xuất **Install Japanese support (about 450 MB)**. Nút đó cài nó rồi biên dịch lại. Trên các bản cài khác, thông báo nêu lệnh cho bản phân phối của bạn, chẳng hạn `sudo apt install texlive-lang-japanese`.

## Khi Tectonic chưa đủ

Một số tài liệu cần những thứ mà engine Tectonic tích hợp không làm được, chẳng hạn hình EPS hoặc việc ép dùng driver `pdftex`. Khi lần biên dịch đầu tiên sau khi bạn mở dự án, hoặc một lần biên dịch do chính bạn bắt đầu, gặp một trong các trường hợp này, hộp thoại engine tự mở. Khi Auto compile hoặc một agent bắt đầu lần biên dịch, hộp thoại vẫn đóng và **Choose engine** xuất hiện thay vào đó. Chọn nó để mở hộp thoại. Nút này ở lại đến lần biên dịch kế tiếp, nên nó cũng mở lại hộp thoại sau khi bạn đóng nó. Vị trí của nó tùy theo chế độ xem:

- Sau một lần biên dịch thất bại, nó nằm ở bên phải thanh công cụ xem trước khi **Logs** đang mở. Bản xem trước tự chuyển sang **Logs** khi lần biên dịch không tạo ra PDF. Nếu một PDF vẫn đang hiển thị, hãy chọn **Logs** để thấy nút này.
- Trong một bản xem trước trống, nó nằm cạnh **Retry compile**.
- Trong chế độ chỉ có trình soạn thảo, khi PDF ở cửa sổ riêng, hoặc sau một lần biên dịch thành công, nó nằm bên trái **Recompile**.

Hộp thoại có tiêu đề **This compile needs more than the built-in engine** và liệt kê các vấn đề nó tìm thấy. Tùy chọn được đánh dấu **Recommended** đứng đầu:

- **Download TinyTeX** xuất hiện khi chưa cài bản phân phối TeX nào dùng được. Nút của nó, **Download and use TinyTeX**, cài TinyTeX, chuyển dự án sang `latexmk` và biên dịch lại.
- **Use my system LaTeX (latexmk)** có **Use system LaTeX**, chuyển dự án sang `latexmk` trên bản phân phối TeX mà Oleafly tìm thấy. Nếu tài liệu cần pdfLaTeX, tùy chọn này ghi **Use pdfLaTeX on my system LaTeX (latexmk)** và nút của nó ghi **Switch to pdfLaTeX and recompile**. Khi chưa cài TeX, tùy chọn này không có nút.
- **Keep using Tectonic** có **Keep Tectonic**, giữ dự án trên engine tích hợp sẵn. Khi một lần chuyển đổi có thể khắc phục các vấn đề mà hộp thoại liệt kê, tùy chọn này nói rằng chúng sẽ không tự hết.

Sau khi bạn giữ Tectonic, cùng các vấn đề đó không còn mở hộp thoại hay hiện **Choose engine** cho dự án này trên máy tính này. Để chuyển sau này, chọn một trình biên dịch dưới **Compiler (this project)**.

Nếu dự án còn cần chạy các lệnh ngoài, chuyển sang LaTeX hệ thống hoặc TinyTeX cũng cho phép chúng, và hộp thoại nói rõ điều đó trước khi bạn bấm. Trình biên dịch bạn chọn được lưu trong dự án, nên cộng sự cũng có cùng cấu hình.

## Cho phép lệnh ngoài

Các gói như `minted` và PythonTeX, cùng những tài liệu dùng `\write18`, chạy các chương trình khác trong lúc biên dịch. Oleafly chặn điều đó theo mặc định. Khi một lần biên dịch bị chặn, hoặc nhật ký cho thấy dự án cần những lệnh đó, một dải thông báo phía trên trình soạn thảo đề xuất **Allow external commands**.

Engine tích hợp sẵn vẫn giữ lớp chặn đó. Tectonic khởi chạy bên ngoài thư mục dự án, và Biber đi kèm Oleafly coi các thiết lập tài liệu tham khảo của tài liệu là văn bản thuần và bỏ qua `biber.conf` trong lúc biên dịch.

Chỉ cho phép lệnh ngoài với dự án mà bạn tin tưởng các tệp của nó, vì khi đó LaTeX có thể chạy bất kỳ chương trình nào với quyền của bạn. Quyền này chỉ tác dụng với LaTeX hệ thống, và nó ở lại trên máy này. Nó không bao giờ được lưu trong `project.json` hay commit lên Git, nên đồng tác giả phải tự cho phép trên máy của họ. Trong [dự án chia sẻ](/docs/collaboration/), Oleafly cảnh báo bạn trước khi bật, vì bất kỳ ai chỉnh sửa được dự án đều có thể chạy chương trình trên máy của bạn khi bạn biên dịch. Chuyển dự án về Tectonic hoặc xóa dự án sẽ gỡ quyền này. Với một thư mục mở tại chỗ, hãy tin tưởng thư mục trước. Tin tưởng một thư mục không tự cho phép lệnh ngoài.

Khi có sẵn một engine, nút **Compile tagged and verify** của bảng [Preflight](/docs/preflight/) có thể tạo PDF có gắn thẻ bằng LuaLaTeX và kiểm tra ngay, trong một bước. Thích dùng bộ công cụ của riêng mình? **Prepare for accessible export** của Preflight viết lại mã nguồn của bạn để gắn thẻ, và bạn biên dịch bằng bất kỳ LuaLaTeX nào từ TeX Live 2026, hoặc một TeX Live đã cập nhật từ tháng 11 năm 2025, bên ngoài ứng dụng.

## Ký tự bị thiếu trong PDF

TeX bỏ qua mọi ký tự mà phông chữ của nó không có glyph, và lần biên dịch vẫn thành công. Một đoạn tiếng Hàn, tiếng Trung hoặc tiếng Nhật có thể ra trống mà không có lỗi nào. Oleafly đọc nhật ký sau mỗi lần biên dịch, nên khi có ký tự bị thiếu, bạn nhận một thông báo mỗi dự án một lần, nhật ký liệt kê chúng dưới **Missing characters**, và cảnh báo nêu tên vài ký tự trong số đó.

Trên engine tích hợp sẵn và XeLaTeX, cảnh báo còn đưa ra một đoạn thiết lập cho từng hệ chữ nó tìm thấy, dùng các phông chữ đi kèm engine tích hợp sẵn. Dán đoạn bạn cần vào preamble:

```latex
% 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]
```

Tùy chọn `space` giữ khoảng trắng giữa các từ tiếng Hàn, thứ mà `xeCJK` thuần bỏ đi.

`CJKutf8` và gói `CJK` chỉ chạy trên pdfLaTeX. Một dự án nạp chúng trên engine tích hợp sẵn sẽ biên dịch mà thiếu chữ Trung, Nhật hoặc Hàn, nên thông báo đề xuất **Choose engine**, nút này mở lựa chọn chuyển sang pdfLaTeX. Bạn cũng có thể gỡ gói đó cùng môi trường `CJK` của nó và dùng một trong các đoạn thiết lập ở trên.

Một tài liệu `ctex` trên Mac dùng phông của chính máy Mac có thể khiến macOS hỏi có tải một phông chữ không, và lần biên dịch chờ câu trả lời của bạn. Trả lời hộp thoại rồi biên dịch lại, hoặc thêm `fontset=fandol` vào các tùy chọn của `\documentclass`.

Các ký tự thiếu khác, chẳng hạn một ký hiệu hoặc một chữ cái của hệ chữ khác, cần một phông chữ có chúng. Chuyển sang một phông như vậy trong preamble. Với dự án Typst, xem [Ký tự hiện thành ô vuông](/docs/typst/#characters-that-show-as-boxes).

## Trình quản lý gói

Bên dưới trạng thái engine là danh sách **Packages** có thể lọc, dành cho phía LuaLaTeX, vận hành bằng `tlmgr`:

- Bắt đầu với danh sách gói được đề xuất, hoặc nhập ít nhất hai ký tự và chọn **Search TeX Live** để truy vấn toàn bộ danh mục.
- Tìm theo tên gói hoặc một tệp mà gói đó chứa. Oleafly hiển thị gói TeX Live sở hữu khi hai tên đó khác nhau.
- **Add** hoặc **Remove** một gói chỉ với một cú bấm. Các dòng đã cài cho biết gói nằm trong cây hệ thống, cây cá nhân của bạn, hay cả hai.
- Kiểm tra huy hiệu gắn thẻ trước khi tạo bản xuất dễ tiếp cận: **tagging: caution** đánh dấu các gói có thể làm giảm chất lượng thẻ, còn **breaks tagging** đánh dấu các xung đột đã biết.

Trình quản lý gói này áp dụng cho các bản phân phối TeX Live và TinyTeX do `latexmk` dùng. Tectonic tự quản lý bộ nhớ đệm gói của riêng nó. Với MiKTeX, hãy dùng MiKTeX Console.

### Khôi phục khi thiếu tệp

Một gói không luôn được đặt tên theo tệp được nhắc trong nhật ký biên dịch. Chẳng hạn, `tikz.sty` được cài bởi gói `pgf`. Cài một gói được đoán tên là `tikz` sẽ thất bại.

Khi một lần biên dịch `latexmk` báo thiếu tệp, dùng **Find and install** trong thông báo. Cách này áp dụng cho gói, lớp tài liệu, kiểu tài liệu tham khảo, tệp phông chữ, tệp ngôn ngữ babel và thư viện TikZ. Oleafly hỏi TeX Live xem gói nào sở hữu tệp đó, cài gói ấy rồi biên dịch lại. Nếu không gói TeX Live nào có tệp đó, có lẽ nó đến từ mẫu của trường đại học hoặc nhà xuất bản của bạn, nên hãy thêm nó vào dự án từ mẫu gốc. Nếu có nhiều gói chứa nó, thông báo liệt kê các gói để bạn chọn gói mà mẫu của bạn cần. Nếu không kết nối được danh mục, hoặc việc cài không sửa được lần biên dịch, thông báo cho biết là trường hợp nào.

Nếu bạn cố thay đổi một bản cài hệ thống mà không có quyền, Oleafly có thể cài vào cây TeX cá nhân của bạn thay thế, và thiết lập cây đó trước nếu nó chưa tồn tại. Dòng của gói cho biết nó cuối cùng nằm ở đâu. Gỡ một gói chủ sở hữu cũng gỡ luôn các tệp khác mà nó cung cấp, nên hãy đọc ghi chú **Included in** trước khi gỡ.

### Giữ tlmgr và các bản TeX Live cũ hoạt động

`tlmgr`, trình quản lý gói của TeX Live, có thể tụt lại sau kho TeX Live trực tuyến, và khi đó nó từ chối cài bất cứ thứ gì cho đến khi tự cập nhật. Với TinyTeX do Oleafly quản lý, Oleafly cập nhật `tlmgr` rồi cài lại. Với một bản TeX Live hoặc TinyTeX bạn tự cài, thông báo bảo bạn chạy `tlmgr update --self`.

Khi kho chuyển sang năm TeX Live mới, một bản cài cũ hơn không cài được từ đó nữa. Oleafly khi đó cài từ kho lưu trữ cuối cùng của bản phát hành của bạn. Nếu kho lưu trữ cũng không có gói đó, thông báo yêu cầu bạn cập nhật TeX Live, hoặc dùng **Update** trên TinyTeX được quản lý trong Settings.

### Chọn nơi cài gói

`tlmgr` cài các gói từ một kho TeX Live. TinyTeX do Oleafly quản lý dùng mirror CTAN gần nhất, trừ khi bạn chọn một kho cụ thể, chẳng hạn mirror CTAN của trường đại học bạn, dưới **TeX package repository** trong **Settings → Downloads → Sources**. Bản TeX Live bạn tự cài giữ kho riêng của nó trừ khi bạn nhập một địa chỉ ở đó. Oleafly truyền địa chỉ cho `tlmgr` ở mỗi lần chạy và không bao giờ thay đổi cấu hình đã lưu của nó.

Một lần tìm gói phải kết nối tới kho có thể mất một lúc trên đường truyền chậm. Oleafly chờ tối đa 10 phút, và nếu bỏ cuộc, thông báo nêu tên kho mà nó đang chờ. Xem [Thẻ Sources](/docs/settings/downloads/#sources-tab).

### TeX Live từ một bản phân phối Linux

Trên Debian, Ubuntu và Fedora, TeX Live đến từ trình quản lý gói của hệ thống, nên Oleafly không thêm gói vào đó. Danh sách **Packages** bảo bạn dùng `apt` hoặc `dnf`, và một tệp bị thiếu nhận một thông báo kèm gợi ý thay vì **Find and install**:

- Trên Debian và Ubuntu, tìm gói bằng `apt-file search` cùng tên tệp, hoặc cài tất cả bằng `sudo apt install texlive-full`.
- Trên Fedora, thông báo đưa ra lệnh `sudo dnf install 'tex(file.sty)'` cho tệp bị thiếu.

Khi TeX của bản phân phối chưa đầy đủ, thông báo còn đề xuất **Download TinyTeX (~250 MB)**, bản mà Oleafly quản lý gói được. Trên Debian và Ubuntu, nếu bạn đã thiết lập một cây cá nhân bằng `tlmgr init-usertree`, Oleafly cài gói vào cây đó.

## Thêm gói từ trình soạn thảo

Chọn **LaTeX packages**, biểu tượng gói trên thanh công cụ trình soạn thảo LaTeX, để tìm kiếm CTAN mà không rời tài liệu. Mỗi kết quả cho biết tài liệu đã nạp nó chưa (**In document**). Trong một dự án `latexmk`, nó còn cho biết bản phân phối TeX của bạn có gói chưa (**Installed**), và **Install** thêm gói còn thiếu bằng `tlmgr`. Với TeX Live từ một bản phân phối Linux, hộp thoại bảo bạn cài gói bằng `apt` hoặc `dnf` thay vào đó.

**Add to preamble** ghi dòng `\usepackage` vào preamble. **Options** cho phép bạn thêm tùy chọn của gói trước, còn **Copy line** sao chép dòng đó thay thế. Một dự án Tectonic không có gì để cài: Tectonic tự tải gói lần đầu tiên tài liệu dùng đến nó.

## Engine nào đã biên dịch PDF của tôi?

- **Compiler (this project)** trong menu biên dịch, mũi tên bên cạnh **Recompile**, hiển thị trình biên dịch đã lưu cho dự án hiện tại.
- Bản dựng Tectonic dùng engine đi kèm ứng dụng.
- Bản dựng pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX và pLaTeX dùng `latexmk` và bản phân phối TeX được đánh dấu **In use** trong Settings.
- Bản xuất có gắn thẻ của Preflight dùng LuaLaTeX và ghi vào vị trí dựng thông thường.

## Mẫu và gói

Mẫu khai báo các gói chúng cần, và Tectonic tải các gói đó ở lần biên dịch đầu. Mẫu có phông chữ tải theo nhu cầu xử lý riêng phần phông đó. Xem [Mẫu](/docs/templates/#on-demand-fonts-the-setup-badge).
