# 拼写、语法与学术风格

在本地校对 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}` 这样的转义会被读成它所代表的字母，这里是 é。在图注或单元格里输入的 `"` 会被当作文本，所以不会让检查提前中断，语法检查读到的文本也与拼写检查一致。随项目附带的 `typst-packages` 文件夹中的文件不会被校对。

任何屏蔽机制都无法理解每一个自定义宏。如果项目命令里含有可打印的行文却被跳过，请暂时展开它，或者把那一段放进普通段落里校对。

## 修复一条检查结果

选择一处下划线，打开它的卡片。卡片会写明发现了什么，对语法问题显示 Harper 的规则，并提供适用的操作。

### 拼写操作

- 选择一个替换词，把它应用到源码中的确切范围。
- **在此项目中忽略**会把某篇论文特有的术语加入项目词典。
- **全局忽略**会把个人的术语加入全局词典。
- **暂时忽略**会在当前应用会话中隐藏该词。

对于只在一篇稿件中使用的研究缩写、受试者编号或专业术语，请使用项目范围。对于你的姓名、所在机构，或你在各个项目中都会用到的词汇，请使用全局范围。

### 语法和风格操作

- 应用建议的替换、删除或插入。
- **在此项目中忽略**会在那个句子上隐藏该规则，同时让同一条规则在其他地方继续生效。
- **关闭规则**会在所有项目中停用该条 Harper 规则。

忽略一条检查结果时，同一段文本上重叠的检查结果在本次会话的剩余时间里也会一并清除。这样可以避免刚忽略的那条下面立刻又冒出第二条下划线。

## 学术配置

Harper 是为通用行文设计的，包括聊天和电子邮件。它的一些默认设置与正常的学术写作相冲突。因此，Oleafly 的学术配置让一组有文档依据的规则保持关闭，其中包括对长句、委婉表达、`kB` 和 `min` 这类标准缩写、牛津逗号争议中的一方，或本应属于源码标记的破折号惯例提出异议的规则。

打开**设置 → 词典 → 语法规则与已忽略的问题**，可以看到每条配置规则、它被关闭的原因和一个示例。请开启符合你所投稿会议或期刊、或所在单位风格的规则。

同一部分还可以让你：

- 恢复你在检查结果卡片上关闭的规则；
- 显示你之前忽略过的项目检查结果；
- 移除项目词典或全局词典中的词；
- 重置校对的自定义设置，而不影响无关的设置。

:::caution[为什么“Boring Words”不可用]
`BoringWords` 规则可能使内置的 Harper 2.10 检查器崩溃。Oleafly 只强制关闭这一条规则，让其余的校对保持可靠。待上游的故障修复、并针对内置版本验证之后，该规则可以回归。
:::

## 何时使用更精简的检查

当产品名称、代码标识符或引用的措辞有意使用另一种变体时，请关闭地域用语建议。想要更安静的拼写和语法检查时，请关闭用词建议。只需要词典反馈时，请关闭 Harper，保留拼写检查。

超过约 150,000 个字符的文件会跳过语法检查，以保持输入的流畅。可以把很长的稿件拆分到被包含的多个文件中，或一次校对一章。拼写检查可以独立继续运行。

## 校对无法决定的事

Oleafly 能发现不一致、重复的词或别扭的写法。但它无法核实论断、判断证据的强弱、保留改写中的每一处细微差别，也无法知道某个领域特有的措辞是有意为之。

应用建议之后，请再读一遍那个句子。最后一遍通读时，请编译文档，并在上下文中审阅行文，包括图注、标题、脚注和参考文献。

桌面应用的界面语言与校对相互独立。[语言与本地化](/docs/localization/)说明了如何在英语论文中使用中文界面，或在其他写作语言下使用英文界面。
