# arXiv 轉 Typst

把 arXiv 論文的 LaTeX 原始碼轉換成 Typst，並附上編譯檢查，列出未能轉換的項目。

arXiv 轉 Typst 從作者投稿的原始碼開始，而不是從 PDF。Oleafly 會下載或解開電子預印本、把它的 LaTeX 主檔案轉換成 Typst，並編譯一次結果，讓你看到還需要修正什麼。

## 適用時機

- 你想要 arXiv 論文的結構呈現在 Typst 中；
- 你是作者，正在把自己的投稿移到 Typst；
- 論文的授權允許你打算進行的重複使用。

若要讓論文維持 LaTeX，請使用 [arXiv 轉 LaTeX](/docs/tools/arxiv-to-latex/)。沒有原始碼封存包的論文無法走這條路徑，[PDF 轉 Typst](/docs/tools/pdf-to-typst/)則是改從 PDF 重建原始碼。

## 轉換一篇論文

1. 開啟 **arXiv 轉 Typst**，或執行 `/arxiv-to-typst`。
2. 在 **arXiv ID** 下輸入識別碼，例如 `1706.03762`。若要離線作業，請切換到**已儲存的壓縮檔**，並選擇 `.tar.gz`、`.tgz` 或 `.gz` 原始碼壓縮檔。
3. 選擇**轉換**。
4. 閱讀結果下方的說明。它會列出主要的 LaTeX 檔案、說明 Typst 是否成功編譯了結果，並統計未能轉換的項目數量。說明下方的清單會列出每個 Typst 錯誤和它的行號，以及每個未能轉換的項目。
5. 選擇**儲存 ZIP**，把 `main.typ` 與論文的其他檔案一起保存，或選擇**建立專案**，把它開啟成 Typst 專案。

## 轉換會做什麼

Oleafly 會找到主檔案，並把它以 `\input`、`\include` 或 `\subfile` 載入的檔案文字拉進來。Pandoc 會把那份 LaTeX 轉換成帶有編號章節的 Typst。圖片、參考文獻檔案和壓縮檔中其他非 TeX 檔案，會在 `main.typ` 旁邊維持原本的資料夾，所以轉換後的檔案仍能找到它的圖片。最後 Typst 會編譯轉換後的檔案作為檢查。

查詢 ID 會從 arXiv 下載原始碼，需要網路連線。已儲存的壓縮檔則完全在你的裝置上，用隨 Oleafly 附帶的 Pandoc 轉換。

## 需要手動修正的地方

自訂巨集、沒有 Typst 對應物的套件、TikZ 圖片、複雜的表格和參考文獻格式，通常是剩下的問題。請先處理清單中的 Typst 錯誤，然後逐節比對編譯後的 PDF 和論文。Typst 無法顯示 EPS 圖片，請將它們轉成 PDF、PNG 或 SVG。

:::caution[先檢查授權]
arXiv 上的論文有不同的授權。重複使用論文的文字或圖片之前，請先查看該論文的授權和作者的條款。
:::

如果要轉換的是已經在 Oleafly 中的 LaTeX 專案，請改用指令面板中的**轉換為 Typst 專案**。[Typst 專案](/docs/typst/#convert-a-latex-project-to-typst)有相關說明。
