# Xuất và chuyển đổi dự án

Lưu PDF mới nhất, đóng gói mã nguồn chỉnh sửa được, xuất ảnh trang hoặc HTML, tạo PDF/A và PDF/UA từ Typst, hoặc chuyển đổi một tài liệu LaTeX, Typst hay Markdown.

Mở **Export** trong thanh công cụ dự án. Menu này bám theo engine và loại tài liệu hiện tại, nên nó chỉ hiển thị những cách xuất mà Oleafly có thể chạy cho dự án đó.

![Export là điều khiển tải xuống nằm ngay sau Recompile trong thanh dự án phía trên.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## Chọn đầu ra mà người nhận cần

- **PDF** dùng để đọc, in, và cho hầu hết các cổng nộp bài.
- **Source ZIP** dùng cho đồng tác giả hoặc các hệ thống cần bản thảo, hình, tài liệu tham khảo và các style cục bộ.
- **Page PNG** dùng cho slide, tin nhắn, hoặc hệ thống thẩm định cần một hình ảnh.
- **PNG, SVG hoặc HTML do Typst tạo ra** dùng cho các dự án Typst cần mọi trang dưới dạng hình ảnh, trang vector, hoặc một trang web.
- **Word, HTML, Markdown, Typst, LaTeX hoặc văn bản thuần** dùng cho ai cần chỉnh sửa hoặc tái sử dụng nội dung ở định dạng khác.
- **PowerPoint** dùng để chuyển một bản trình bày hoặc một tài liệu Markdown thành slide. **EPUB** dùng cho máy đọc sách điện tử. Những định dạng nào xuất hiện tùy thuộc vào engine. Xem [Xuất trình bày và sách](#presentation-and-book-exports).

## Lưu PDF, tệp nén mã nguồn hoặc ảnh trang

1. Chọn **Recompile** để đầu ra bao gồm các chỉnh sửa mới nhất của bạn.
2. Kiểm tra PDF, gồm cả các trang cuối và tài liệu tham khảo.
3. Mở **Export**.
4. Chọn **Export as PDF**, **Export source (.zip)** hoặc **Export page as PNG**.
5. Chọn nơi lưu trong hộp thoại lưu tệp.
6. Chọn **Show in folder** trong thông báo hoàn tất để tìm tệp đã lưu.

Các thao tác PDF và ảnh trang vẫn bị vô hiệu cho đến khi dự án có PDF, và menu ghi **PDF requires a compile first**. **Export as PDF** lưu PDF đang hiển thị trong bản xem trước. **Export page as PNG** lưu trang bạn đang xem trong bản xem trước, ở độ phân giải cao.

Tệp nén mã nguồn không bao gồm bộ nhớ đệm biên dịch và các tệp nội bộ của Git. Nó cũng bỏ qua các liên kết tượng trưng, và thông báo hoàn tất cho biết đã bỏ qua bao nhiêu.

### Khi PDF không còn mới

Oleafly vẫn lưu PDF hoặc ảnh trang khi bản xem trước đã cũ, và thông báo hoàn tất cho bạn biết:

- Sau một lần biên dịch thất bại, thông báo nói lần biên dịch cuối đã thất bại, nên tệp có thể chưa đầy đủ.
- Sau những chỉnh sửa chưa được biên dịch, thông báo nói tệp đến từ lần biên dịch cuối và không bao gồm các chỉnh sửa mới nhất của bạn.

Hãy biên dịch lại, kiểm tra bản xem trước, rồi xuất lại trước khi gửi tệp cho bất kỳ ai.

## Ảnh và HTML của Typst

Menu Export của một dự án Typst còn có **Images and HTML**, mở hộp thoại **Export with Typst**. Typst tự vẽ các tệp này, nên các trang PNG và SVG trông giống hệt PDF.

- **Ảnh PNG** nhận một **Resolution** là 72, 144, 300 hoặc 600 PPI.
- **Ảnh SVG** giữ các trang ở dạng đồ họa vector.
- **HTML** được đánh dấu **Experimental**. HTML của Typst giữ văn bản và hình ảnh nhưng bỏ qua thiết lập trang và các hình vẽ. Trước Typst 0.15 nó còn bỏ qua cả công thức, và hộp thoại nói rõ điều đó khi bạn chọn HTML.

Với PNG và SVG, ô **Pages** nhận số trang và các khoảng trang như `1, 3-5` hoặc `8-`. Để trống nếu muốn mọi trang. Mỗi trang được lưu thành tệp riêng, đánh số theo tên bạn chọn. Khoảng trang cần Typst 0.12 trở lên, và HTML cần Typst 0.13 trở lên. Hộp thoại chỉ đưa ra những gì phiên bản Typst của dự án làm được. Nếu dự án có [biến thể biên dịch](/docs/typst/#build-variants-and-sysinputs), lần xuất này dùng biến thể đang được chọn trong menu biên dịch.

## PDF/A và PDF/UA từ Typst

Typst tự tạo các PDF phục vụ lưu trữ và trợ năng. Mở biểu tượng **khiên** trong thanh bên dự án để vào [Preflight](/docs/preflight/), rồi tìm **PDF standards** dưới mục kiểm tra **Accessibility**. Chọn một **Standard**, ví dụ PDF/A-2b hoặc PDF/UA-1, rồi chọn **Export PDF**.

Danh sách này tùy thuộc vào phiên bản Typst của dự án. Typst 0.11 không có tiêu chuẩn nào, Typst 0.12 cung cấp PDF/A-2b, Typst 0.13 bổ sung PDF/A-3b, và Typst 0.14 trở lên cung cấp mọi cấp độ PDF/A cùng PDF/UA-1. Typst 0.14 trở lên cũng gắn thẻ cho mọi PDF để dùng với trình đọc màn hình, nên không cần một bước biên dịch gắn thẻ riêng. PDF/UA-1 cần tiêu đề tài liệu và văn bản thay thế cho mọi hình, và Preflight kiểm tra cả hai.

## Các định dạng chỉnh sửa được

| Engine của dự án | Định dạng trong Export |
| --- | --- |
| **LaTeX** | Word, HTML tự chứa với MathML, Markdown, Typst và văn bản thuần |
| **Typst** | LaTeX, Word, HTML tự chứa với MathML, Markdown và văn bản thuần |
| **Markdown** | Word, HTML tự chứa với MathML, Typst, LaTeX và văn bản thuần |

Dự án Typst còn cung cấp EPUB, và dự án Markdown cung cấp PowerPoint cùng EPUB. Dự án LaTeX chỉ cung cấp chúng khi có hạng tài liệu tương ứng.

Các chuyển đổi này chạy cục bộ qua Pandoc. Oleafly dùng một bản cài đặt tương thích trên máy của bạn, hoặc tải xuống một bản dựng được quản lý và đã kiểm chứng vào lần đầu tiên cần đến.

Dự án Typst đi một hướng khác. Typst ghi tài liệu thành HTML trước, rồi Pandoc chuyển HTML đó thành Word, HTML, Markdown, LaTeX, văn bản thuần hoặc EPUB, nhờ vậy các công thức và tham chiếu được giữ lại. Việc một tài liệu đi được hướng đó hay không tùy thuộc vào phiên bản Typst của dự án:

| Phiên bản Typst | Hướng xử lý |
| --- | --- |
| 0.15 trở lên | Qua HTML |
| 0.13 và 0.14 | Qua HTML khi Typst ghi được toàn bộ tài liệu. Khi không ghi được, Pandoc đọc mã nguồn Typst thay vào đó. |
| 0.12 trở xuống | Pandoc đọc mã nguồn |

Nếu Typst dừng với một lỗi khi ghi HTML, Pandoc đọc mã nguồn trên mọi phiên bản. Khi Pandoc đọc mã nguồn trên Typst 0.13 hoặc 0.14, thông báo hoàn tất cảnh báo rằng văn bản bị xoay, co giãn, dịch chuyển hoặc nghiêng có thể bị thiếu, trừ khi lần xuất có cảnh báo. Để có bản xuất đầy đủ nhất, chuyển dự án sang Typst 0.15 trở lên dưới **Typst version (this project)** trong menu biên dịch.

Khi lần xuất đi qua HTML, văn bản bên trong các hàm bố cục như `align`, `grid` và `rotate` vẫn được giữ. Một hình vẽ bằng CeTZ mất các đường nét và hình khối, chỉ giữ lại các nhãn văn bản, và thông báo hoàn tất nêu tên những gì Typst đã bỏ qua.

## Chuyển đổi một tài liệu

1. Biên dịch một lần và sửa mọi lỗi trong mã nguồn.
2. Mở **Export** và chọn định dạng đích.
3. Hoàn tất cài đặt Pandoc nếu được nhắc. Nếu Oleafly báo Pandoc không khả dụng, chọn **Repair Pandoc** trong **Settings → Engines → Markdown**, rồi xuất lại.
4. Lưu tệp đã chuyển đổi với phần mở rộng được gợi ý.
5. Đọc thông báo hoàn tất. Nếu nó nhắc đến cảnh báo, chọn **Show warnings** để xem lần xuất đã bỏ qua những gì.
6. Mở tệp trong ứng dụng đích và kiểm tra cấu trúc cùng hình thức của nó.

Để thử nhanh, hãy xuất một đoạn ngắn chứa tiêu đề, công thức, bảng, hình và trích dẫn. Nếu năm phần tử đó giữ được nguyên vẹn, hãy chuyển đổi toàn bộ bản thảo và xem xét lại.

Để biến cả một dự án LaTeX thành dự án Typst mà bạn tiếp tục làm việc, hãy dùng [Chuyển đổi thành dự án Typst](/docs/typst/#convert-a-latex-project-to-typst). Tính năng này tạo một dự án mới và báo cáo những gì cần chú ý.

### Chuyển đổi giữ lại những gì

Pandoc hướng tới việc giữ nguyên tiêu đề, đoạn văn, danh sách, liên kết, trích dẫn, bảng, hình và các công thức chỉnh sửa được. Nó không thể tái tạo mọi tính năng của ngôn ngữ nguồn trong mọi đích đến. Hãy kiểm tra kỹ những khu vực sau:

- lệnh và môi trường LaTeX tùy chỉnh
- bố cục trang tinh chỉnh thủ công hoặc các khối float
- bảng phức tạp hoặc lồng nhau
- kiểu danh mục tài liệu tham khảo và cách hiển thị trích dẫn
- hàm Typst không có tương đương trực tiếp ở đích đến
- HTML thô hoặc phần mở rộng của Markdown

Bản HTML nhúng sẵn tài nguyên của nó và ghi các công thức dưới dạng MathML. Điều này khiến nó hữu ích khi chia sẻ một tài liệu cần tự mở được, nhưng bạn vẫn nên thử nó trên các trình duyệt mà độc giả của bạn dùng.

### Mỗi định dạng giữ lại những gì

- Bản xuất Word và PowerPoint chuyển hình PDF, SVG và WebP thành ảnh PNG ở 220 ppi. Một hình không có kích thước trong mã nguồn giữ chiều rộng riêng của nó.
- Bản xuất HTML và EPUB chuyển hình PDF thành ảnh PNG.
- Markdown và văn bản thuần xuất từ LaTeX giữ tiêu đề, tác giả và phần tóm tắt.
- Bản xuất sang Markdown hoặc Typst từ LaTeX, và sang LaTeX hoặc Typst từ Markdown, liên kết đến các tệp hình của dự án thay vì sao chép chúng. Trừ khi lần xuất có cảnh báo, thông báo hoàn tất nhắc bạn sao chép các hình và tệp tài liệu tham khảo cạnh tệp đã xuất trước khi biên dịch nó. Một tài liệu Markdown xuất sang Typst hoặc LaTeX giữ tài liệu tham khảo mà nó khai báo, hoặc các tệp `.bib` của dự án nếu nó không khai báo.
- Bản xuất LaTeX của một tài liệu Markdown theo [kiểu tài liệu](/docs/writing/markdown/#document-types) của nó. Slide và poster trở thành mã nguồn Beamer, một báo cáo hoặc sách bắt đầu các chương ở các tiêu đề `#`, và một bức thư trở thành thư KOMA-Script.
- Bản xuất LaTeX từ Typst sao chép các hình của tài liệu vào một thư mục `<name>-media` cạnh tệp `.tex`. Ảnh SVG, GIF và WebP trở thành PDF ở đó, vì LaTeX không đọc được chúng.

Các lần xuất tìm hình trong thư mục của tài liệu chính, thư mục gốc dự án và mọi thư mục `\graphicspath`, và chúng tìm được cả hình được gọi tên không có phần mở rộng. Hình EPS không chuyển đổi được, nên chúng đi vào tệp nguyên trạng, kèm một cảnh báo. Trong bản xuất Word, HTML, EPUB hoặc PowerPoint của một tài liệu Markdown, một khối Mermaid hiển thị hình đã được lưu cho nó.

### Cảnh báo sau khi xuất

Pandoc bỏ qua những gì một định dạng không chứa được. Khi điều đó xảy ra trong một lần xuất từ dự án LaTeX hoặc Markdown, hoặc một lần xuất Typst đọc mã nguồn, thông báo hoàn tất nói rằng tệp được lưu kèm cảnh báo và có bao nhiêu cảnh báo, thay cho các ghi chú khác của nó, chẳng hạn lời nhắc sao chép hình. Chọn **Show warnings** để mở **Export warnings**, danh sách những gì đã bị thiếu. **Show in folder** trong hộp thoại đó mở thư mục chứa tệp đã lưu.

Danh sách có thể nêu:

- một khối mà lần xuất đã bỏ qua, kèm tệp và dòng khi biết, chẳng hạn một `tikzpicture`, một `\includepdf`, hoặc một lệnh lớp phủ Beamer như `\only` hay `\uncover`
- một hình mà lần xuất không tìm thấy hoặc không chuyển đổi được
- một khóa trích dẫn không có trong tài liệu tham khảo
- công thức vẫn ở dạng mã TeX
- tham chiếu chưa có số, mà một lần biên dịch sẽ sửa

Một cảnh báo lặp lại chỉ xuất hiện một lần, và danh sách dừng ở 50. Một bản xuất PowerPoint hoạt động khác khi thiếu hình: nó dừng lại, không lưu tệp nào, và lỗi nêu tên hình. Các bản xuất Typst đi qua HTML cho biết Typst đã bỏ qua gì ngay trong thông báo hoàn tất.

## Xuất trình bày và sách

Dự án LaTeX gắn các tùy chọn này với hạng tài liệu của nó. **Export as PowerPoint (.pptx)** xuất hiện với bản trình bày Beamer, và **Export as EPUB (.epub)** với các hạng `book`, `report`, `memoir`, `scrbook` và `scrreprt`.

Trong một bộ slide Beamer, mỗi frame bắt đầu một slide mới, `\section` thêm một slide phần, còn `\subsection` không thêm gì. Một frame có nhiều hơn một hình, hoặc có một hình cùng nội dung khác, có thể tràn sang slide thứ hai.

Trong các dự án Typst và Markdown, menu không kiểm tra tài liệu cho các lần xuất này. Dự án Markdown luôn cung cấp cả hai, và dự án Typst luôn cung cấp EPUB. Khi một tài liệu Markdown trở thành PowerPoint, mỗi tiêu đề cấp 1 trở thành một slide phần và mỗi tiêu đề cấp 2 bắt đầu một slide mới. Ngoại lệ là một tài liệu có `type: slides`: một dòng `slide-level` trong front matter chọn cấp tiêu đề bắt đầu một slide. Mọi EPUB đều có mục lục, và các công thức của nó là MathML.

Hãy dùng các kết quả này làm điểm khởi đầu chỉnh sửa được. Bố cục slide và typography sách hiếm khi tương ứng một-một giữa các định dạng, nên hãy xem xét từng slide hoặc chương trong ứng dụng đích.

## Xuất một hình độc lập

Dự án hình độc lập cung cấp **Export as PDF (vector image)** và **Export as PNG** sau khi biên dịch. Chọn PDF để có nét vẽ và chữ sắc nét ở mọi tỉ lệ. Chọn PNG khi nơi nhận chỉ chấp nhận ảnh raster.

## Lưu đầu ra bên trong dự án

[Bản xem trước PDF](/docs/pdf-preview/) cũng cung cấp **Save PDF to project**. Tính năng này giữ một bản để nộp hoặc hình đã biên dịch ngay cạnh mã nguồn. Để giữ bản đó luôn mới, hãy bật [Đồng bộ PDF khi biên dịch](/docs/pdf-preview/#sync-pdf-on-compiles) trong cùng menu, và Oleafly sẽ làm mới một PDF đặt theo tên dự án sau mỗi lần biên dịch thành công. Có thể lưu một PDF cũ hơn từ một [điểm khôi phục](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) mà không cần khôi phục dự án. Chỉ thêm tệp đó vào [lịch sử Git](/docs/git-history/) khi bạn có chủ ý quản lý phiên bản cho đầu ra được tạo ra.

## Kiểm tra trước khi chia sẻ

Chạy [Preflight](/docs/preflight/) trước khi nộp bài. Nếu bạn cần PDF có gắn thẻ, hãy theo quy trình xuất trợ năng cho LaTeX hoặc chọn một tiêu chuẩn PDF/UA trong dự án Typst, rồi kiểm chứng kết quả bằng một công cụ kiểm tra PDF/UA độc lập và một lượt xem xét trợ năng bởi con người. Preflight kiểm tra nhiều tín hiệu hữu ích, nhưng nó không chứng nhận sự tuân thủ.
