# 把現有的工作帶進 Oleafly

匯入專案壓縮檔、轉換文件、帶入 arXiv 原始碼套件、複製 GitHub 儲存庫，或把 LaTeX 專案變成 Typst 專案。

選擇 **新增專案 → 匯入專案**，或使用專案庫中的 **匯入**。Oleafly 會建立新的本機專案，原始檔案或儲存庫維持不變。除非匯入的內容自帶 Git 儲存庫，否則匯入的檔案會成為專案的 [第一次 Git 提交](/docs/new-project/#the-first-git-commit)，名為 **Create project**。

![在新增專案對話框中選擇匯入專案，從現有的工作開始。](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

## 選擇符合你來源的方式

| 你有的東西 | 匯入方式 | 你可以建立的專案 |
| --- | --- | --- |
| 完整的專案資料夾 | **現有專案**（`.zip`） | 壓縮檔中的原始碼、圖片、參考文獻和本機樣式檔案 |
| Word 文件 | **Word 文件**（`.docx`） | LaTeX、Markdown 或 Typst |
| Markdown 文件 | **Markdown 文件**（`.md`、`.markdown`） | LaTeX 或 Typst |
| HTML 文件 | **HTML 頁面**（`.html`、`.htm`） | LaTeX、Markdown 或 Typst |
| Typst 文件 | **Typst 文件**（`.typ`） | LaTeX 或 Markdown |
| arXiv 論文 | 附有 ID 或 URL 的 **arXiv 論文** | 該論文的 LaTeX 原始碼套件 |
| GitHub 儲存庫 | **GitHub** | 連接到該儲存庫的本機專案 |
| 沒有可編輯原始碼的 PDF | **Oleafly 工具 → PDF 轉換工具** | 重建的 LaTeX、Markdown 或 Typst，視你選擇的工具而定 |
| 已在 Oleafly 中的 LaTeX 專案 | 指令面板中的 **轉換為 Typst 專案** | 新的 Typst 專案，LaTeX 專案維持原樣 |

只有在 Oleafly 提供時，才選擇相同的寫作格式。要讓 Markdown 或 Typst 檔案維持原本的格式，請先建立該格式的空白專案，再透過 [檔案樹](/docs/files/#adding-existing-files) 加入原始檔案。

## 匯入完整的專案壓縮檔

當你已有可運作的原始碼目錄樹時，請使用 ZIP。

1. 把主要文件、圖片、參考文獻，以及本機的類別或樣式檔案放進同一個資料夾。保留原始碼使用的相對路徑。
2. 把資料夾壓縮成 `.zip` 檔案。
3. 選擇 **匯入 → 現有專案** 並選取該 ZIP。
4. 在匯入的檔案樹中檢查標有星號的主要文件。
5. 編譯。如果專案需要不同的 LaTeX 工具鏈，請從編譯器選單中選擇。

例如，把 `main.tex`、`references.bib`、`sections/method.tex` 和 `figures/plot.pdf` 放在一起。原始碼 ZIP 會保留這些關係。PDF 則不含相同的可編輯專案結構。

如果壓縮檔中有不只一個可能的主要文件，請在編譯之前透過檔案選單確認正確的那一個。

## 匯入會使用哪個 LaTeX 編譯器

匯入或轉換的 LaTeX 專案，會從 **設定 → 引擎 → LaTeX** 中的預設編譯引擎開始，除非你改過，否則就是 Tectonic。當預設是 `latexmk`，而專案指定 pdfLaTeX、XeLaTeX 或 LuaLaTeX 時，它會保留那個編譯器。如果匯入時發現 Tectonic 無法處理的功能，會開啟引擎對話框，讓你選擇其他引擎。請參閱 [為新專案設定預設值](/docs/engines/#set-a-default-for-new-projects) 和 [當 Tectonic 不夠用時](/docs/latex-engines/#when-tectonic-isnt-enough)。

## 轉換 Word、Markdown、HTML 或 Typst

1. 在 **匯入** 中選擇對應的文件類型。
2. 選取檔案。
3. 如果 Oleafly 提供不只一個目的地，請選擇你接下來要編輯的格式。LaTeX 會標示為建議的方式。
4. 如果出現提示，請完成 Pandoc 的設定。Oleafly 可以使用相容的安裝，或下載它的託管版本。
5. 開啟新專案、編譯，並與原稿比對。

轉換透過 Pandoc 在本機執行。Word 或 HTML 的匯入也會把內嵌的媒體擷取到專案中，讓轉換後的原始碼可以參照它。匯入 LaTeX 專案的 Markdown 文件會保留它的引用：`[@key]` 會變成 `\citep` 或 `\citet`，參考文獻檔案也會一併帶入，所以參考文獻面板從一開始就有你的來源。

為接下來的工作選擇目的地：

- **LaTeX** 適合期刊範本、細緻的排版，以及標記式 PDF 的工作流程。
- **Markdown** 適合較輕量的原始碼格式和廣泛的文件轉換。
- **Typst** 適合快速編譯和 Typst 原生的範本。

只要來源格式帶有文件結構，轉換就會保留它。Word 專有的頁面版面、自訂的 HTML 樣式、手動調整的表格、引用和複雜的公式，仍可能需要清理一輪。刪除原稿之前，請比對標題、清單、表格、公式、連結、引用和圖片位置。

## 匯入 arXiv 原始碼套件

選擇 **arXiv 論文**，然後貼上識別碼（例如 `2401.01234`）或 `arxiv.org/abs/...` 的 URL。Oleafly 會下載提交的原始碼套件，並以 LaTeX 專案開啟它。

需要作者可編輯的原始碼時，請使用這種方式。如果你想檢視或儲存原始碼壓縮檔，而不從匯入對話框開始，請使用 [arXiv 轉 LaTeX](/docs/tools/arxiv-to-latex/)；如果你想把論文轉換成 Typst，則使用 [arXiv 轉 Typst](/docs/tools/arxiv-to-typst/)。arXiv 識別碼需要網路連線；已經在磁碟上的原始碼壓縮檔則不需要。

重複使用原始碼或圖片之前，請務必檢查授權和作者的條款。

## 從 GitHub 匯入

在匯入對話框中選擇 **GitHub**。如有需要，透過 **設定 → 整合 → GitHub** 連接你的帳號，然後選取一個你有權存取的儲存庫。

Oleafly 會在專案庫中建立一份本機副本。編輯之前，請檢查它的主要文件並執行一次編譯。[GitHub 同步](/docs/github-sync/) 說明了匯入後如何提取、提交和發布變更。

## 把 LaTeX 專案轉換成 Typst

Oleafly 可以替你現有的 LaTeX 專案製作 Typst 副本。LaTeX 專案不會被更動。

1. 開啟 LaTeX 專案。
2. 開啟 ⌘K（Ctrl+K）指令面板，執行 **轉換為 Typst 專案**。
3. 檢查 **新專案名稱**。預設是專案名稱後面加上 `(Typst)`。
4. 選擇 **轉換**。Oleafly 會用 Pandoc 轉換專案、建立 Typst 專案，並編譯一次作為檢查。
5. 閱讀報告，然後選擇 **開啟 Typst 專案**。

報告會說明新專案能否編譯、統計轉換了哪些內容，並列出需要手動修正的地方，附有每個編譯錯誤的連結。[Typst 專案](/docs/typst/#convert-a-latex-project-to-typst) 詳細說明了轉換和報告。

## 重建 PDF

在 **設定 → 實驗功能** 中啟用 **LaTeX 工具**，然後選擇符合你所需輸出的工具：

- [PDF 轉 LaTeX](/docs/tools/pdf-to-latex/)，用於 LaTeX 專案或原始碼壓縮檔
- [PDF 轉 Markdown](/docs/tools/pdf-to-markdown/)，用於可編輯的 Markdown
- [PDF 轉 Typst](/docs/tools/pdf-to-typst/)，用於可編輯的 Typst

本機的 PDF 處理流程會讀取文字圖層、還原閱讀順序，並擷取圖片。在 **PDF 轉 LaTeX** 中，當 PDF 是由頁面圖片組成時，請切換到掃描文件模式。這種方式會使用工具所用的模型（除非你另外選擇，否則就是本機的 Ollama 模型），最多支援 50 頁的文件。

請逐頁比對結果與 PDF。欄位、公式、表格、註腳和閱讀順序都是重建上的難題，所以不應把任何 PDF 轉換的結果當成原始來源。

## 不匯入稿件也能加入參考文獻

透過 [參考文獻與引用](/docs/citations/#import-a-whole-reference-library) 匯入 BibTeX、RIS、EndNote XML 或 Zotero RDF。如果一個放著論文或資料的資料夾應該留在專案之外，請把它連結為 [唯讀的研究背景資料](/docs/linked-folders/)。