# arXiv 轉 LaTeX

把 arXiv 原始碼壓縮檔開啟成可編輯的 LaTeX 專案，不必從 PDF 反推。

論文的原始碼若能取得，就從那裡開始。arXiv 轉 LaTeX 會下載投稿的原始碼封存包、找出它的主文件，並把輔助檔案放在一起。這通常比轉換 PDF 保留更多結構。

## 適用時機

- 你想研究一篇 arXiv 論文是如何建構的；
- 你是作者，正在找回或繼續自己的投稿；
- 原始碼的授權和你預定的用途允許重複使用。

只有在沒有原始碼壓縮檔時，才使用 [PDF 轉 LaTeX](/docs/tools/pdf-to-latex/)。投稿中不含原始檔的論文，arXiv 工具無法開啟。若要取得 Typst 版本的論文，請使用 [arXiv 轉 Typst](/docs/tools/arxiv-to-typst/)。

## 用 ID 開啟論文

1. 開啟 **arXiv 轉 LaTeX**，或執行 `/arxiv-to-latex`。
2. 輸入識別碼，例如 `1706.03762`。包含可辨識 ID 的完整 arXiv URL 也可以。
3. 開始下載，並在 Oleafly 解開原始碼時稍候。
4. 檢查偵測到的主檔案和封存包內容。
5. 儲存 ZIP，或建立 LaTeX 專案。

查詢 ID 會連到 arXiv，需要網路連線。如果你已經有 `.gz`、`.tgz` 或 `.tar.gz` 原始碼壓縮檔，請切換到檔案輸入，不需要網路請求就能開啟。

## 編譯之前

arXiv 原始碼封存包反映的是作者投稿時的環境。它可能依賴自訂的文件類別、本機樣式檔、字型、產生的資料或 shell 指令。

執行之前請先檢查壓縮檔，然後先用內建的 Tectonic 編譯。如果 Oleafly 找出相容性問題，請依照具體的復原動作處理，不要隨意更換引擎。[LaTeX 引擎與套件](/docs/latex-engines/)說明了系統 TeX 及其信任界線。

:::caution[原始碼是可執行的輸入]
用系統工具鏈編譯時，TeX 專案可以執行外部程式。只有對你信任且已檢查過的原始碼，才允許 shell 指令。
:::

轉換器會保留原始檔案，並回報它選為進入點的檔案。它不保證每一份歷史投稿都能在目前的 TeX 發行版上不經修改就編譯成功。