# 檔案與資料夾

檔案總管：建立、重新命名、移動和複製檔案，Git 狀態，主要文件，分頁，圖片和 PDF 檢視，以及自動儲存如何保護你的工作。

每個專案都是一個真實的檔案資料夾，而 **檔案總管** 面板（左側欄的第一個分頁）就是你操作它的地方。多檔案專案是一等公民：把各章分成獨立的 `.tex` 檔案、把圖片放在資料夾裡，Oleafly 的編譯、導覽和搜尋都會跟著運作。

![LLaMA 的檔案樹。使用面板標題旁的三個控制項，可以建立檔案、建立資料夾，或匯入現有檔案。](https://cdn.oleafly.com/images/screenshots/desktop/docs/project-files-dark-window-v2.png#view=0,45,344,638)

![在專案的所有檔案中搜尋，然後開啟其中一個符合項並跳到它所在的行。](https://cdn.oleafly.com/images/gifs/desktop/project-search.gif?v=2)

## 檔案總管面板

資料夾排在最前面，接著是依字母排序的檔案。按一下資料夾可展開或收合，按一下檔案可在分頁中開啟它，也可以用方向鍵加 Enter 完整地用鍵盤瀏覽。專案的 **主要文件**（編譯器開始處理的檔案）會以星號標示。

面板標題上有兩個按鈕可以建立項目：**新增檔案** 和 **新增資料夾**。兩者都會建立在目前選取的資料夾內；如果沒有選取任何項目，就建立在專案根目錄。直接在原地輸入名稱並按 Enter；新檔案會立刻開啟。

雜務是看不見的：`.git` 這類內部資料夾和建置快取永遠不會出現在檔案樹中，符號連結也不會被追蹤。

## 檔案樹中的 Git 狀態

專案使用 Git 時，檔案總管會用與 [原始檔控制](/docs/git-history/) 相同的字母標示已變更的檔案：

| 字母 | 意義 |
|---|---|
| **M** | 已修改 |
| **A** | 已新增 |
| **D** | 已刪除 |
| **R** | 已重新命名 |
| **U** | 未追蹤（Git 尚未追蹤的新檔案） |
| **!** | 衝突 |

字母位於該列的右端，把滑鼠停在上面會顯示狀態名稱。檔案名稱維持原本的顏色。含有變更的資料夾會顯示圓點而不是字母，顏色取決於其中最緊急的變更，因此即使資料夾是收合的，`sections/` 深處的衝突也會顯示在 `sections` 這一列上。

## 右鍵選單

在 **檔案** 上：

- **開啟**
- **設為主要文件**（適用於專案引擎能編譯的檔案類型，例如 `.tex`、`.typ` 或 `.md`）：讓這個檔案成為編譯的進入點，並移動星號。
- **重新命名**：在原地編輯名稱。已開啟的分頁、未儲存的編輯和主要文件的指向都會隨著重新命名而更新，[指向該檔案的路徑](#paths-follow-a-moved-file) 也可以。
- **建立副本**：在原檔案旁建立 `name copy.tex`。以位元組為單位複製，所以圖片和其他二進位檔案都能安全複製。
- **刪除**：確認後移除檔案。這無法從應用程式中復原，不過 [Git 歷史記錄](/docs/git-history/) 可以找回任何你已提交的內容。在原地開啟的資料夾中，刪除則會改為把檔案移到垃圾桶（Windows 上是資源回收筒）。

在 **資料夾** 上：**新增檔案**、**新增資料夾**、**匯入檔案**、**匯入資料夾**、**重新命名**、**建立副本**（遞迴複製整個資料夾）和 **刪除**。

## 移動項目：拖放

把任何檔案或資料夾拖到另一個資料夾上，就會移進該資料夾內；拖到檔案樹底部的空白區域，則會移到專案根目錄。你把滑鼠移上去時，放置目標會醒目標示。Oleafly 會拒絕把資料夾移進它自己內部的操作。

從檔案管理員拖進來的檔案和資料夾，會複製到指標所在的資料夾中。這在 macOS、Windows 和 Linux 上都可以使用。

## 路徑跟著移動的檔案走

重新命名或移動檔案，可能會讓指向它的路徑失效。Oleafly 會找出這些路徑並更新它們：

- 在 LaTeX 中：`\input`、`\include`、`\includegraphics`、`\bibliography` 和類似的指令。
- 在 Typst 中：`#include`、`image()` 和 `bibliography()`。
- 在 Markdown 中：連結和圖片。

你可以從編輯器或檔案總管開始。在編輯器中，把游標放在路徑上並按 F2，或從右鍵選單選擇 **重新命名檔案…**。**重新命名檔案** 對話框接受完整路徑，因此也能把檔案移到另一個資料夾，並且會建立尚不存在的資料夾。在檔案總管中，使用 **重新命名**，或把檔案拖到新的資料夾。

預設情況下，Oleafly 會先詢問。對話框會列出每個仍在使用舊路徑的檔案，以及各有多少處參照。選擇 **更新參照** 或 **不要更新**，並勾選 **不再詢問** 來記住這個答案。之後要更改，請到 **設定 → 外觀 → 編輯器** 把 **移動檔案時** 設為 **詢問**、**一律更新** 或 **永不更新**。移動之後有變更過的檔案，或無法儲存的檔案，會保留舊路徑，對話框也會這樣告訴你。

## 分頁

開啟的檔案會依你開啟的順序，以分頁的形式顯示在編輯器上方。分頁上有圓點，表示有尚未儲存的變更（片刻後就會自動儲存）。Git [差異檢視](/docs/git-history/) 也會在同一列以分頁開啟，並標上檔案名稱加上 `(Index)` 或 `(Working Tree)`。

關閉目前的分頁，會切換到前一個分頁。復原記錄絕不會跨檔案：每個檔案各自保有自己的記錄。

## 不同檔案類型如何開啟

- **LaTeX 和文字檔案**（`.tex`、`.sty`、`.cls`、`.bib`、`.md` 等等）會在編輯器中開啟，並依副檔名套用語法醒目提示。
- **圖片**（`.png`、`.jpg`、`.gif`、`.webp`、`.svg` 等等）會以轉譯後的圖片開啟。
- **PDF** 會在 PDF 檢視器中開啟。
- **不透明的二進位檔案**（`.zip`、`.eps`、字型檔案）會顯示「二進位檔案。無法預覽。」的通知，而不會冒著損毀的風險把它們當成文字載入。
- **`.bib` 檔案** 也會在專案開啟的當下於背景解析，這正是 [引用自動完成](/docs/citations/#complete-and-navigate-references) 的運作基礎。

## 自動儲存

你永遠不需要按儲存。編輯會在你停止輸入約 1.5 秒後寫入磁碟，而且 Oleafly 做得比單純的計時器更周到：

- 編輯檔案 A，在計時器觸發前切換到檔案 B，A 仍然會儲存。
- 關閉或重新載入應用程式時，會先寫出所有待處理的儲存，所以在防彈跳（debounce）時間窗內退出也不會遺失任何東西。
- 編譯會先儲存目前的檔案，因此 PDF 一定反映你看到的內容。

## 加入現有檔案

使用 **匯入檔案** 或 **匯入資料夾**（在面板標題的選單和右鍵選單中），把磁碟上任何位置的圖片、`.bib` 檔案或整個目錄複製到專案中。匯入到選取的資料夾時，副本會放在那裡；否則會放在專案根目錄。

因為專案也只是一般資料夾，直接的做法同樣可行：用檔案管理員把檔案放進 `~/.oleafly/projects/<project>/`，然後重新開啟專案，讓 Oleafly 讀取它們。請在專案關閉時進行複製（或在複製後立即重新開啟），因為應用程式的自動儲存會寫出它記憶體中的內容。
