# Cài đặt tài liệu

Thay đổi khổ giấy, lề, phông chữ, ngôn ngữ, khoảng cách dòng và đánh số trong một hộp thoại chỉnh phần mở đầu LaTeX, quy tắc #set của Typst, hoặc front matter của Markdown.

Mỗi ngôn ngữ giữ thiết lập trang ở nơi khác nhau: tùy chọn lớp và lệnh phần mở đầu trong LaTeX, quy tắc `#set` trong Typst, front matter trong Markdown. **Document settings** cung cấp cho bạn một biểu mẫu duy nhất cho tất cả. Khi bạn áp dụng, Oleafly ghi thay đổi vào tệp chính của bạn như mã nguồn thông thường mà bạn có thể đọc và chỉnh sửa sau.

Mở nó bằng nút **Document settings** ở đầu bên phải của thanh công cụ trình soạn thảo, hoặc chạy **Document settings** từ bảng lệnh ⌘K (Ctrl+K). Hộp thoại luôn chỉnh tài liệu chính của dự án, bất kể bạn đang mở tệp nào.

## Các trường

Biểu mẫu có bốn phần. Các trường tùy thuộc vào engine:

| Phần | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| Page | Page size, Columns, Margins | Page size, Margins, Columns | Document type, Document class, Page size, Columns, Margins |
| Text | Body font, Font size, Language | Body font, Font size, Language, Region | Body font, Font size, Language |
| Paragraph | Line spacing | Justification, Line spacing | Line spacing |
| Numbering | Numbered levels, Equation numbering | Heading numbering, Equation numbering | Section numbers |

Các danh sách bắt đầu bằng **Default**, giá trị này xóa thiết lập để mặc định của lớp, mẫu hoặc engine áp dụng trở lại. Để trống một trường văn bản cũng cho hiệu quả như vậy. Độ dài nhận đơn vị, chẳng hạn `2.5cm`, `1in`, hoặc `11pt`, và lề Typst còn chấp nhận `auto`. Một giá trị Oleafly không dùng được sẽ có một ghi chú ngắn dưới trường, và **Apply** chờ cho đến khi bạn sửa nó.

**Body font** gợi ý các phông chữ trong khi bạn gõ. Trong dự án Typst, danh sách chứa mọi phông chữ Typst tìm được và cho biết mỗi phông đến từ đâu: thư mục `fonts` của dự án, máy tính, hay bộ tích hợp sẵn của Typst. Trong dự án LaTeX và Markdown, nó liệt kê các phông chữ được cài trên máy tính.

Chọn **Apply** để ghi các thay đổi, hoặc **Cancel** để giữ nguyên tệp. Khi tệp chính đang mở trong trình soạn thảo, một ⌘Z (Ctrl+Z) hoàn tác toàn bộ thay đổi.

## Các giá trị đi đâu

### LaTeX

- **Page size**, **Columns** và **Font size** trở thành các tùy chọn của `\documentclass`.
- **Margins** đi đến gói geometry. Oleafly chỉnh một `\geometry{…}` hoặc tùy chọn geometry sẵn có, hoặc thêm `\usepackage[margin=…]{geometry}`.
- **Body font** ghi `\setmainfont{…}` và nạp fontspec. Trong một dự án latexmk, nó cần trình biên dịch XeLaTeX hoặc LuaLaTeX, và trường sẽ nói rõ điều đó cho đến khi bạn chọn một trình trong menu biên dịch hoặc tài liệu yêu cầu một trình, chẳng hạn bằng dòng `% !TeX program = xelatex`.
- **Language** thêm ngôn ngữ vào babel, dùng `\setdefaultlanguage` khi tài liệu nạp polyglossia, hoặc thêm `\usepackage[language]{babel}`. Hãy dùng tên babel chẳng hạn `english`.
- Trường **Line spacing** nhận **Single**, **One and a half**, **Double**, hoặc một con số chẳng hạn `1.5`. Nó dùng gói setspace, hoặc `\linespread` khi tài liệu đã có sẵn nó.
- **Numbered levels** đặt `secnumdepth`. Chọn **None**, **Chapters only**, hoặc độ sâu của việc đánh số, từ **Down to sections** đến **Down to subparagraphs**.
- **Equation numbering** ghi `\numberwithin{equation}{…}` cho **By section**, **By chapter**, hoặc **By subsection**.

### Typst

Các giá trị đi vào các quy tắc `#set` của tệp chính. Khi thiếu một quy tắc, Oleafly thêm nó gần đầu tệp:

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`, trong đó **Justification** là **Justified** hoặc **Ragged right**
- `#set heading(numbering: …)`, với các mẫu chẳng hạn `1.`, `1.1`, `1.a`, `I.`, hoặc `A.`
- `#set math.equation(numbering: …)`, với `(1)`, `(1.1)`, hoặc `1`

**Language** nhận mã hai hoặc ba chữ cái chẳng hạn `en`, còn **Region** nhận mã hai chữ cái chẳng hạn `GB`.

Dự án Typst còn có một phần **Build variants**. Mỗi biến thể là một bộ giá trị có tên mà tài liệu đọc bằng `sys.inputs`, chẳng hạn một bản nháp và một bản camera-ready. Dùng **Add variant**, đặt tên cho nó, rồi thêm từng giá trị bằng **Add value**. Chọn biến thể cần dựng từ **Variant (this project)** trong menu biên dịch.

### Markdown

Các giá trị đi vào phần front matter YAML mà Pandoc đọc khi dựng PDF: `type`, `documentclass`, `papersize`, `classoption` cho cột, `geometry` cho lề, `mainfont`, `fontsize`, `lang`, `linestretch` và `numbersections`. **Document type** cung cấp **Article**, **Report or thesis**, **Book**, **Slides**, **Poster**, **Letter** và **CV**, và quyết định tài liệu được dựng thành gì. Xem [Kiểu tài liệu](/docs/writing/markdown/#document-types). **Document class** cung cấp `article`, `report`, `book`, `scrartcl`, `scrreprt` và `memoir`. **Language** nhận một thẻ chẳng hạn `en-US`.

Ở nơi bạn chưa đặt phông chữ, Oleafly chọn một phông cho từng hệ chữ trong tài liệu, chẳng hạn tiếng Hàn, tiếng Ả Rập hoặc Devanagari. **Language** cũng quyết định phông nào mà chữ Hán nhận được: `ja` cho phông tiếng Nhật, `zh` cho tiếng Trung giản thể, và `zh-TW` cho tiếng Trung phồn thể. Xem [Văn bản bằng các ngôn ngữ khác](/docs/writing/markdown/#text-in-other-languages).

Nếu tệp chưa có front matter, hộp thoại sẽ nói vậy, và **Apply** thêm một khối ở đầu tệp. Phần front matter thiếu dòng `---` đóng phải được sửa bằng tay trước.

## Các trường chỉ đọc

Một số giá trị thuộc về thứ khác, và hộp thoại hiển thị chúng màu xám kèm lý do bên dưới:

- **Set by the … class**: các lớp như `acmart`, `IEEEtran`, `llncs` và `beamer` tự cố định lề của mình, và một số còn cố định cả khổ giấy, cỡ phông, cột, khoảng cách dòng, hoặc ngôn ngữ. Một ghi chú ở đầu hộp thoại nêu tên lớp.
- **Set by the … style**: các gói kiểu hội nghị như những gói cho NeurIPS, ICML, ICLR, CVPR và ACL đặt khổ giấy và lề. Một ghi chú ở đầu hộp thoại cho biết kiểu nào đang phụ trách.
- **The source sets each margin separately**: tài liệu đưa ra lề trái, phải, trên và dưới riêng biệt thay vì một giá trị `margin` duy nhất.
- **Set inside a conditional block**: giá trị nằm trong mã `\if…`, nên thay đổi nó ở đây có thể làm hỏng logic.
- **Set by the template**: trong Typst, quy tắc `#set` giữ giá trị có một điều kiện `if` hoặc truyền các đối số `..`, như mã mẫu thường làm, nên hộp thoại để yên nó.
- **Set by an expression in the source**: giá trị được tính ra chứ không được viết sẵn, nên hãy chỉnh mã nguồn thay vào đó.

Khi một tài liệu Typst áp dụng một mẫu, ghi chú ở đầu nói rằng các giá trị đặt bên trong mẫu không được hiển thị, và một giá trị bạn đặt ở đây sẽ ghi đè lên mẫu. Trong LaTeX, một ghi chú tương tự xuất hiện khi một phần của phần mở đầu nằm trong các tệp khác.

## Các trang liên quan

- [Gói](/docs/packages/): thêm các gói LaTeX hoặc Typst khác
- [Biên dịch](/docs/compiling/): chọn XeLaTeX hoặc LuaLaTeX, và chọn một biến thể bản dựng Typst
- [Thông tin chi tiết tài liệu](/docs/document-insights/): xem tài liệu chứa những gì
