# Настройки документа

Меняйте размер страницы, поля, шрифт, язык, межстрочный интервал и нумерацию в диалоге, который правит преамбулу LaTeX, правила #set в Typst или front matter в Markdown.

Каждый язык хранит настройки страницы в разных местах: параметры класса и команды преамбулы в LaTeX, правила `#set` в Typst, front matter в Markdown. **Настройки документа** дают одну форму для всего этого. При применении Oleafly записывает изменение в главный файл как обычный исходный код, который вы можете позже прочитать и отредактировать.

Откройте его кнопкой **Настройки документа** на правом конце панели редактора или выполните **Настройки документа** из палитры ⌘K (Ctrl+K). Диалог всегда правит главный документ проекта, какой бы файл у вас ни был открыт.

## Поля формы

Форма состоит из четырёх разделов. Набор полей зависит от движка:

| Раздел | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| Страница | Размер страницы, Колонки, Поля | Размер страницы, Поля, Колонки | Тип документа, Класс документа, Размер страницы, Колонки, Поля |
| Текст | Шрифт текста, Размер шрифта, Язык | Шрифт текста, Размер шрифта, Язык, Регион | Шрифт текста, Размер шрифта, Язык |
| Абзац | Межстрочный интервал | Выравнивание, Межстрочный интервал | Межстрочный интервал |
| Нумерация | Нумеруемые уровни, Нумерация формул | Нумерация заголовков, Нумерация формул | Номера разделов |

Списки начинаются с пункта **По умолчанию**, который убирает настройку, чтобы снова вступило в силу значение по умолчанию класса, шаблона или движка. Пустое текстовое поле даёт тот же эффект. Длины принимают единицы, например `2.5cm`, `1in` или `11pt`, а поля в Typst дополнительно принимают `auto`. Для значения, которое Oleafly не может использовать, под полем появляется короткое пояснение, а **Применить** ждёт, пока вы его не исправите.

**Шрифт текста** предлагает шрифты по мере ввода. В проектах Typst список содержит все шрифты, которые может найти Typst, и указывает, откуда берётся каждый: из папки `fonts` проекта, с компьютера или из встроенного набора Typst. В проектах LaTeX и Markdown перечисляются шрифты, установленные на компьютере.

Нажмите **Применить**, чтобы записать изменения, или **Отмена**, чтобы не трогать файл. Когда главный файл открыт в редакторе, одно нажатие ⌘Z (Ctrl+Z) отменяет всё изменение целиком.

## Куда попадают значения

### LaTeX

- **Размер страницы**, **Колонки** и **Размер шрифта** становятся параметрами `\documentclass`.
- **Поля** отправляются пакету geometry. Oleafly правит существующую `\geometry{…}` или параметр geometry либо добавляет `\usepackage[margin=…]{geometry}`.
- **Шрифт текста** записывает `\setmainfont{…}` и подключает fontspec. В проекте latexmk ему нужен компилятор XeLaTeX или LuaLaTeX, и поле сообщает об этом, пока вы не выберете один из них в меню компиляции или пока документ не попросит его сам, например строкой `% !TeX program = xelatex`.
- **Язык** добавляет язык в babel, использует `\setdefaultlanguage`, если документ подключает polyglossia, или добавляет `\usepackage[language]{babel}`. Используйте имена babel, например `english`.
- **Межстрочный интервал** — это **Одинарный**, **Полуторный**, **Двойной** или число, например `1.5`. Используется пакет setspace, а если в документе уже есть `\linespread`, то он.
- **Нумеруемые уровни** задают `secnumdepth`. Выберите **Нет**, **Только главы** или глубину нумерации — от **До разделов** до **До подпараграфов**.
- **Нумерация формул** записывает `\numberwithin{equation}{…}` для вариантов **По разделам**, **По главам** или **По подразделам**.

### Typst

Значения попадают в правила `#set` главного файла. Если правила нет, Oleafly добавляет его ближе к началу:

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`, где **Выравнивание** — это **По ширине** или **По левому краю**
- `#set heading(numbering: …)`, с шаблонами вроде `1.`, `1.1`, `1.a`, `I.` или `A.`
- `#set math.equation(numbering: …)`, с вариантами `(1)`, `(1.1)` или `1`

**Язык** принимает код из двух или трёх букв, например `en`, а **Регион** — код из двух букв, например `GB`.

В проектах Typst появляется также раздел **Варианты сборки**. Каждый вариант — именованный набор значений, который документ читает через `sys.inputs`, например черновая и финальная сборки. Нажмите **Добавить вариант**, задайте имя, а затем добавьте каждое значение кнопкой **Добавить значение**. Вариант для сборки выбирается пунктом **Вариант (этот проект)** в меню компиляции.

### Markdown

Значения попадают в YAML front matter, который Pandoc читает при сборке PDF: `type`, `documentclass`, `papersize`, `classoption` для колонок, `geometry` для полей, `mainfont`, `fontsize`, `lang`, `linestretch` и `numbersections`. **Тип документа** предлагает **Статья**, **Отчёт или диссертация**, **Книга**, **Слайды**, **Постер**, **Письмо** и **Резюме** и определяет, что собирает документ. См. [Типы документов](/docs/writing/markdown/#document-types). **Класс документа** предлагает `article`, `report`, `book`, `scrartcl`, `scrreprt` и `memoir`. **Язык** принимает тег вида `en-US`.

Там, где вы не задали шрифт, Oleafly выбирает его для каждого письма в документе, например корейского, арабского или деванагари. **Язык** также определяет, какой шрифт получат китайские иероглифы: `ja` даёт японский шрифт, `zh` — упрощённый китайский, а `zh-TW` — традиционный китайский. См. [Текст на других языках](/docs/writing/markdown/#text-in-other-languages).

Если у файла ещё нет front matter, диалог сообщает об этом, а **Применить** добавляет блок в начало. Front matter без закрывающей строки `---` сначала придётся исправить вручную.

## Поля только для чтения

Некоторые значения принадлежат чему-то другому, и диалог показывает их серыми, указывая причину под ними:

- **Задаётся классом …**: классы вроде `acmart`, `IEEEtran`, `llncs` и `beamer` фиксируют свои поля, а некоторые также размер страницы, размер шрифта, колонки, межстрочный интервал или язык. Наверху диалога называется класс.
- **Задаётся стилем …**: пакеты стилей конференций, например для NeurIPS, ICML, ICLR, CVPR и ACL, задают размер страницы и поля. Наверху диалога указано, какой стиль за это отвечает.
- **Источник задаёт каждое поле отдельно**: документ определяет левые, правые, верхние и нижние поля по отдельности вместо одного значения `margin`.
- **Задаётся внутри условного блока**: значение находится внутри кода `\if…`, поэтому изменение его здесь может сломать логику.
- **Задаётся шаблоном**: в Typst правило `#set`, содержащее значение, имеет условие `if` или передаёт аргументы `..`, как это часто бывает в коде шаблонов, поэтому диалог его не трогает.
- **Задаётся выражением в исходнике**: значение вычисляется, а не записано явно, поэтому правьте сам исходник.

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

## Связанные страницы

- [Пакеты](/docs/packages/): добавьте другие пакеты LaTeX или Typst
- [Компиляция](/docs/compiling/): выберите XeLaTeX или LuaLaTeX и вариант сборки Typst
- [Сведения о документе](/docs/document-insights/): посмотрите, что содержит документ
