# 拼字、文法與學術風格

在本機校對 LaTeX、Markdown 和 Typst，套用精確的修正，並決定哪些字詞、發現項目和風格規則適合你的作品。

校對應該幫你把句子寫完，而不是跟句子裡的每個符號爭辯。Oleafly 會檢查標記語法周圍的文字，讓草稿留在你的裝置上，並為每個發現項目提供說明和下一步。

兩個本機引擎分工合作：

- **Hunspell** 依你選擇的確切字典檢查拼字。
- **Harper** 檢查英文的文法、用法、地區慣例和風格。

它們在背景執行緒中執行。你的稿件不會上傳到任何文法服務。

## 開啟校對

![設定 → 一般。校對控制項位於離線模式與導覽設定的上方。](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-general-dark-window-v2.png#view=519,89,883,902)

開啟**設定 → 一般**：

1. 開啟**拼字檢查**，進行以字典為基礎的拼字檢查。
2. 開啟**文法與風格（Harper）**，檢查英文文法與風格。
3. 選擇 Harper 應遵循的**英語變體**。
4. 選擇 Hunspell 應使用的**拼字字典**。
5. 決定是否需要**地區用語建議**和**用字建議**。

文法變體和拼字字典刻意分開。你可以將英式文法慣例搭配英式字典，也可以使用德文或法文的拼字字典，同時關閉英文文法檢查。

應用程式內建五種拼字語言包：英文（美國）、英文（英國）、英文（澳洲）、德文和法文。選擇其他任何語言時，Oleafly 會下載一次它的語言包，並保留供離線使用。Harper 文法支援美式、英式、澳洲、加拿大和印度英語。

## Oleafly 讀取什麼

校對適用於：

- LaTeX 的原始碼與視覺化編輯；
- Markdown 的原始碼與視覺化編輯；
- Typst 的原始碼與視覺化編輯。

指令、註解、數學、引用語法、中繼資料、URL 和類似程式碼的區域都會被排除。標題、強調、圖說、註腳和清單標籤等結構中的文字，仍然可以檢查。

例如，在以下的 LaTeX 中：

```latex
\section{A clearer result}
The estimates is stable for $n > 20$; see \cite{lee2026}.
```

Harper 可以標出「estimates is」，同時不去動 `\section`、`$n > 20$` 和 `\cite{lee2026}`。

在 Typst 中，內容引數裡的文字也會被檢查：圖說、表格和格線儲存格、註腳，以及範本欄位，例如 `title:` 和 `abstract:`。程式碼會被略過，包括 `#context` 後面的運算式、程式碼中的字串、標籤、參照和原始區塊。像 `\u{e9}` 這樣的跳脫序列會被讀成它所代表的字母，這裡是 é。在圖說或儲存格中輸入的 `"` 算作文字，所以不會中斷檢查，而且文法檢查讀到的文字和拼字檢查相同。放在 vendored `typst-packages` 資料夾中的檔案不會被校對。

沒有任何遮蔽系統能理解每一個自訂巨集。如果專案指令包含可印出的文字，而且該文字被略過，請暫時展開它，或把那一段放進一般段落中校對。

## 修正一個發現項目

選擇底線即可開啟它的卡片。卡片會指出發現了什麼，在文法發現項目上顯示 Harper 的規則，並提供適用的動作。

### 拼字動作

- 選擇一個替代字詞，即可在確切的原始碼範圍內套用。
- **在這個專案中忽略**會把這篇論文專用的詞彙加入專案字典。
- **一律忽略**會把你個人的詞彙加入全域字典。
- **暫時忽略**會在目前的應用程式工作階段中隱藏這個字詞。

研究的縮寫、受試者代碼，或只在一份稿件中使用的專業詞彙，請用專案範圍。你的姓名、所屬機構，或你在多個專案中使用的詞彙，則用全域範圍。

### 文法與風格動作

- 套用建議的替換、移除或插入。
- **在這個專案中忽略**會在該句子上隱藏那條規則，同時讓同一條規則在其他地方保持啟用。
- **關閉規則**會在所有專案中停用該條具名的 Harper 規則。

忽略一個發現項目，也會在這個工作階段剩餘的時間內，清除同一段文字上重疊的發現項目。這樣可以避免你剛駁回一條底線，下方立刻又冒出第二條。

## 學術設定檔

Harper 是為一般文字設計的，包括聊天和電子郵件。它的一些預設值與一般學術寫作格格不入。因此，Oleafly 的學術設定檔會讓一組有文件記載的規則保持關閉，包括反對長句、模糊限定語、`kB` 和 `min` 這類標準縮寫、牛津逗號爭議的其中一方，或屬於原始標記的破折號慣例的規則。

開啟**設定 → 字典 → 文法規則與已關閉的檢查結果**，可看到每一條設定檔規則、它被關閉的原因和一個範例。符合你投稿單位或機構風格的規則，請把它開啟。

同一個區段也讓你可以：

- 還原你從發現項目卡片中關閉的規則；
- 顯示你先前駁回的專案發現項目；
- 移除專案或全域字典中的字詞；
- 重設校對的自訂設定，而不更動不相關的設定。

:::caution[為什麼無法使用「Boring Words」]
`BoringWords` 規則可能讓內建的 Harper 2.10 檢查器當機。Oleafly 只強制關閉這一條規則，讓其餘的校對保持可靠。等上游的故障修復，並針對內建版本驗證之後，這條規則可能會回來。
:::

## 何時使用較精簡的檢查

當產品名稱、程式碼識別字或引述的用語刻意使用另一種變體時，請關閉地區用語建議。想要一次較安靜的拼字與文法檢查時，請關閉用字建議。只需要字典回饋時，請關閉 Harper 並保持拼字檢查開啟。

長度超過約 150,000 個字元的檔案會略過文法檢查，以維持輸入的流暢。請把長稿件拆成多個被引入的檔案，或一次校對一個章節。拼字檢查仍可獨立持續進行。

## 校對無法決定的事

Oleafly 能找出不一致、重複的字詞或彆扭的句型。它無法查證論述、判斷證據的強度、保留改寫的每一處細微差異，或知道特定領域的用語是否刻意為之。

套用建議之後，請再讀一次句子。最後一輪請編譯文件，並在上下文中檢視文字，包括圖說、標題、註腳和參考文獻。

桌面介面的語言與校對互相獨立。[語言與在地化](/docs/localization/)說明了如何用中文介面撰寫英文論文，或用英文介面撰寫其他語言。
