把現有的工作帶進 Oleafly

選擇 新增專案 → 匯入專案，或使用專案庫中的 匯入。Oleafly 會建立新的本機專案，原始檔案或儲存庫維持不變。除非匯入的內容自帶 Git 儲存庫，否則匯入的檔案會成為專案的 第一次 Git 提交，名為 Create project。

在新增專案對話框中選擇匯入專案，從現有的工作開始。 開啟完整螢幕截圖

選擇符合你來源的方式

你有的東西	匯入方式	你可以建立的專案
完整的專案資料夾	現有專案（.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 檔案維持原本的格式，請先建立該格式的空白專案，再透過 檔案樹 加入原始檔案。

匯入完整的專案壓縮檔

當你已有可運作的原始碼目錄樹時，請使用 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 無法處理的功能，會開啟引擎對話框，讓你選擇其他引擎。請參閱 為新專案設定預設值 和 當 Tectonic 不夠用時。

轉換 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；如果你想把論文轉換成 Typst，則使用 arXiv 轉 Typst。arXiv 識別碼需要網路連線；已經在磁碟上的原始碼壓縮檔則不需要。

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

從 GitHub 匯入

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

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

把 LaTeX 專案轉換成 Typst

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

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

報告會說明新專案能否編譯、統計轉換了哪些內容，並列出需要手動修正的地方，附有每個編譯錯誤的連結。Typst 專案 詳細說明了轉換和報告。

重建 PDF

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

• PDF 轉 LaTeX，用於 LaTeX 專案或原始碼壓縮檔
• PDF 轉 Markdown，用於可編輯的 Markdown
• PDF 轉 Typst，用於可編輯的 Typst

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

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

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

透過 參考文獻與引用 匯入 BibTeX、RIS、EndNote XML 或 Zotero RDF。如果一個放著論文或資料的資料夾應該留在專案之外，請把它連結為 唯讀的研究背景資料。