Инструменты документа
Настройки документа
Меняйте размер страницы, поля, шрифт, язык, межстрочный интервал и нумерацию в диалоге, который правит преамбулу 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) отменяет всё изменение целиком.
Куда попадают значения
Заголовок раздела «Куда попадают значения»- Размер страницы, Колонки и Размер шрифта становятся параметрами
\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}{…}для вариантов По разделам, По главам или По подразделам.
Значения попадают в правила #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
Заголовок раздела «Markdown»Значения попадают в YAML front matter, который Pandoc читает при сборке PDF: type, documentclass, papersize, classoption для колонок, geometry для полей, mainfont, fontsize, lang, linestretch и numbersections. Тип документа предлагает Статья, Отчёт или диссертация, Книга, Слайды, Постер, Письмо и Резюме и определяет, что собирает документ. См. Типы документов. Класс документа предлагает article, report, book, scrartcl, scrreprt и memoir. Язык принимает тег вида en-US.
Там, где вы не задали шрифт, Oleafly выбирает его для каждого письма в документе, например корейского, арабского или деванагари. Язык также определяет, какой шрифт получат китайские иероглифы: ja даёт японский шрифт, zh — упрощённый китайский, а zh-TW — традиционный китайский. См. Текст на других языках.
Если у файла ещё нет front matter, диалог сообщает об этом, а Применить добавляет блок в начало. Front matter без закрывающей строки --- сначала придётся исправить вручную.
Поля только для чтения
Заголовок раздела «Поля только для чтения»Некоторые значения принадлежат чему-то другому, и диалог показывает их серыми, указывая причину под ними:
- Задаётся классом …: классы вроде
acmart,IEEEtran,llncsиbeamerфиксируют свои поля, а некоторые также размер страницы, размер шрифта, колонки, межстрочный интервал или язык. Наверху диалога называется класс. - Задаётся стилем …: пакеты стилей конференций, например для NeurIPS, ICML, ICLR, CVPR и ACL, задают размер страницы и поля. Наверху диалога указано, какой стиль за это отвечает.
- Источник задаёт каждое поле отдельно: документ определяет левые, правые, верхние и нижние поля по отдельности вместо одного значения
margin. - Задаётся внутри условного блока: значение находится внутри кода
\if…, поэтому изменение его здесь может сломать логику. - Задаётся шаблоном: в Typst правило
#set, содержащее значение, имеет условиеifили передаёт аргументы.., как это часто бывает в коде шаблонов, поэтому диалог его не трогает. - Задаётся выражением в исходнике: значение вычисляется, а не записано явно, поэтому правьте сам исходник.
Когда к документу Typst применяется шаблон, наверху появляется заметка о том, что значения, заданные внутри шаблона, не показаны, и что значение, заданное здесь, переопределяет шаблон. В LaTeX похожая заметка появляется, когда часть преамбулы находится в других файлах.
Связанные страницы
Заголовок раздела «Связанные страницы»- Пакеты: добавьте другие пакеты LaTeX или Typst
- Компиляция: выберите XeLaTeX или LuaLaTeX и вариант сборки Typst
- Сведения о документе: посмотрите, что содержит документ