# Trí tuệ mã nguồn

Điều hướng cấp IDE cho LaTeX và Typst: đi đến định nghĩa, tìm tham chiếu, đổi tên toàn dự án, thẻ di chuột, xem trước công thức, dàn ý tài liệu, cùng trợ lý chữ ký và định dạng của Typst.

Oleafly lập chỉ mục toàn bộ dự án, bao gồm mọi `\label`, khóa trích dẫn, macro tùy chỉnh, định lý, mục từ vựng và đồ thị `\input` nối các tệp của bạn với nhau. Chỉ mục đó điều khiển việc điều hướng giữa các tệp. Các tệp Typst dùng cùng các phím tắt đó, do máy chủ ngôn ngữ của Typst trả lời; xem phần [Tệp Typst](#typst-files) bên dưới.

Các phím tắt hiển thị phím macOS. Trên Windows và Linux, hãy đọc ⌘ là Ctrl.

## Đi đến định nghĩa: F12 hoặc ⌘-click

Đặt con trỏ lên một `\ref`, khóa `\cite`, macro tùy chỉnh, `\begin{env}` của một môi trường bạn đã định nghĩa, hoặc một mục từ vựng, rồi nhấn F12 (hoặc giữ ⌘ và nhấp vào nó). Trình soạn thảo nhảy đến nơi nó được định nghĩa, mở tệp chứa định nghĩa nếu tệp đó nằm chỗ khác trong dự án.

Nhấn F12 khi đang ở trên một định nghĩa sẽ chuyển sang tìm tham chiếu của nó, cùng quy ước mà các IDE dùng.

## Tìm tham chiếu: ⇧F12

Shift+F12 liệt kê mọi chỗ dùng ký hiệu trong bảng điều khiển **References** ở thanh bên trái: mỗi lần xuất hiện một hàng kèm tệp, dòng và phần xem trước, cùng huy hiệu "def" trên chính định nghĩa. Nhấp một hàng để nhảy đến đó. Đây là cách nhanh nhất để trả lời "mình có thể xóa nhãn này không?" hay "mình đã trích dẫn bài báo này ở đâu?"

![Nhãn của một phương trình được đổi tên trong hai tệp cùng lúc, rồi liệt kê các tham chiếu của nó.](https://cdn.oleafly.com/images/gifs/desktop/rename-symbol.gif?v=2)

## Đổi tên ký hiệu: F2

F2 đổi tên một nhãn, khóa trích dẫn, macro, định lý, mục từ vựng hoặc môi trường trên toàn bộ dự án trong một bước: tệp đang mở cập nhật ngay, các tệp khác được ghi lại trên đĩa và chỉ mục được dựng lại. Nếu tên mới đã tồn tại, việc đổi tên bị chặn trước khi kịp tạo xung đột, và một toast báo có bao nhiêu chỉnh sửa đã áp dụng vào bao nhiêu tệp.

Đổi tên `fig:overview` thành `fig:architecture` và để cả sáu `\ref` theo kịp là một thao tác hai giây.

Khi con trỏ nằm trên một đường dẫn tệp, chẳng hạn tham số của `\input` hoặc `\includegraphics`, F2 đổi tên tệp đó và cập nhật các đường dẫn trỏ đến nó. Cách này cũng hoạt động với `#include` và `image()` trong Typst, và với liên kết cùng hình ảnh trong Markdown. Xem [Đường dẫn theo tệp đã di chuyển](/docs/files/#paths-follow-a-moved-file).

## Thẻ di chuột

Di chuột lên bất kỳ ký hiệu nào và một thẻ sẽ giải thích nó:

- Trên một **tham chiếu**: loại ký hiệu, phần xem trước mã nguồn và vị trí. Sau một lần biên dịch LaTeX thành công, các tham chiếu được hỗ trợ còn hiển thị số và trang đã biên dịch.
- Trên một **định nghĩa**: nó có bao nhiêu tham chiếu trên toàn dự án.
- Trên bất cứ thứ gì **chưa được xử lý**: một nhãn "Unresolved" rõ ràng, đây là cảnh báo sớm nhất cho bạn về một `\ref` gõ sai hoặc một mục `.bib` còn thiếu.

Giữ ⌘ (Ctrl) trong khi di chuột và các ký hiệu có thể nhấp sẽ được gạch chân như liên kết; nhấp để nhảy đến.

## Xem trước công thức khi di chuột

Di chuột lên công thức inline `$…$`, `\(…\)`, hoặc công thức hiển thị `\[…\]` để dựng nó bằng KaTeX mà không cần biên dịch. Công thức hiển thị dùng kiểu display. Một biểu thức hỏng sẽ hiện lỗi của nó.

## Bảng điều khiển Outline

Bên dưới cây tệp, bảng điều khiển **Outline** hiển thị cấu trúc tài liệu của bạn: các mục thụt lề theo cấp, cùng các lệnh `\input`, xuyên suốt mọi tệp. Các mục đến từ tệp khác mang huy hiệu tên tệp. Nhấp vào bất kỳ mục nào để nhảy thẳng đến nó. Với một luận văn chia thành một chục tệp chương, đây là mục lục bạn dùng để điều hướng.

Tiêu đề các mục hiển thị dạng văn bản thường, nên một lệnh màu, một lệnh đổi phông chữ, hoặc `\nameref` trong tiêu đề sẽ không xuất hiện dưới dạng LaTeX thô. Các tiêu đề do macro của bạn tạo ra bọc quanh `\section` vẫn được liệt kê, còn các tiêu đề nằm trong một định nghĩa macro thì không.

Vạch phân chia giữa cây tệp và dàn ý có thể kéo để đổi kích thước.

## Trên thanh công cụ và menu

Cả ba lệnh điều hướng này cũng có trong menu **Code intelligence** trên thanh công cụ của trình soạn thảo (biểu tượng cặp ngoặc nhọn) và trong menu chuột phải, nên bạn có thể tìm thấy chúng trước khi các phím tắt trở thành phản xạ.

## Tệp Typst

Trong các tệp `.typ`, Tinymist, máy chủ ngôn ngữ của Typst, trả lời hầu hết các lệnh này. Oleafly chạy bản phát hành Tinymist khớp với phiên bản Typst của dự án (xem [Dự án Typst](/docs/typst/#the-language-server-follows-the-version)).

- F12 hoặc ⌘-click đi đến định nghĩa của một nhãn, biến hoặc hàm, kể cả khi nó nằm trong tệp khác.
- ⇧F12 liệt kê mọi chỗ dùng trong bảng điều khiển **References**.
- F2 đổi tên một nhãn, biến hoặc hàm trên toàn dự án.
- Di chuột lên một hàm để đọc tài liệu của nó. Di chuột lên một lệnh import `@preview` để lấy liên kết đến gói trên Typst Universe.

Cùng ba lệnh đó có trong menu **Code intelligence** trên thanh công cụ Typst, trong menu chuột phải và trong bảng lệnh ⌘K. Nhãn trong tệp Typst và tệp LaTeX được giữ riêng biệt, nên một nhãn dùng ở cả hai nơi không bị báo hai lần và việc đổi tên nhãn này không ảnh hưởng đến nhãn kia.

### Trợ lý chữ ký và gợi ý tham số

Gõ `(` sau một tên hàm và một thẻ sẽ hiện các tham số của nó, với tham số bạn đang gõ được tô sáng. Esc đóng thẻ đó. Để thấy tên tham số viết trước mỗi đối số trong các lời gọi hàm, hãy bật **Parameter name hints** trong **Settings → Appearance → Editor**, dưới mục **Typst**.

Các giá trị màu như `rgb("#1f77b4")` có một ô màu nhỏ bên cạnh. ⌘-click một liên kết hoặc đường dẫn tệp trong mã nguồn để mở nó.

### Định dạng một tệp Typst

**Format document** dọn dẹp toàn bộ tệp bằng typstyle. Nhấn ⇧⌥F (Shift+Alt+F), chuột phải trong trình soạn thảo, hoặc tìm nó trong bảng lệnh ⌘K. **Format selection** chỉ định dạng các dòng được chọn.

Nhóm **Typst** trong **Settings → Appearance → Editor** điều khiển trình định dạng:

- **Format on save** định dạng tệp Typst mỗi lần bạn nhấn ⌘S (Ctrl+S). Tự động lưu không động vào tệp. Mặc định nó tắt.
- **Formatter line width** là chỗ typstyle ngắt các dòng dài. Mặc định là 120 ký tự.
- **Formatter indent** là số khoảng trắng cho mỗi cấp. Mặc định là 2.
- **Typst lint checks** tìm các lỗi dễ gặp mỗi lần bạn lưu. Bật hay tắt nó đều khởi động lại máy chủ ngôn ngữ.

## Nhiều tài liệu trong một thư mục

Một thư mục có thể chứa nhiều hơn một bài báo, chẳng hạn `manuscript.tex` cạnh `manuscript_v1.tex` hoặc đầu ra của `latexdiff`. Mỗi tệp LaTeX có `\documentclass` riêng được tính là một tài liệu riêng, cùng với các tệp mà nó kéo vào qua `\input`, `\include`, hoặc `\subfile`. Nhãn, định lý, mục thuật ngữ và macro thuộc về tài liệu của chúng, nên một nhãn có trong ba bản của một bài báo không bị hiển thị là được định nghĩa ba lần.

Đi đến định nghĩa, tìm tham chiếu, đổi tên, hoàn thiện, [Preflight](/docs/preflight/), và `oleafly check` ở lại bên trong tài liệu bạn đang làm. Một `\ref` tới nhãn mà chỉ một tài liệu khác định nghĩa hiển thị là chưa xác định, đúng như lần biên dịch cũng báo. Các tệp mà chưa tài liệu nào bao gồm vẫn thấy mọi nhãn, và dự án chỉ có một tài liệu không bị ảnh hưởng.

## Trợ lý AI cũng thấy chỉ mục đó

[Trợ lý AI](/docs/ai-chat/) có một công cụ `project_map` dựng trên chính chỉ mục này: dàn ý, nhãn, trích dẫn, macro, đồ thị tệp và mọi tham chiếu chưa được xử lý. Khi bạn hỏi nó về "phần phương pháp", nó thực sự tìm được.
