# Орфография, грамматика и академический стиль

Вычитывайте документы 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`, строки в коде, метки, ссылки и блоки raw. Экранирование вроде `\u{e9}` читается как буква, которую оно обозначает, — здесь é. Введённый внутри подписи или ячейки символ `"` считается текстом, поэтому проверка не обрывается на нём, и грамматика читает тот же текст, что и орфография. Файлы в папке подключённых пакетов `typst-packages` не вычитываются.

Ни одна система маскировки не понимает все пользовательские макросы. Если команда проекта содержит печатный текст и он пропускается, временно разверните её или вычитайте этот фрагмент в обычном абзаце.

## Исправление замечания

Выберите подчёркивание, чтобы открыть его карточку. Карточка называет, что найдено, показывает правило Harper для грамматических замечаний и предлагает доступные действия.

### Действия для орфографии

- Выберите замену, чтобы применить её в точном диапазоне исходника.
- **Пропускать в этом проекте** добавляет термин конкретной работы в словарь проекта.
- **Пропускать везде** добавляет личный термин в глобальный словарь.
- **Пропустить пока** скрывает слово до конца текущего сеанса приложения.

Область проекта подходит для аббревиатуры исследования, кода участника или специального термина, который используется только в одной рукописи. Глобальная область — для вашего имени, учреждения или словаря, который вы используете в разных проектах.

### Действия для грамматики и стиля

- Примените предложенную замену, удаление или вставку.
- **Пропускать в этом проекте** скрывает правило в этом предложении, оставляя его активным в остальных местах.
- **Выключить правило** отключает названное правило Harper во всех проектах.

Игнорирование одного замечания также убирает пересекающиеся замечания на том же тексте до конца сеанса. Это мешает второму подчёркиванию появиться сразу под тем, которое вы только что закрыли.

## Академический профиль

Harper создавался для обычного текста, включая чаты и почту. Некоторые его умолчания противоречат нормальной научной письменной речи. Поэтому академический профиль Oleafly держит выключенным задокументированный набор правил, включая правила, которые возражают против длинных предложений, осторожных формулировок, стандартных сокращений вроде `kB` и `min`, одной из сторон спора об оксфордской запятой и соглашений о тире, уместных в разметке исходника.

Откройте **Настройки → Словарь → Правила грамматики и скрытые замечания**, чтобы увидеть каждое правило профиля, причину его выключения и пример. Включите любое правило, которое соответствует вашему журналу или внутреннему стилю.

Тот же раздел позволяет:

- восстановить правило, выключенное из карточки замечания;
- показать замечания проекта, которые вы ранее скрыли;
- удалить слова из словаря проекта или глобального словаря;
- сбросить настройки вычитки, не меняя посторонние параметры.

:::caution[Почему правило «Boring Words» недоступно]
Правило `BoringWords` может уронить поставляемый проверщик Harper 2.10. Oleafly принудительно выключает только это правило, чтобы остальная вычитка оставалась надёжной. Правило сможет вернуться, когда ошибка upstream будет исправлена и проверена на поставляемой версии.
:::

## Когда нужна более узкая проверка

Выключите подсказки по региональным вариантам, когда название продукта, идентификатор в коде или цитируемая формулировка намеренно использует другой диалект. Выключите подсказки по выбору слов, когда нужна более тихая проверка орфографии и грамматики. Выключите Harper и оставьте включённой Проверку орфографии, когда нужен только отклик по словарю.

Файлы длиннее примерно 150 000 символов пропускают грамматическую проверку, чтобы ввод оставался отзывчивым. Разделите длинную рукопись на подключаемые файлы или вычитывайте по одной главе за раз. Орфография может продолжаться независимо.

## Чего вычитка не может решить

Oleafly может найти несоответствие, повтор слова или неловкий оборот. Он не может проверить утверждение, оценить силу доказательств, сохранить все оттенки переписанного текста или узнать, что специальная формулировка намеренна.

Прочитайте предложение после применения подсказки. В финальном проходе скомпилируйте документ и просмотрите текст в контексте, включая подписи, заголовки, сноски и библиографию.

Язык интерфейса настольного приложения не зависит от вычитки. В разделе [Язык и локализация](/docs/localization/) объясняется, как использовать китайский интерфейс с англоязычной статьёй или английский интерфейс с другим языком письма.
