你的檔案與資料
了解哪些內容會跟著專案走,以及如何備份原始碼、歷史記錄與應用程式資料。
你的稿件是一個由一般原始碼檔案組成的資料夾。你可以用其他編輯器開啟這些檔案、備份它們,或把它們帶離 Oleafly。
專案檔案
標題為「專案檔案」的段落專案庫中的專案通常放在 ~/.oleafly/projects/ 底下。專案可以包含 LaTeX、Typst 或 Markdown 主文件、參考文獻、圖片與研究素材。
project.json 記錄專案的身分與設定,包括主文件、引擎,以及鎖定的 Typst 版本。.git 目錄存放 Git 歷史記錄。Oleafly 建立或匯入的專案,通常從包含其檔案的一次提交開始,這次提交名為「Create project」(參閱 Git 與版本控制)。.oleafly/build/ 目錄存放產生的建置輸出,重新編譯就能再產生。
Typst 專案可以把它匯入的套件副本保存在 typst-packages 資料夾中,這樣專案就能離線編譯,也能在其他電腦上編譯。Typst 也會使用專案 fonts 資料夾中的字型。這兩個資料夾都會跟著專案走。
你就地開啟的資料夾會留在原處。Oleafly 把該資料夾的建置、設定、檢查點與聊天記錄放在自己的資料夾裡,所以不會有任何東西加進你的資料夾。
儲存在專案之外的資料
標題為「儲存在專案之外的資料」的段落應用程式偏好設定、加密的供應商憑證、聊天與用量記錄、下載的工具(例如額外的 Typst 版本),以及已儲存的檢查點,都屬於本機的應用程式儲存空間。Oleafly 在每次助理或代理程式回合之前保留的專案副本也是,這些副本讓你能復原該回合所更動的檔案。@ 搜尋所讀取的 Zotero 文獻庫副本同樣放在那裡,而不是在專案裡。複製稿件資料夾,並不會複製所有這些應用程式資料。
已連結資料夾會留在原來的位置。原始碼壓縮檔不會只因為你連結了它們,就包含它們的內容。
筆記存放在哪裡
標題為「筆記存放在哪裡」的段落筆記是你電腦上的 Markdown 檔案。每則個人筆記是專案資料夾中的一個資料夾,就放在你的專案庫專案旁邊。專案筆記是專案 notes 資料夾中的一個 .md 檔案,所以會隨專案一起移動。Windows、macOS 和 Linux 上的資料夾位置,以及筆記資料夾裡有什麼,請參閱筆記存放在哪裡。
TinyTeX 存放在哪裡
標題為「TinyTeX 存放在哪裡」的段落當你從設定 → 引擎 → LaTeX 安裝 TinyTeX 時,Oleafly 會把它放在 ~/.oleafly/tinytex。Windows 是例外:當你的使用者資料夾名稱含有重音字母或非拉丁字母(例如韓文或中文名稱)時,因為 TeX Live 無法從這樣的資料夾執行,TinyTeX 會改放在 ProgramData(通常是 C:\ProgramData)裡,資料夾名稱是 Oleafly- 加上一段短代碼。不需要管理員權限。如果 Oleafly 也無法設定那個資料夾,它會這樣告訴你。你可以繼續用 Tectonic 編譯,或自己把 TeX Live 安裝在 C:\texlive。
管理 TeX 發行版下 TinyTeX 的那一列會顯示該資料夾;把滑鼠停在模糊的路徑上就能讀到。請從那一列移除 TinyTeX,而不要手動刪除資料夾。
備份你的工作
標題為「備份你的工作」的段落| 你想保留的內容 | 保留方式 |
|---|---|
| 稿件原始碼與專案資源 | 複製專案資料夾,或匯出原始碼 ZIP |
| Git 提交 | 備份儲存庫,或推送到你設定的遠端 |
| 已儲存的檢查點 | 從版本管理匯出加密的歷史記錄壓縮檔 |
| 應用程式偏好設定與本機記錄 | 把 Oleafly 的資料目錄納入你平常的電腦備份 |
| 已連結的資料與參考文獻 | 備份它們的原始資料夾 |
| 專案庫中的專案與設定(存放在這台電腦之外) | 開啟雲端同步,在你的 Dropbox 保留一份副本 |
原始碼 ZIP 不含建置快取與 Git。遠端儲存庫請使用 GitHub 同步,檢查點歷史記錄請使用檢查點壓縮檔。
移到另一台電腦
標題為「移到另一台電腦」的段落安裝 Oleafly,然後複製或 clone 稿件專案。在那台機器上重新連接已連結資料夾與模型供應商。專案會帶著它的編譯器選擇與中繼資料;額外的工具或套件可能需要另外安裝。如果 Typst 專案鎖定的版本這台電腦沒有,會在編譯前提議下載該版本。
畫面上的路徑
標題為「畫面上的路徑」的段落位於你家目錄內的路徑,在設定、版本歷史記錄、引擎與代理程式詳細資料,以及聊天中,會顯示為 ~/…。在設定中,檔案與資料夾路徑也會保持模糊,直到你把滑鼠移到上面或用 Tab 鍵移到它們,所以螢幕截圖不會洩漏你的檔案放在哪裡。
網路存取
標題為「網路存取」的段落寫作與本機校對都在你的電腦上進行。託管的 AI 會收到提供給所選供應商的脈絡。讀取圖片和掃描 PDF 的工具會使用本機的 Ollama 模型,除非你為它們選擇託管的模型或 Mathpix,那時檔案會送到那個服務。Zotero 引用會與你電腦上的 Zotero 應用程式溝通;連接帳號時,則與 zotero.org 溝通。引用搜尋、Zotero 匯入、alphaXiv 工具、GitHub 同步、Typst 套件與版本下載、其他下載,以及更新檢查,會連到各自的服務。即時協作會把每個共用的專案,送到它所共用的協作伺服器。雲端同步會把你專案庫中的專案與設定,送到你自己的 Dropbox。開啟 設定 → 說明與關於 會取得公開的數字:專案的 GitHub 星號與 fork 數量,以及 Discord 社群中有多少成員在線上。這些請求不帶任何帳號、專案或用量資訊,而且離線模式會略過 Discord 的那一個。Tectonic 與 Typst 都支援透過離線模式使用快取編譯。