跳到內容
Oleaflyv0.4.12

找出 Oleafly 最新的筆記、Markdown、引用、編輯器、Typst、圖表、研究與代理程式功能的使用指南。

最新的更新加入了筆記,這是一項把研究筆記保存為 Markdown 檔案的實驗功能,也讓 Markdown 文件可以建置成書籍、投影片、海報或信函。Quarto 網頁現在會顯示在預覽中,而在沒有 TeX 的電腦上,引擎視窗會優先提供 TinyTeX。在那之前有編譯後始終保持最新的專案資料夾 PDF、在你已在使用的 CLI 代理程式上執行的工具、禪模式,以及輸入時直接從 Zotero 引用。本頁會指向完整說明,而不是重複列出發行說明。

筆記把研究筆記保存為你電腦上的 Markdown 檔案。你在豐富的編輯器中撰寫,可使用提示框、表格、圖表、圖解、數學公式、連結,以及附有到期日的任務。在你於 設定 → 實驗功能 中開啟 筆記 之前,它是關閉的。筆記會在可分割、可停靠的分頁中開啟,你可以用搜尋、標籤、任務或日期再次找到它們。筆記可以放在專案中,也可以和其他人在協作伺服器上一起撰寫,助理或 CLI 代理程式可以提出變更建議,由你在筆記中接受或拒絕。快速記錄 會開啟一個小視窗,讓你在任何應用程式中記下想保留的想法。

開啟筆記 · 在筆記中寫作 · 尋找與整理筆記 · 專案中的筆記與共用筆記 · 搭配 AI 的筆記

在 Markdown 文件的前置資料中加入 type:,就能把它建置成報告、書籍、投影片、海報、信函或履歷。投影片會建置成 16:9 的 Beamer 投影片,可由放映顯示,信函則從 to 和 from 取得地址。你自己的前置資料仍然優先。文件設定 中的 文件類型 會替你寫入這一行,LaTeX 匯出和 oleafly build 也會依循這個類型。

文件類型 · Markdown 的文件設定 · 放映投影片

建置出網頁的 Quarto 文件,例如 format: html 或 reveal.js 簡報,現在會把網頁顯示在預覽窗格中。這個網頁無法存取 Oleafly 的其他部分。若要在你自己的瀏覽器中開啟,請選擇預覽工具列上的 在瀏覽器中開啟。

Quarto · 在瀏覽器中開啟

當專案需要 latexmk,而這台電腦沒有可用的 TeX 時,引擎視窗現在會把 下載 TinyTeX 列在最前面,並標示為 推薦。下載並使用 TinyTeX 會安裝它並編譯專案。若要繼續使用內建引擎,請使用最底下的 繼續使用 Tectonic 卡片。

沒有安裝 TeX 時 · Tectonic 不夠用時

PDF 預覽中的儲存按鈕現在會開啟一個選單。在那裡開啟 編譯時同步 PDF,每次成功編譯後,Oleafly 就會在專案資料夾中更新一個以專案標題命名的 PDF,例如 Thesis_Final_Draft.pdf。它是一般檔案,所以雲端同步和檢查點都會納入它,而且 Oleafly 絕不會覆寫不是它建立的檔案。要取回較早的 PDF,請開啟某個檢查點的檔案,然後選擇 儲存 PDF。

編譯時同步 PDF · 從檢查點儲存 PDF

圖片轉 LaTeX、圖片轉 Typst、方程式工具和掃描的 PDF,可以使用已連接的 CLI 代理程式,例如 Claude Code 或 Codex,以你自己的登入執行,不需要 API 金鑰。沒有金鑰時,論文審閱、行內編輯和 用 AI 修正 也會使用該代理程式。Antigravity CLI 現在是內建的代理程式。

用代理程式取代 API 金鑰 · 代理程式目錄

從任何資料夾使用 TeX,以及從鏡像站下載

標題為「從任何資料夾使用 TeX,以及從鏡像站下載」的段落

在 設定 → 引擎 → LaTeX 中使用 選擇 TeX 資料夾,就能用安裝在 Oleafly 不會尋找之處的 TeX 來編譯。TinyTeX、Typst 和其他下載現在會先從 Oleafly 的鏡像站取得。設定 → 下載 → 下載來源 可以切換到原始網站或你自己的鏡像站,並設定 TeX 套件所用的套件庫。TinyTeX 的下載可以取消並繼續。

latexmk 與系統 TeX · 下載來源分頁 · 安裝與更新 TinyTeX

TeX 會略過它的字型無法顯示的字元,卻仍然回報成功,所以中文、日文或韓文的段落可能會變成空白。現在你會收到通知,記錄檔會列出缺少的字元,並針對每種文字提供一套使用內建引擎所附字型的設定。

PDF 中缺少的字元

會先思考再回答的 Ollama 與 Lemonade 模型,現在在強度選單中提供 無。處理簡單請求時選擇它,回覆會快得多。

略過思考步驟

中日韓編輯器字型,以及依名稱使用已下載的字型

標題為「中日韓編輯器字型,以及依名稱使用已下載的字型」的段落

中日韓字型 設定讓中文、日文與韓文字元在編輯器中擁有自己的字型,與你的程式碼字型並用。已下載的 Lato、PT Sans 和 PT Serif 可以用名稱使用:Typst 找得到它們,而 加入專案 會把其中一個複製到 LaTeX 專案中。

中日韓字型 · 將字型加入專案

在 LaTeX、Typst 或 Markdown 檔案中輸入 @,你的整個 Zotero 文獻庫就會顯示在專案自己的參考文獻旁邊。選擇一篇論文會插入引用,並只把那一筆條目加進專案的 .bib。之後,從 Zotero 新增 與 從 Zotero 更新 會讓該檔案與你的文獻庫保持同步。它可搭配在同一台電腦上開啟的 Zotero 7,或搭配 zotero.org 帳號使用。

從你的 Zotero 文獻庫引用 · 連接 Zotero

為淺色模式與深色模式各選一個編輯器主題,編輯器就會跟著應用程式切換。Paper(偏暖的米白色)與 One Light 是新增的主題。編輯器顏色 可以更改主題的任何顏色,並在 LaTeX、Typst 與 Markdown 中即時預覽。顏色依角色分組,所以標題、引用或方程式在三種語言中都會得到相同的顏色。

編輯器主題 · 編輯器顏色

按 Ctrl+⌘⇧F(Windows 與 Linux 上為 Shift+F11)可隱藏工具列、側邊欄、助理與終端機。只剩下編輯器,角落有一個編譯按鈕。按兩次 Esc 即可恢復所有內容。

禪模式

路徑會隨重新命名與移動的檔案更新

標題為「路徑會隨重新命名與移動的檔案更新」的段落

重新命名檔案,或把它拖到另一個資料夾,指向它的 \input、\includegraphics、#include、image() 與 Markdown 連結也會跟著更改。除非你指定一律更新或一律不更新,否則 Oleafly 會先詢問。

路徑會隨移動的檔案更新

預設編譯引擎適用於每個新的 LaTeX 專案

標題為「預設編譯引擎適用於每個新的 LaTeX 專案」的段落

你在 設定 → 引擎 → LaTeX 下選擇的引擎,現在會套用到新專案、匯入的專案、轉換後的文件,以及你就地開啟的受信任資料夾。在那裡選擇 latexmk,新專案從一開始就會使用你自己的 TeX 安裝來編譯。

為新專案設定預設值

⌘= 與 ⌘- 會縮放整個應用程式,⌘, 會開啟設定,⌘⌥P 會顯示或隱藏 PDF。應用程式與編輯器的字型可以是你電腦上安裝的任何字型。編輯器也新增了行高、字距,以及游標寬度與顏色的設定。

外觀與主題 · 鍵盤快捷鍵

當 Tectonic 無法建置文件時,引擎對話框會自行開啟,並可將專案改用你系統上的 LaTeX。編輯器上方的橫幅會為 minted、PythonTeX 與 \write18 提供 允許外部命令。在 Linux 上,Oleafly 現在會自行繪製標題列,並接受從檔案管理員拖放進來的檔案。

當 Tectonic 不夠用時 · 允許外部命令 · 在 Linux 上安裝

Typst 專案現在擁有 LaTeX 專案原有的功能,另外還有一些自己獨有的。可以為每個專案選擇 Typst 版本,從 0.11 到 0.15,Oleafly 會下載它,並對照已公布的校驗和進行檢查。套件來自 Typst Universe,也可以放在專案內,讓專案能離線編譯。專案自己的字型、建置變體與可重現的建置,對 Typst 和語言伺服器都有效。

在編輯器中,Typst 新增了視覺化模式、摺疊、固定標題、針對函式、路徑、標籤與套件的自動完成、重新命名與格式化文件。它也有了 LaTeX 原有的圖片、表格、引用與方程式工具。「前往 PDF」與在 PDF 中點選,可以在原始碼與頁面之間跳轉。匯出格式包括 PNG、SVG、HTML、PDF/A 與 PDF/UA,預檢也會檢查 Typst 原始碼。

設定 Typst 專案 · 用 Typst 寫作 · 將 LaTeX 專案轉換為 Typst

每個引擎都有的套件、文件設定與分析

標題為「每個引擎都有的套件、文件設定與分析」的段落

編輯器工具列上的三個按鈕,現在在適用的 LaTeX、Typst 與 Markdown 中運作方式相同:

  • 套件 在 LaTeX 中搜尋 CTAN,在 Typst 中搜尋 Typst Universe,並加入載入套件的那一行。
  • 文件設定 可更改紙張大小、邊界、字型、語言、行距與編號。它會替你編輯導言區、#set 規則或 front matter。
  • 文件分析 會列出文件中的圖片、表格、方程式、標籤、引用與待辦事項,並可複製其投稿中繼資料。

套件 · 文件設定 · 文件分析

同時支援 TikZ、Typst 與 Mermaid 的圖表編排器

標題為「同時支援 TikZ、Typst 與 Mermaid 的圖表編排器」的段落

圖表編排器現在會詢問圖表要用哪種語言:LaTeX 用 TikZ,Typst 用 fletcher 圖表,Markdown 用 Mermaid 流程圖。三者共用同一個畫布,程式碼與繪圖在兩個方向上都保持同步。文件工具列上的 繪製圖表 會略過這個問題,直接使用該文件的語言。插入 Markdown 的 Mermaid 圖表也會出現在編譯後的 PDF 中。

繪製圖表

以全螢幕放映任何編譯後的 PDF,並可選用簡報者檢視,顯示下一張投影片、計時器與你的筆記。

放映投影片

首頁的專案搜尋能理解 engine:typst、is:bookmarked 和 created:>@today-1w 這類限定條件,還支援 AND、OR、括號與排序。輸入時會出現建議,「進階篩選」編輯的是同一段文字。

搜尋你的專案

把整個 Zotero 文獻庫匯入專案的參考文獻,並連接 alphaXiv,讓助理能從中搜尋並閱讀論文。

連接 Zotero · 連接 alphaXiv

設定中的每個 CLI 代理程式都會顯示 Oleafly 找到的程式,測試 會在儲存任何內容之前先執行它。代理程式變更檔案後,你可以審閱每一項變更,並復原或重做。代理程式首頁也提供研究的起點,例如文獻掃描或引用稽核。

設定 CLI 代理程式 · 審閱並復原變更 · 研究起點

在設定中輸入「主題」、「Zotero」或「拼字」這類字詞,就能直接跳到對應的項目。「重設」按鈕上的圓點表示該區段中有內容與預設值不同,檔案路徑則會保持模糊,直到你將滑鼠指向它們。

設定

選用的 LaTeX 工具 圖庫現在包含 47 個專注的工具,其中有十個 Typst 轉換器。你可以在 LaTeX、Typst、Markdown、Word、HTML、PDF、影像、試算表與 Mermaid 圖表之間轉換文件;建立並驗證參考文獻;搜尋論文、實驗室與截止日期;執行統計計算;也能使用小型寫作輔助工具。

現在每個工具都有自己的頁面,內容包括輸入、步驟、範例、隱私行為、限制,以及當該工具不適用時更合適的做法。

雙窗格工具有可拖曳、可用鍵盤操作的分隔線。每個工具會記住它在桌面上的分割位置,窄視窗則會把輸入與結果上下堆疊。

瀏覽全部 47 個工具

校對現在在 LaTeX、Typst 與 Markdown 中,結合了拼字檢查與 Harper 的文法和風格檢查。它會略過不應視為一般文章的原始碼語法,然後讓你替換某項發現,或暫時忽略、只在一個專案中忽略,或在所有地方忽略。學術設定檔加入了適合研究寫作的檢查,你也可以從某項發現中停用個別的 Harper 規則。

設定校對與學術風格

編輯器可以為數學分隔符號、括號與環境配對;延續清單;關閉目前的環境;並自動完成感知套件的命令、參照、引用與專案路徑。個別的設定讓你分別開啟或關閉自動完成、括號、數學或環境關閉。

使用自動完成與結構化輸入 · 認識編輯器

插入引用時會依循文件宣告的參考文獻,包括常見的 BibTeX 與 Biber 設定。文獻庫匯入接受 BibTeX、RIS、EndNote XML 與 Zotero RDF。參考文獻清理工具會在變更檔案之前預覽已正規化的鍵與重複項目,在鍵變更時更新引用,並儲存備份。新的獨立工具涵蓋 DOI、arXiv、ISBN、PubMed、URL、格式化引用,以及八種引用樣式。

管理引用與參考文獻 · 開啟參考文獻工具

Word 與 HTML 文件可以變成 LaTeX、Markdown 或 Typst 專案。Markdown 可以變成 LaTeX 或 Typst,Typst 可以變成 LaTeX 或 Markdown。開啟中的專案可以依支援的路徑匯出為 Word、含 MathML 的 HTML、Markdown、Typst、LaTeX、純文字、PDF、原始碼 ZIP,或頁面影像。LaTeX 簡報與書籍也可以匯出為 PowerPoint 或 EPUB。Markdown 專案兩者都提供,Typst 專案則提供 EPUB。

帶入既有的作品 · 匯出並轉換專案

在 設定 → 一般 → 語言 下選擇 系統 或 21 種語言之一,從 简体中文 與 日本語 到 Deutsch 與 Español。介面會立即改變,不需重新啟動。這項設定控制的是應用程式的標籤與訊息。文件語言、校對字典與助理的輸出語言則是各自獨立的選擇。

更改應用程式語言

預檢把編譯、版面、參考文獻、資源、盲審、ATS 與無障礙的檢查結果集中在同一處。它的 PDF/UA 區段會檢查一組已定義、可由機器測試的子集,而標記 PDF 工作流程則會讓相容的 LaTeX 專案為 LuaLaTeX 做好準備。指南會說明哪些結果是確定的、哪些是啟發式的,以及為什麼乾淨的檢查結果不等於正式的 PDF/UA 認證。

執行預檢並準備標記 PDF

當 latexmk 建置回報缺少 TeX 檔案時,Oleafly 可以找出擁有該檔案的 TeX Live 套件、安裝它,並再次編譯。套件管理員也能搜尋完整的 TeX Live 目錄,並顯示套件位於系統目錄樹還是個人目錄樹。

選擇 LaTeX 引擎並管理套件

設定 → 說明與關於 現在附有可直接複製的 Oleafly BibTeX 條目。在開啟的專案中,在這篇論文中引用 Oleafly 可以把該條目加入文件所用的參考文獻。

複製或插入 Oleafly 引用

逐版本的變更請見 GitHub Releases (在新分頁開啟)。在應用程式中,開啟 設定 → 說明與關於 可檢查更新。應用程式更新說明更新流程。

圖片預覽

無法載入 AI 回答

請再試一次,或搜尋文件。