# Tệp và thư mục

Explorer: tạo, đổi tên, di chuyển và sao chép tệp, trạng thái Git, tài liệu chính, các thẻ, khung xem ảnh và PDF, và cách tự động lưu bảo vệ công việc của bạn.

Mỗi dự án là một thư mục tệp thật, và bảng **Explorer** (thẻ đầu tiên ở thanh bên trái) là nơi bạn làm việc với nó. Dự án nhiều tệp được hỗ trợ trọn vẹn: hãy tách các chương thành từng tệp `.tex` riêng, giữ ảnh trong một thư mục, rồi việc biên dịch, điều hướng và tìm kiếm của Oleafly đều theo kịp.

![Cây tệp của LLaMA. Dùng ba nút điều khiển bên cạnh tiêu đề bảng để tạo tệp, tạo thư mục, hoặc nhập các tệp sẵn có.](https://cdn.oleafly.com/images/screenshots/desktop/docs/project-files-dark-window-v2.png#view=0,45,344,638)

![Tìm kiếm trên mọi tệp trong dự án, rồi mở một kết quả tại đúng dòng của nó.](https://cdn.oleafly.com/images/gifs/desktop/project-search.gif?v=2)

## Bảng Explorer

Thư mục được xếp trước, sau đó là tệp theo thứ tự bảng chữ cái. Nhấp vào một thư mục để mở rộng hoặc thu gọn nó, nhấp vào một tệp để mở tệp đó trong một thẻ, và dùng các phím mũi tên cộng với Enter để điều hướng hoàn toàn bằng bàn phím. Tệp **tài liệu chính** của dự án (tệp mà trình biên dịch bắt đầu từ đó) được đánh dấu bằng một ngôi sao.

Hai nút ở phần đầu bảng dùng để tạo mới: **New file** và **New folder**. Cả hai đều tạo bên trong thư mục đang được chọn, hoặc ở thư mục gốc của dự án nếu chưa chọn gì. Gõ tên ngay tại chỗ rồi nhấn Enter; tệp mới sẽ mở ngay lập tức.

Phần dọn dẹp hệ thống là vô hình: các thư mục nội bộ như `.git` và bộ nhớ đệm bản dựng không bao giờ xuất hiện trong cây, và symlink không được đi theo.

## Trạng thái Git trong cây thư mục

Khi dự án dùng Git, Explorer đánh dấu các tệp đã thay đổi bằng những chữ cái giống với [Source Control](/docs/git-history/):

| Chữ cái | Ý nghĩa |
|---|---|
| **M** | Đã sửa đổi |
| **A** | Đã thêm |
| **D** | Đã xóa |
| **R** | Đã đổi tên |
| **U** | Chưa được theo dõi (tệp mới mà Git chưa theo dõi) |
| **!** | Xung đột |

Chữ cái nằm ở cuối bên phải của hàng, và di chuột lên nó sẽ hiện tên trạng thái. Tên tệp giữ màu bình thường. Một thư mục chứa thay đổi nhận một dấu chấm thay vì chữ cái, được tô màu theo thay đổi cần chú ý nhất bên trong nó, nhờ đó một xung đột sâu trong `sections/` cũng hiển thị trên hàng `sections` ngay cả khi thư mục đang đóng.

## Menu chuột phải

Trên một **tệp**:

- **Open**
- **Set as main document** (dành cho các loại tệp mà engine của dự án biên dịch được, chẳng hạn `.tex`, `.typ`, hoặc `.md`): đặt tệp này làm điểm vào biên dịch và di chuyển ngôi sao.
- **Rename**: sửa tên ngay tại chỗ. Các thẻ đang mở, các chỉnh sửa chưa lưu và con trỏ tài liệu chính đều theo việc đổi tên, và [các đường dẫn trỏ đến tệp](#paths-follow-a-moved-file) cũng có thể như vậy.
- **Make a copy**: tạo `name copy.tex` cạnh tệp gốc. Sao chép từng byte một, nên ảnh và các tệp nhị phân khác được sao chép an toàn.
- **Delete**: xóa tệp sau khi xác nhận. Việc này không thể hoàn tác từ ứng dụng, dù [lịch sử Git](/docs/git-history/) có thể mang lại mọi thứ bạn đã commit. Trong một thư mục được mở tại chỗ, Delete sẽ chuyển tệp vào Thùng rác (Recycle Bin trên Windows) thay vì xóa.

Trên một **thư mục**: **New file**, **New folder**, **Import file(s)**, **Import folder**, **Rename**, **Make a copy** (sao chép toàn bộ thư mục theo kiểu đệ quy), và **Delete**.

## Di chuyển bằng kéo và thả

Kéo một tệp hoặc thư mục bất kỳ lên một thư mục khác để chuyển nó vào bên trong, hoặc vào vùng trống ở cuối cây thư mục để chuyển nó lên thư mục gốc của dự án. Đích thả được tô sáng khi bạn di chuột lên. Oleafly từ chối các thao tác chuyển sẽ đặt một thư mục vào bên trong chính nó.

Các tệp và thư mục được kéo vào từ trình quản lý tệp của bạn sẽ được sao chép vào thư mục dưới con trỏ. Tính năng này hoạt động trên macOS, Windows và Linux.

## Đường dẫn bám theo tệp được di chuyển

Đổi tên hoặc di chuyển một tệp có thể làm gãy các đường dẫn trỏ đến nó. Oleafly sẽ tìm và cập nhật chúng:

- Trong LaTeX: `\input`, `\include`, `\includegraphics`, `\bibliography` và các lệnh tương tự.
- Trong Typst: `#include`, `image()` và `bibliography()`.
- Trong Markdown: liên kết và ảnh.

Bạn có thể bắt đầu từ trình soạn thảo hoặc từ Explorer. Trong trình soạn thảo, đặt con trỏ lên một đường dẫn và nhấn F2, hoặc chọn **Rename file…** trong menu chuột phải. Hộp thoại **Rename file** nhận một đường dẫn đầy đủ, nên nó còn có thể chuyển tệp sang thư mục khác, và nó tự tạo các thư mục chưa tồn tại. Trong Explorer, dùng **Rename** hoặc kéo tệp sang thư mục mới.

Mặc định, Oleafly hỏi trước. Một hộp thoại liệt kê từng tệp vẫn dùng đường dẫn cũ và số tham chiếu mà tệp đó chứa. Hãy chọn **Update references** hoặc **Don't update**, và đánh dấu **Don't ask again** để giữ đáp án đó. Để thay đổi về sau, đặt **When a file moves** trong **Settings → Appearance → Editor** thành **Ask**, **Always update**, hoặc **Never update**. Một tệp đã thay đổi sau khi di chuyển, hoặc không lưu được, sẽ giữ đường dẫn cũ, và hộp thoại sẽ nói rõ điều đó.

## Các thẻ

Các tệp đang mở xuất hiện dưới dạng các thẻ phía trên trình soạn thảo, theo thứ tự bạn mở chúng. Một dấu chấm trên thẻ nghĩa là còn thay đổi chưa lưu đang chờ (chúng sẽ được tự lưu sau một lát). Các [khung xem diff](/docs/git-history/) của Git mở thành thẻ trong cùng dải, ghi nhãn bằng tên tệp cộng thêm `(Index)` hoặc `(Working Tree)`.

Đóng thẻ đang hoạt động sẽ kích hoạt thẻ trước đó. Lịch sử hoàn tác không bao giờ xuyên qua ranh giới tệp: mỗi tệp giữ riêng lịch sử của mình.

## Các loại tệp mở như thế nào

- **Tệp LaTeX và tệp văn bản** (`.tex`, `.sty`, `.cls`, `.bib`, `.md` v.v.) mở trong trình soạn thảo với tô sáng cú pháp khớp với phần mở rộng.
- **Ảnh** (`.png`, `.jpg`, `.gif`, `.webp`, `.svg` và nhiều định dạng khác) mở dưới dạng hình ảnh được kết xuất.
- **PDF** mở trong trình xem PDF.
- **Các tệp nhị phân không thể xem** (`.zip`, `.eps`, tệp phông chữ) hiển thị thông báo "Binary file. No preview available." thay vì mạo hiểm làm hỏng chúng khi tải dưới dạng văn bản.
- **Tệp `.bib`** còn được phân tích ở chế độ nền ngay khi dự án mở, và đó chính là thứ tạo nên [tự động hoàn thành trích dẫn](/docs/citations/#complete-and-navigate-references).

## Tự động lưu

Bạn không bao giờ phải nhấn lưu. Các chỉnh sửa được ghi ra đĩa khoảng 1,5 giây sau khi bạn ngừng gõ, và Oleafly làm được nhiều hơn một bộ hẹn giờ đơn giản:

- Chỉnh sửa tệp A, chuyển sang tệp B trước khi bộ hẹn giờ kích hoạt, và A vẫn được lưu.
- Đóng hoặc tải lại ứng dụng sẽ ghi hết mọi bản lưu đang chờ trước, nên việc thoát trong khoảng thời gian debounce không làm mất gì.
- Biên dịch sẽ lưu tệp đang hoạt động trước, nên PDF luôn phản ánh những gì bạn thấy.

## Thêm tệp sẵn có

Dùng **Import file(s)** hoặc **Import folder** (trong menu phần đầu bảng và menu chuột phải) để sao chép ảnh, tệp `.bib`, hoặc nguyên cả thư mục từ bất kỳ đâu trên đĩa vào dự án. Nhập vào một thư mục đang chọn sẽ đặt các bản sao ở đó; nếu không, chúng nằm ở thư mục gốc của dự án.

Vì một dự án cũng là một thư mục thông thường, nên đường đi trực tiếp cũng dùng được: thả tệp vào `~/.oleafly/projects/<project>/` bằng trình quản lý tệp của bạn, rồi mở lại dự án để Oleafly nhận chúng. Hãy sao chép khi dự án đang đóng (hoặc mở lại ngay sau đó), vì tính năng tự lưu của ứng dụng sẽ ghi ra những gì nó đang có trong bộ nhớ.
