# arXiv sang Typst

Chuyển mã nguồn LaTeX của một bài báo arXiv sang Typst, kèm bước biên dịch kiểm tra liệt kê những gì chưa được chuyển.

arXiv to Typst bắt đầu từ mã nguồn mà tác giả đã nộp, không phải từ PDF. Oleafly tải xuống hoặc giải nén e-print, chuyển tệp LaTeX chính của nó sang Typst, và biên dịch kết quả một lần để bạn thấy còn gì cần sửa.

## Khi nào dùng

- bạn muốn có cấu trúc của một bài báo arXiv trong Typst;
- bạn là tác giả đang chuyển bản nộp của mình sang Typst;
- giấy phép của bài báo cho phép kiểu tái sử dụng bạn dự định.

Để giữ bài báo trong LaTeX, hãy dùng [arXiv to LaTeX](/docs/tools/arxiv-to-latex/). Một bài báo không có gói nguồn sẽ không đi được theo con đường này. [PDF to Typst](/docs/tools/pdf-to-typst/) dựng lại mã nguồn từ PDF thay thế.

## Chuyển đổi một bài báo

1. Mở **arXiv to Typst**, hoặc chạy `/arxiv-to-typst`.
2. Trong mục **arXiv ID**, nhập một định danh như `1706.03762`. Để làm việc ngoại tuyến, chuyển sang **Saved archive** và chọn một kho nguồn `.tar.gz`, `.tgz` hoặc `.gz`.
3. Chọn **Convert**.
4. Đọc ghi chú bên dưới kết quả. Nó nêu tên tệp LaTeX chính, cho biết Typst có biên dịch được kết quả hay không, và đếm các mục chưa được chuyển. Danh sách bên dưới ghi chú trình bày từng lỗi Typst kèm số dòng và từng mục chưa được chuyển.
5. Chọn **Save ZIP** để giữ `main.typ` cùng các tệp khác của bài báo, hoặc **Create project** để mở nó như một dự án Typst.

## Quá trình chuyển đổi làm gì

Oleafly tìm tệp chính và kéo văn bản của các tệp được nạp qua `\input`, `\include` hoặc `\subfile` vào trong đó. Pandoc chuyển phần LaTeX đó sang Typst với các mục được đánh số. Các hình ảnh, tệp tài liệu tham khảo, và những tệp không phải TeX khác trong kho vẫn giữ thư mục của mình bên cạnh `main.typ`, nhờ đó tệp đã chuyển vẫn tìm được hình ảnh của nó. Sau đó Typst biên dịch tệp đã chuyển để kiểm tra.

Tra cứu một ID sẽ tải mã nguồn từ arXiv xuống và cần có kết nối mạng. Một kho đã lưu được chuyển đổi hoàn toàn trên thiết bị của bạn, bằng bản Pandoc đi kèm Oleafly.

## Những gì cần sửa thủ công

Các macro tùy chỉnh, gói lệnh chưa có phần tương đương trong Typst, hình vẽ TikZ, bảng phức tạp, và các kiểu tài liệu tham khảo là những thứ thường bị sót lại. Hãy xử lý các lỗi Typst trong danh sách trước, rồi so sánh PDF đã biên dịch với bài báo từng mục một. Typst không hiển thị được hình EPS, nên hãy chuyển những hình đó sang PDF, PNG hoặc SVG.

:::caution[Kiểm tra giấy phép trước]
Các bài báo trên arXiv mang những giấy phép khác nhau. Hãy kiểm tra giấy phép của bài báo và điều khoản của tác giả trước khi tái sử dụng văn bản hay hình ảnh của nó.
:::

Để chuyển một dự án LaTeX đã có trong Oleafly, hãy dùng **Convert to a Typst project** từ command palette. [Dự án Typst](/docs/typst/#convert-a-latex-project-to-typst) giải thích chi tiết.
