# Đồng bộ mã nguồn và PDF

Nhảy từ con trỏ đến vị trí tương ứng trong PDF, hoặc Cmd/Ctrl-nhấp vào PDF để đáp xuống đúng từ đó trong mã nguồn. Hoạt động với LaTeX qua SyncTeX và với Typst, xuyên suốt nhiều tệp.

Đồng bộ mã nguồn và PDF nối điều bạn viết với trang đã dàn chữ. Trong LaTeX nó chạy trên SyncTeX: Oleafly biên dịch với dữ liệu SyncTeX được bật ở mọi bản dựng. Trong Typst nó chạy qua máy chủ ngôn ngữ Typst, nên các cú nhảy tương tự hoạt động mà không cần thiết lập thêm. Cả hai chiều chỉ cách bạn một thao tác.

## Từ mã nguồn sang PDF: ⌘⇧J

![Go to PDF là mũi tên ở phía bên phải cùng của thanh công cụ trình soạn thảo, cạnh Find và Project info.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=1799,76,119,49)

Đặt con trỏ trên bất kỳ dòng nào và nhấn ⌘⇧J (Ctrl+Shift+J). PDF cuộn đến vị trí tương ứng và lóe lên một vùng đánh dấu màu xanh trong chốc lát, để mắt bạn đáp xuống đúng nơi con trỏ từng ở.

Bạn cũng có thể dùng mũi tên ở phía bên phải cùng của thanh công cụ trình soạn thảo, menu chuột phải của trình soạn thảo, hoặc bảng lệnh ⌘K. Dự án LaTeX gọi lệnh này là **Go to PDF (SyncTeX)**. Dự án Typst gọi là **Go to PDF**.

Tính năng này hoạt động xuyên suốt các dự án nhiều tệp. Con trỏ nằm trong `chapters/methods.tex` tìm được vị trí dàn chữ của nó trong PDF tổng hợp, vì SyncTeX đi theo cấu trúc `\input` của bạn. Typst làm điều tương tự với các tệp mà tài liệu chính bao gồm.

![Nhấp vào một từ trong PDF sẽ nhảy tới đúng từ đó trong mã nguồn.](https://cdn.oleafly.com/images/gifs/desktop/pdf-to-source.gif?v=2)

## Từ PDF về mã nguồn: ⌘-nhấp

Giữ **⌘** hoặc Ctrl và con trỏ trên PDF biến thành hình chữ thập. Nhấp một từ để nhảy đến nó trong trình soạn thảo. Oleafly mở đúng tệp trước khi văn bản đến từ một tệp khác, chẳng hạn một tệp con `\input` trong LaTeX hoặc một tệp `.typ` được bao gồm.

Oleafly đặt con trỏ trên từ bạn vừa nhấp thay vì ở đầu dòng. Trong LaTeX nó đọc lớp văn bản PDF để tìm từ đó. Typst tự báo cáo vị trí.

Một quy tắc ưu tiên: ⌘-nhấp vào một siêu liên kết trong PDF sẽ theo hành vi của liên kết thay vì nhảy.

## Dự án Typst

Đồng bộ Typst cần Typst 0.13 trở lên. Một dự án ghim vào Typst 0.11 hoặc 0.12 vẫn biên dịch bình thường, nhưng nút Go to PDF bị ẩn và ⌘-nhấp không có tác dụng. Để lấy lại đồng bộ, ghim một phiên bản mới hơn dưới **Typst version (this project)** trong menu biên dịch. [Thử một phiên bản mới hơn](/docs/typst/#try-a-newer-version-before-switching) trước nếu dàn trang của tài liệu quan trọng.

## Khi một cú nhảy không có tác dụng

Dữ liệu đồng bộ đến từ lần biên dịch gần nhất, nên nó có thể lỗi thời:

- **Bạn đã chỉnh sửa kể từ lần dựng gần nhất.** Oleafly vẫn ánh xạ chính xác các dòng chưa đổi và ánh xạ các dòng đã chỉnh sửa đến dòng chưa đổi gần nhất, nên phần lớn các cú nhảy vẫn hoạt động. Nếu một cú nhảy đáp xuống sai chỗ, hãy biên dịch lại (⌘↵) rồi nhảy lần nữa.
- **Dòng đó không tạo ra kết quả hiển thị được** (một chú thích, một dòng preamble, một quy tắc `#set`, một dòng trống). Hãy đặt con trỏ trên một dòng có văn bản đã dàn chữ.

## Những nơi tính năng không áp dụng

- [Cửa sổ xem trước tách rời](/docs/pdf-preview/#open-preview-in-a-new-window) phản chiếu PDF nhưng không nhận ⌘-nhấp. Hãy nhảy từ cửa sổ chính.
- Dự án Markdown không có đồng bộ mã nguồn và PDF.
- Dự án hình ảnh và sơ đồ bỏ qua tính năng này, vì một hình một trang không cần đến nó.
