# 新功能

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

最新的更新加入了禪模式，也讓你在輸入時直接從 Zotero 引用。編輯器還有淺色模式與深色模式各一個主題，顏色可以自行更改。在那之前，Typst 追上了 LaTeX，每個引擎都有了相同的文件工具，CLI 代理程式也變得更容易設定與檢查。本頁會指向完整說明，而不是重複列出發行說明。

## 寫作時從 Zotero 引用

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

[從你的 Zotero 文獻庫引用](/docs/citations/#cite-from-your-zotero-library) · [連接 Zotero](/docs/integrations/research-sources/#zotero)

## 編輯器主題與顏色

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

[編輯器主題](/docs/settings/appearance/#editor-themes) · [編輯器顏色](/docs/settings/appearance/#editor-colors)

## 禪模式

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

[禪模式](/docs/editor/#zen-mode)

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

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

[路徑會隨移動的檔案更新](/docs/files/#paths-follow-a-moved-file)

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

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

[為新專案設定預設值](/docs/engines/#set-a-default-for-new-projects)

## 縮放、字型與新的快捷鍵

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

[外觀與主題](/docs/settings/appearance/) · [鍵盤快捷鍵](/docs/keyboard-shortcuts/)

## 系統 LaTeX 與外部命令

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

[當 Tectonic 不夠用時](/docs/latex-engines/#when-tectonic-isnt-enough) · [允許外部命令](/docs/latex-engines/#allow-external-commands) · [在 Linux 上安裝](/docs/install/#linux)

## Typst，與 LaTeX 一樣完整

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

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

[設定 Typst 專案](/docs/typst/) · [用 Typst 寫作](/docs/writing/typst/) · [將 LaTeX 專案轉換為 Typst](/docs/typst/#convert-a-latex-project-to-typst)

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

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

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

[套件](/docs/packages/) · [文件設定](/docs/document-settings/) · [文件分析](/docs/document-insights/)

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

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

[繪製圖表](/docs/figures-diagrams/)

## 從 PDF 放映投影片

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

[放映投影片](/docs/present-slides/)

## 像搜尋 GitHub issue 一樣搜尋專案庫

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

[搜尋你的專案](/docs/library/#search-your-projects)

## Zotero 與 alphaXiv

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

[連接 Zotero](/docs/integrations/research-sources/#zotero) · [連接 alphaXiv](/docs/integrations/research-sources/#alphaxiv)

## 可以檢查與復原的 CLI 代理程式

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

[設定 CLI 代理程式](/docs/cli-agents/) · [審閱並復原變更](/docs/cli-agents/#review-and-undo-changes) · [研究起點](/docs/cli-agents/#research-starting-points)

## 可以搜尋的設定

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

[設定](/docs/settings/#find-a-setting)

## 每個 Oleafly 工具都有指南

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

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

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

[瀏覽全部 47 個工具](/docs/tools/)

## 看得懂原始檔的校對

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

[設定校對與學術風格](/docs/spellcheck-grammar/)

## 更快的 LaTeX 編輯

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

[使用自動完成與結構化輸入](/docs/autocomplete/) · [認識編輯器](/docs/editor/)

## 更可靠的參考文獻

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

[管理引用與參考文獻](/docs/citations/) · [開啟參考文獻工具](/docs/tools/#build-references)

## 跨寫作格式匯入與匯出

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。

[帶入既有的作品](/docs/import-project/) · [匯出並轉換專案](/docs/export/)

## 21 種語言的介面

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

[更改應用程式語言](/docs/localization/)

## PDF 無障礙與投稿檢查

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

[執行預檢並準備標記 PDF](/docs/preflight/)

## TeX 套件復原

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

[選擇 LaTeX 引擎並管理套件](/docs/latex-engines/)

## 更容易引用軟體

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

[複製或插入 Oleafly 引用](/docs/settings/help/#cite-oleafly-in-a-paper)

## 發行說明與更新

逐版本的變更請見 [GitHub Releases](https://github.com/Oleafly/Oleafly/releases)。在應用程式中，開啟 **設定 → 說明與關於** 可檢查更新。[應用程式更新](/docs/updates/)說明更新流程。