# Giao diện và chủ đề

Thiết lập ứng dụng, trình soạn thảo, terminal và chế độ xem PDF theo cách bạn làm việc.

Mở **Settings → Appearance**. Chọn thẻ tương ứng với phần không gian làm việc bạn muốn thay đổi. Các thay đổi có hiệu lực cục bộ; chúng không làm thay đổi định dạng của tài liệu đã xuất.

![Settings → Appearance → App. Chọn vị trí dock, họa tiết nền, màu nhấn, phông chữ và chủ đề tại đây.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-appearance-dark-window-v2.png#view=519,89,883,902)

## Vị trí dock

Trong thẻ App, chọn **Left**, **Bottom** hoặc **Right**. Thao tác này di chuyển dock ở màn hình chính, nơi chứa New project, tìm kiếm, công cụ và Settings. Hãy thử Bottom khi bạn muốn thư viện chiếm toàn bộ chiều rộng giữa hai lề.

## Họa tiết nền

Chọn **Dots**, **Grid** hoặc **None** cho phần nền của thư viện dự án. None cho kệ thư viện một nền trơn màu; trình soạn thảo tài liệu vẫn giữ chủ đề riêng của mình.

## Màu nhấn

Chọn một ô màu để thay đổi màu nhấn khi chọn và khi thao tác của ứng dụng. Thay đổi này chỉ ảnh hưởng đến màu giao diện; màu của hình vẽ và kiểu LaTeX hay Typst của tài liệu vẫn do bạn kiểm soát trong tệp nguồn.

## Chế độ hiển thị

Trong mục **Appearance**, chọn Light, Dark hoặc System; System sẽ theo hệ điều hành của bạn và thay đổi khi hệ điều hành thay đổi. Nút chuyển chế độ hiển thị trên thanh công cụ chính là cách chuyển nhanh hơn trong lúc làm việc. Trình soạn thảo cũng đổi theo, sang chủ đề bạn đã chọn cho chế độ đó. Xem [Chủ đề trình soạn thảo](#editor-themes).

## Cỡ chữ ứng dụng

Dùng **App font size** để phóng to hoặc thu nhỏ mọi chữ trên giao diện, từ 13 đến 20 px. Tiêu đề mục, huy hiệu đếm số và các nhãn nhỏ khác cũng co giãn theo. Để chữ trong mã nguồn lớn hơn, hãy dùng Editor font size, hoặc bật [Use the app font](#use-the-app-font).

## Thu phóng

**Zoom** làm mọi thứ trong Oleafly to lên hoặc nhỏ lại, kể cả trình soạn thảo và PDF. Chọn một mức từ 80% đến 200%. Trong lúc làm việc, nhấn ⌘= và ⌘- (Ctrl+= và Ctrl+- trên Windows và Linux) để thay đổi, và nhấn ⌘0 (Ctrl+0) để quay lại 100%. Mọi cửa sổ Oleafly dùng cùng một mức và Oleafly ghi nhớ mức đó. Bạn có thể đổi phím trong **Settings → Keyboard Shortcuts**.

## Phông chữ ứng dụng

Chọn bất kỳ phông chữ nào đã cài trên máy của bạn cho menu, panel và hộp thoại. Tên mỗi phông trong danh sách được hiển thị bằng chính phông đó. Gõ để tìm trong danh sách, hoặc gõ một tên không có trong danh sách. Các phông ký hiệu như Wingdings bị bỏ qua vì chúng sẽ biến mọi chữ cái thành hình. Nếu phông bạn đã lưu không còn được cài đặt, phần ghi chú dưới tùy chọn sẽ cho biết và Oleafly dùng phông mặc định.

Phông ứng dụng không làm thay đổi phông được biên dịch vào PDF. Phông của tài liệu phải nằm trong mẫu hoặc trong tệp nguồn của bản thảo.

## Cỡ chữ trình soạn thảo

![Settings → Appearance → Editor. Các tùy chỉnh phông chữ, chủ đề, tổ hợp phím, gợi ý hoàn thiện, dấu ngoặc và con trỏ nằm trong thẻ này.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-editor-dark-window-v2.png#view=519,89,883,902)

Mở thẻ **Editor** và chọn cỡ từ 11 đến 24 px, hoặc chọn **Custom** và nhập một cỡ bất kỳ từ 6 đến 100 px. Khi trình diễn qua chia sẻ màn hình, hãy thử 18 px cùng **Layout → Editor Only** để thanh công cụ và mã nguồn vẫn dễ đọc.

## Dùng phông chữ ứng dụng

Bật **Use the app font** để trình soạn thảo dùng phông chữ và cỡ chữ ứng dụng từ thẻ App. Khi tùy chọn này đang bật, các điều khiển phông chữ và cỡ chữ riêng của trình soạn thảo sẽ bị khóa, và chú giải của chúng cho biết lý do.

## Phông chữ trình soạn thảo

Chọn bất kỳ phông chữ nào đã cài trên máy của bạn cho các tệp nguồn. Các phông đơn cách đứng đầu danh sách, và tên mỗi phông được hiển thị bằng chính phông đó. Gõ để tìm, hoặc gõ một tên không có trong danh sách. **System default** quay về phông nguồn mặc định của ứng dụng. Tùy chọn này ảnh hưởng đến các tệp `.tex`, `.typ`, `.md` và các tệp văn bản khác trong trình soạn thảo.

## Chủ đề trình soạn thảo

Trình soạn thảo có một chủ đề cho chế độ sáng và một chủ đề cho chế độ tối. Chọn chúng trong **Theme in light mode** và **Theme in dark mode**, và trình soạn thảo sẽ đổi chủ đề khi ứng dụng đổi. **Match app theme** dùng đúng bộ màu sáng hoặc tối của ứng dụng. Các lựa chọn khác là Linear, GitHub Dark, Dracula, Nord, Tokyo Night, Rosé Pine, Catppuccin, One Dark, Paper và One Light. Paper, một màu trắng ngà ấm, cùng One Light là hai chủ đề sáng.

Cả hai danh sách đều chấp nhận bất kỳ chủ đề nào, nên bạn có thể giữ trình soạn thảo tối trong khi phần còn lại của ứng dụng sáng. Chủ đề bạn chọn ở phiên bản cũ sẽ được dùng cho cả hai chế độ cho đến khi bạn thay đổi một trong hai.

## Màu trình soạn thảo

Mở **Editor colors** để thay đổi bất kỳ màu nào của một chủ đề trình soạn thảo. Chọn **Light mode** hoặc **Dark mode** để chỉnh chủ đề được đặt cho chế độ đó. Chữ bên cạnh các nút đó nêu tên chủ đề bạn đang chỉnh. Bên dưới, chọn **LaTeX**, **Typst** hoặc **Markdown** để xem một đoạn mẫu ngắn bằng ngôn ngữ đó. Đoạn mẫu hiển thị thay đổi của bạn ngay khi bạn thực hiện.

Các màu được nhóm theo vai trò, và một vai trò có cùng ý nghĩa trong cả ba ngôn ngữ:

| Nhóm | Màu sắc |
|---|---|
| **Editor** | Background, Text, Line numbers, Selection |
| **Syntax** | Commands, Preamble and imports, Headings, Formatting, Environments, Citations and references, Math, Values and strings, Names and keys, Links, Brackets and symbols, Comments |

Nhấn vào một ô màu để chọn màu. Một màu bạn đã đổi sẽ có mũi tên đặt lại để trả về màu gốc của chủ đề, và **Reset** xóa mọi thay đổi của chủ đề đó. Oleafly lưu các thay đổi cho từng chủ đề riêng biệt, nên chúng quay lại khi bạn chuyển về chủ đề ấy. **Match app theme** giữ một bộ cho chế độ sáng và một bộ cho chế độ tối. **Export theme** trong [Tùy chỉnh chủ đề](#theme-customization) sẽ lưu chủ đề và màu trình soạn thảo của bạn cùng với phần còn lại của chủ đề.

## Tổ hợp phím

Chọn bộ phím cho trình soạn thảo nguồn: **Default**, **Vim** hoặc **Emacs**. Với Vim, nhấn `i` để vào chế độ Insert và nhấn Esc để quay về chế độ Normal. Thay đổi được áp dụng ngay, và **Default** trả về các tổ hợp phím thông thường của trình soạn thảo. Xem [Phím Vim và Emacs](/docs/editor/#vim-and-emacs-keys).

## Cỡ tab

**Tab size** đặt số dấu cách được chèn cho một mức thụt lề, và độ rộng hiển thị của một ký tự tab: 2, 4 hoặc 8. Mặc định là 4.

## Chiều cao dòng

Chọn **Compact**, **Normal** hoặc **Wide** cho khoảng cách giữa các dòng nguồn, hoặc **Custom** cho một giá trị chính xác từ 1 đến 3.

## Khoảng cách chữ

**Letter spacing** thêm khoảng trống giữa các ký tự: +0.5, +1 hoặc +1.5 px, hoặc một giá trị **Custom** tới 4 px. Khoảng trống này cũng tạo thêm không gian xung quanh con trỏ.

## Độ rộng con trỏ

Đặt độ rộng con trỏ trình soạn thảo thành 1, 2 hoặc 3 px.

## Màu con trỏ

**Cursor color** có một ô màu cho chủ đề trình soạn thảo sáng và một ô cho chủ đề tối, nhờ vậy màu bạn chọn trên trang trắng sẽ không bị mất tích dưới chủ đề tối. Cho đến khi bạn chọn một màu, mỗi ô hiển thị màu con trỏ gốc của chủ đề. **Use theme colors** quay về màu của chủ đề. Con trỏ khối của Vim và dấu mũ trong chế độ Visual của Markdown dùng cùng một màu.

## Con trỏ không nhấp nháy

Bật **Non-blinking cursor** để con trỏ soạn thảo luôn hiển thị liên tục. Điều này giúp điểm chèn dễ theo dõi hơn khi đọc hoặc trình bày mã nguồn.

## Ngắt dòng dài

Mặc định, các dòng dài được tự ngắt. Tắt **Wrap long lines** để cuộn ngang thay vì ngắt dòng.

## Tự động hoàn thiện

Bật **Auto-complete** để hiển thị gợi ý trong khi bạn gõ. Khi tắt, nhấn Ctrl+Space khi bạn muốn danh sách hoàn thiện. Xem [Tự động hoàn thiện](/docs/autocomplete/) cho trích dẫn, lệnh, đường dẫn và ký hiệu.

## Tự đóng ngoặc

Bật **Auto-close brackets** để tự động chèn dấu ngoặc đóng tương ứng khi bạn gõ dấu mở. Hãy thử gõ `(` trong một tệp nguồn: con trỏ nằm giữa cặp ngoặc để bạn nhập nội dung.

## Tự đóng công thức

Bật **Auto-close math** để tự ghép cặp `$`, `\(` và `\[` khi bạn gõ. Trong Typst, việc ghép cặp `$` cần cả công tắc này lẫn **Auto-close brackets**.

## Tự đóng môi trường

Bật **Auto-close environments** để chèn `\end` tương ứng khi bạn nhấn Enter sau một dòng `\begin`.

## Gợi ý trực tiếp

Bật **Inline suggestion** để hiển thị phần hoàn thiện khả thi ngay sau con trỏ. Nhấn Tab để chấp nhận một gợi ý đang hiển thị. Đây là một điều khiển hoàn thiện của trình soạn thảo. Việc kết nối mô hình là một bước riêng trong AI Assistant.

## Cuộn dính

Bật **Sticky scroll** để giữ các mục, tiêu đề và môi trường hiện tại ở đầu khung mã nguồn trong khi bạn cuộn. Hãy dùng nó trong một phần Phương pháp dài để giữ được cấu trúc xung quanh mà không phải nhảy ngược lại tiêu đề.

## Xem trước công thức

Bật **Math preview** để hiển thị phương trình đã kết xuất ngay phía trên phương trình chứa con trỏ. Xem [Xem trước công thức](/docs/editor/#math-preview).

## Khi một tệp được di chuyển

Đổi tên hoặc di chuyển một tệp có thể để lại trong mã nguồn những đường dẫn vẫn dùng tên cũ. **When a file moves** quyết định Oleafly sẽ xử lý chúng thế nào. **Ask** liệt kê các đường dẫn và cho bạn cập nhật hoặc giữ nguyên, **Always update** thay đổi chúng mà không hỏi, còn **Never update** để nguyên. Xem [Đường dẫn theo tệp đã di chuyển](/docs/files/#paths-follow-a-moved-file).

## Định dạng và gợi ý Typst

Nhóm **Typst** ở cuối thẻ Editor chứa **Format on save**, **Formatter line width**, **Formatter indent**, **Parameter name hints** và **Typst lint checks**. Mỗi tùy chọn được giải thích trong [Code intelligence](/docs/code-intelligence/#format-a-typst-file).

## Cỡ chữ terminal

![Settings → Appearance → Terminal. Thiết lập chữ, con trỏ, hành vi khi khởi động và màu terminal tại đây.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-terminal-dark-window-v2.png#view=519,89,883,902)

Trong thẻ **Terminal**, chọn cỡ chữ cho phần nhập và phần xuất của shell. Tăng cỡ chữ trước khi chia sẻ một buổi trình diễn lệnh; tùy chọn này không ảnh hưởng đến trình soạn thảo tài liệu.

## Phông chữ terminal

Chọn phông đơn cách cho terminal. Hãy dùng một phông có dấu câu rõ ràng khi cần đọc đường dẫn của trình biên dịch và các lệnh shell.

## Độ đậm phông thông thường

Đặt độ đậm dùng cho chữ terminal thông thường. Hãy so sánh vài dòng đầu ra trước khi chọn độ đậm cao hơn, đặc biệt trên nền tối.

## Độ đậm phông in đậm

Đặt độ đậm cho đầu ra terminal yêu cầu chữ in đậm. Giá trị này có thể khác độ đậm thông thường để tiêu đề và chẩn đoán lệnh vẫn phân biệt được.

## Kiểu con trỏ

Chọn hình dạng con trỏ terminal trong **Cursor style**. Điều khiển này ảnh hưởng đến dấu mũ của shell, không phải dấu mũ của trình soạn thảo.

## Con trỏ nhấp nháy

Bật **Blink cursor** để con trỏ terminal nhấp nháy. Tắt nó nếu bạn muốn điểm chèn của terminal đứng yên.

## Khởi động shell cùng dự án

Bật **Start shell with project** để khởi động shell khi bạn mở một dự án. Khi tắt, shell khởi động khi bạn lần đầu tiên mở terminal. Dùng cách sau nếu bạn hiếm khi cần làm việc qua dòng lệnh.

## Chủ đề màu terminal

Chọn một chủ đề màu cho terminal, hoặc để nó theo ứng dụng. Mở một terminal có vài dòng đầu ra để so sánh chữ lệnh, thông báo lỗi và con trỏ.

## Màu nền terminal

Dùng bộ chọn màu nền trong **Terminal colors** để chọn bề mặt hiển thị của terminal. Kết hợp với một màu chữ vẫn đọc được.

## Màu chữ terminal

Chọn màu chữ mặc định cho đầu ra terminal. Các chương trình vẫn có thể tự xuất màu ANSI của riêng chúng.

## Màu con trỏ terminal

Chọn màu con trỏ nổi bật so với cả nền lẫn chữ. Điều này hữu ích khi dấu nhắc lệnh của shell chứa nhiều màu.

## Chế độ tối cho PDF

![Settings → Appearance → PDF Preview. Thiết lập màu PDF mặc định và phần xem trước khi di chuột tại đây.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-pdf-dark-window-v2.png#view=519,89,883,436)

Trong thẻ **PDF Preview**, bật **PDF dark mode** để đảo ngược màu xem trước theo mặc định. Tùy chọn này thay đổi phần hiển thị, không phải PDF đã xuất. Bạn có thể bật tắt cho khung xem hiện tại từ thanh công cụ PDF.

## Chỉ thu phóng PDF

⌘= và ⌘- (Ctrl+= và Ctrl+-) sẽ [thu phóng toàn bộ ứng dụng](#zoom), kể cả PDF, ngay cả khi PDF đang là trọng tâm. Để chỉ thu phóng PDF, hãy dùng các nút thu phóng trên thanh công cụ xem trước, chụm hai ngón trên trackpad, hoặc giữ Ctrl và cuộn. Dùng menu thu phóng để khớp trang theo chiều rộng hoặc chiều cao.

## Xem trước PDF khi di chuột

Bật **Preview PDF on hover** để hiển thị trang mới biên dịch nhất khi bạn di chuột lên một dự án trong thư viện. Hãy biên dịch tài liệu trước để kệ có trang hiển thị.

## Chế độ trang chủ mặc định

![Settings → Appearance → Project. Thiết lập bố cục khi mở và hành vi của cây tệp, rồi quản lý các mẫu tệp ẩn.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-project-dark-window-v2.png#view=519,89,883,902)

Chọn thư viện mở dưới dạng lưới hay danh sách. Dạng lưới nhấn mạnh bìa và phần xem trước; dạng danh sách giúp quét tên dự án dễ hơn.

## Mở dự án trong

Chọn khung nguồn, khung chia đôi hoặc khung PDF ban đầu. Đây là bố cục khởi đầu khi bạn vào một dự án. [Thanh công cụ dự án](/docs/project-toolbar/) có thể thay đổi bố cục này trong lúc bạn làm việc.

## Hiện cây tệp khi mở

Bật tùy chọn này để mở Explorer cùng mỗi dự án. Tắt nó để có thêm không gian viết, rồi khi cần tệp, hãy mở **Explorer**, thẻ đầu tiên trong thanh bên trái.

## Tệp ẩn

Nhập một tên tệp hoặc chuỗi mẫu và chọn **Add** để ẩn các mục khớp khỏi Explorer. Ví dụ, ẩn một tên tệp phụ gây xao nhãng bản thảo. Gỡ khối chip của nó để hiển thị lại. Ẩn một tệp không có nghĩa là xóa nó.

## Cài đặt chế độ Zen

Nhóm **Zen mode** ở cuối thẻ **Project** có hai công tắc. **Go full screen** chiếm toàn bộ màn hình khi [chế độ Zen](/docs/editor/#zen-mode) đang bật và khôi phục cửa sổ khi bạn thoát. **Show the PDF when you compile** mở PDF bên cạnh trình soạn thảo mỗi lần bạn biên dịch trong khi PDF đang ẩn. Phím bật tắt chế độ Zen nằm trong **Settings → Keyboard Shortcuts**.

## Tùy chỉnh chủ đề

Ở cuối thẻ **App**, mở **Theme customization**, chọn chế độ sáng hoặc tối để chỉnh, rồi thay đổi từng token màu. Nhấn vào vòng màu của một token để chọn màu bằng bộ chọn màu của hệ thống. Hai chế độ có giá trị tách riêng, và mỗi ô màu hiển thị màu mặc định của chế độ đó cho đến khi bạn thay đổi. Sau khi thay đổi, hãy kiểm tra chữ, vùng chọn, panel và nút. Màu bên trong trình soạn thảo có một mục riêng, [Màu trình soạn thảo](#editor-colors).

### Bo góc

Nhập một độ dài CSS như `8px`, `0.5rem` hoặc `1em`. Xóa giá trị để dùng mặc định. Thay đổi này điều chỉnh góc của các thành phần giao diện trong ứng dụng.

### Khai báo CSS có phạm vi

Chỉ nhập các khai báo, chẳng hạn một giá trị thuộc tính tùy chỉnh được hỗ trợ. Trường này không chấp nhận quy tắc CSS hoàn chỉnh, lệnh import, hay URL. Giá trị không hợp lệ sẽ được báo lỗi thay vì được áp dụng.

### Nhập và xuất chủ đề

Chọn **Export theme** để lưu một tệp chủ đề dùng lại được. Tệp chứa các token màu, độ bo góc và CSS có phạm vi, cùng với chủ đề trình soạn thảo cho chế độ sáng và chế độ tối và [màu trình soạn thảo](#editor-colors) của bạn. **Import theme** áp dụng một tệp đã lưu. Dùng nút đặt lại để khôi phục mặc định cho phần tùy chỉnh này.

## Thử một cấu hình viết

Đặt chữ mã nguồn thành 16 px, bật Sticky scroll, mở một tài liệu LaTeX dài, rồi chọn **Layout → Editor + Preview**. Kéo thanh chia cho đến khi các dòng mã nguồn dễ đọc. Biên dịch và chọn **Fit to width** trong phần xem trước. Hãy lưu thiết kế chữ của tài liệu trong tệp nguồn của nó; còn Appearance dùng cho môi trường đọc của riêng bạn.

## Đặt lại về mặc định

Chọn **Reset to defaults** ở cuối phần Appearance để khôi phục các tùy chọn của nó. Việc đặt lại cũng xóa phần Theme customization. Một chấm trên nút cho biết có gì đó trong Appearance khác với mặc định. Hãy đọc kỹ nội dung xác nhận trước khi áp dụng đặt lại.