# Библиотека

Ваш домашний экран: проекты в виде книг, закладки, предпросмотр при наведении, ответвления и поиск по проектам с синтаксисом поиска GitHub.

Библиотека — это домашний экран Oleafly. Каждый проект появляется на полке в виде книги, первыми идут те, с которыми работали недавно, и всё, что нужно для управления проектами, происходит здесь.

![Проект показывает предпросмотр первой страницы при наведении, затем поиск и фильтры сужают библиотеку.](https://cdn.oleafly.com/images/gifs/desktop/library.gif?v=2)

## Полка

На каждой карточке показаны имя проекта и цвет обложки. Обложка также говорит, что это за проект: документ, изображение или диаграмма, а для папки, открытой прямо с диска, — «внешний». Под карточкой указаны движок (LaTeX, Typst или Markdown) и время последнего изменения. Откройте проект, чтобы вернуться к его исходнику и предпросмотру.

Кнопки в правом верхнем углу переключают вид: плитку, где видны обложки, и список, который удобнее просматривать.

Когда библиотека пуста, экран приветствия предлагает **Новый проект** и **Открыть папку**.

## Создание проекта

Нажмите **Новый проект** и выберите, с чего начать:

- **Использовать шаблон** для статьи, диссертации, резюме, презентации или пустого документа. Откройте [галерею шаблонов](/docs/templates/), выберите шаблон и назовите проект.
- **Импорт проекта**, чтобы перенести существующие файлы. О каждом формате см. [Перенос существующего проекта](/docs/import-project/).
- **Исследовательский проект**, чтобы организовать [исследовательскую рабочую область](/docs/research-workspace/) с документами, источниками и задачами.

Если не выбрать цвет обложки, новый проект получит случайный цвет из палитры. Oleafly также записывает файлы проекта первым коммитом Git с именем «Create project». См. [Git и контроль версий](/docs/git-history/#the-first-commit).

Галерею также можно открыть откуда угодно через омнибар поиска: нажмите ⌘⇧F (Ctrl+Shift+F) и введите `/create`.

## Папки, открытые прямо с диска

**Открыть папку** (⌘⇧O / Ctrl+Shift+O) позволяет работать с папкой там, где она уже лежит, не копируя её в библиотеку. Сборки, настройки, контрольные точки и чаты для этой папки попадают в собственную папку данных Oleafly, поэтому в вашу ничего не добавляется. Папка стоит на полке с пометкой «внешняя», и её карточка сообщает, когда папка пропала или её диск не подключён.

В папке, открытой таким способом, Oleafly ограничивает некоторые возможности, например Git, внешних агентов и системный LaTeX через `latexmk`. Баннер над редактором предлагает **Доверять этой папке**, чтобы их включить. Доверяйте только папкам, содержимое которых вам известно. До этого папка компилируется встроенным движком Tectonic. Когда вы доверитесь папке, папка без собственного движка будет следовать [движку компиляции по умолчанию](/docs/engines/#set-a-default-for-new-projects). Внешним командам и после этого нужно отдельное [разрешение](/docs/latex-engines/#allow-external-commands).

[Облачная синхронизация](/docs/cloud-sync/) создаёт резервные копии только проектов из вашей библиотеки, поэтому папка, открытая прямо с диска, не синхронизируется.

Щёлкните правой кнопкой по карточке внешней папки, чтобы показать папку в файловом менеджере, выберите **Скопировать в библиотеку**, чтобы создать принадлежащий вам проект, или **Убрать из Oleafly** — файлы при этом останутся на своих местах. Папки также можно открывать из Finder, Проводника или терминала; см. [Интеграция с системой](/docs/settings/general/#system-integration).

## Предпросмотр при наведении

Наведите курсор на книгу, и первая страница её последнего скомпилированного PDF выдвинется на обложку — так вы различите свои статьи с первого взгляда. Предпросмотры берутся из настоящего результата компиляции и кэшируются, поэтому полка остаётся быстрой.

Если вы не хотите их видеть, выключите **Просмотр PDF при наведении** в разделе **Настройки → Внешний вид → Просмотр PDF**.

## Закладки

Наведите курсор на книгу и нажмите её значок закладки, чтобы добавить проект в закладки. Чтобы показать только проекты с закладками, введите `is:bookmarked` в поле поиска или установите в расширенных фильтрах **Закладка** в значение **С закладкой**.

![Статья, ответвлённая для повторной подачи, и у копии появляется собственный цвет обложки.](https://cdn.oleafly.com/images/gifs/desktop/fork-color.gif?v=2)

## Контекстное меню

Щёлкните правой кнопкой по любой книге:

- **Открыть проект**
- **Сведения о проекте**: имя, ID, движок, вид, главный документ, даты и другие метаданные, которые использует поиск.
- **История экспорта**: файлы, экспортированные из этого проекта.
- **Цвет проекта**: одиннадцать цветов обложки (Синий, Кремовый, Персиковый, Розовый, Малиновый, Сиреневый, Небесный, Аквамарин, Голубой, Мятный, Весенний). Цвет хранится в самом проекте, поэтому он переезжает вместе с проектом при синхронизации на другой компьютер.
- **Создать ответвление проекта**: копирует проект и всю его историю Git в новый проект. Диалог предлагает имя `<name> (copy)`; задайте любое, какое хотите. Используйте копию, чтобы попробовать другую версию резюме или статьи. У копии с самого начала нет контрольных точек.
- **Удалить проект**: перемещает проект в Корзину, откуда его можно восстановить.

## Переименование проекта

Откройте проект и нажмите его заголовок в верхней панели инструментов. Он станет редактируемым прямо на месте: введите новое имя и нажмите Enter. Переименование сохраняется в собственных метаданных проекта.

## Поиск по проектам

Поле поиска вверху домашнего экрана фильтрует полку по мере ввода. Оно использует тот же синтаксис, что и поиск задач и pull request'ов на GitHub. Обычные слова ищут совпадения в имени проекта, ID, главном файле, пути к папке, экспортах, движке, виде и цвете обложки. Квалификаторы сужают список:

| Квалификатор | Пример | Находит |
| --- | --- | --- |
| `is:` | `is:bookmarked`, `is:folder`, `is:library`, `is:forked` | Проекты с закладкой, папки, открытые прямо с диска, проекты, хранящиеся в Oleafly, ответвления |
| `has:` и `no:` | `has:preview`, `no:exports` | Проекты с предпросмотром скомпилированного PDF или экспортами и без них |
| `engine:` | `engine:typst`, `engine:latex` | LaTeX, Typst или Markdown |
| `kind:` | `kind:image` | Проекты документов, изображений или диаграмм |
| `color:` | `color:mint` | Цвет обложки по названию образца |
| `created:`, `updated:`, `opened:` | `created:>2026-01-01`, `updated:>@today-1w` | Дата создания, последнего изменения или последнего открытия |
| `in:` | `draft in:name` | Ограничивает слова полями `name`, `id`, `file`, `path` или `export` |
| `sort:` | `sort:name-asc`, `sort:created` | Порядок на полке |

`engine:latex` находит все проекты LaTeX, независимо от того, каким движком LaTeX они собираются. Прежний `engine:tectonic` по-прежнему работает и находит те же проекты.

### Комбинирование условий

Правила такие же, как у GitHub:

- Пробел означает AND. `AND` и `OR` в верхнем регистре и скобки группируют условия до пяти уровней вложенности. AND имеет более высокий приоритет, чем OR.
- Запятые перечисляют альтернативы: `engine:typst,markdown` соответствует любому из движков. Повтор квалификатора означает «и то и другое», поэтому `engine:typst engine:markdown` не найдёт ничего.
- Начальный `-` исключает: `-kind:image`, `-is:bookmarked`. Работает и `NOT`, а `-word` убирает проекты, содержащие это слово.
- Кавычки удерживают пробелы внутри: `"lab notes"`, `in:path "My Papers"`.

```text
(engine:typst OR engine:markdown) is:bookmarked -kind:image sort:updated-desc
```

### Даты и сортировка

Даты принимают `>`, `>=`, `<` и `<=`, диапазоны вида `2026-01-01..2026-03-31` (для открытого конца используйте `*`) и относительные даты: `@today`, `@today-7d`, `@today-2w`, `@today-1m` или `@today-1y`. `created:>@today-1w` означает последние семь дней.

`sort:` принимает `activity`, `updated`, `created`, `opened` или `name`, каждое с `-asc` или `-desc`. Без направления сортировка идёт по убыванию. По умолчанию это недавняя активность.

### Подсказки и предупреждения

Нажмите на поле поиска, пока оно пусто, и раскрывающийся список покажет квалификаторы. По мере ввода появляются подсказки: квалификаторы, их значения, AND, OR и «Исключить». Перемещайтесь по списку стрелками и нажмите Enter, чтобы принять подсказку. Tab или Escape закрывает список, ничего не принимая.

Квалификаторы и значения подсвечиваются цветом по мере ввода. Ошибка получает янтарную подсветку и короткую подсказку, что именно не так: скажем, незакрытая скобка или значение, которое квалификатор не принимает. Неизвестный квалификатор ищется как обычный текст, а недопустимое значение игнорируется.

### Расширенные фильтры

Кнопка с ползунками рядом с полем поиска открывает **Расширенные фильтры** с меню «Движок», «Вид проекта», «Закладка», «Просмотр PDF», «Создан», «Изменён» и «Сортировать по». Меню «Расположение» присоединяется к ним, когда вы хоть раз открыли папку прямо с диска. Каждое меню правит текст поиска, поэтому поле и панель всегда согласованы. Когда панель не может показать ваш запрос одним вариантом, в меню стоит **Пользовательский**. **Сбросить** убирает квалификаторы, сохраняя обычные слова.

## Поиск по всему

Омнибар поиска (⌘⇧F / Ctrl+Shift+F или **Поиск по документам** в доке) ищет по метаданным проектов и полному тексту каждого документа в каждом проекте. Он сразу переходит к подходящим проекту, файлу и строке. Введите `/` для команд с областью действия, например `/projects`, `/docs` или `/create`.

У омнибара есть собственные, более простые фильтры, например `name:resume` или `bookmark:yes`. Описанный выше синтаксис в стиле GitHub относится к полю поиска на домашнем экране.

## Домашний док

Небольшой док на домашнем экране собирает всё, что не является проектом:

- **Новый проект**: начать с шаблона, импортировать файлы или создать исследовательскую рабочую область.
- **Поиск по документам**: омнибар поиска (⌘⇧F / Ctrl+Shift+F).
- **Конструктор диаграмм**: [конструктор диаграмм](/docs/figures-diagrams/), без открытия проекта. Он спрашивает, для чего нужна диаграмма: **Диаграмма TikZ**, **Диаграмма Typst** или **Диаграмма Mermaid**.
- **Заметки**: открывает [«Заметки»](/docs/notes/). Показывается, пока **Заметки** включены в **Настройки → Эксперименты**.
- **Инструменты Oleafly**: галерея утилит для документов с поиском (ниже).
- **Оформление**: переключение между «Светлая», «Тёмная» и «Как в системе».
- **Настройки**: шестерёнка или ⌘, (Ctrl+,) открывает полное окно [настроек](/docs/settings/).

## Инструменты Oleafly

Включите **Инструменты LaTeX** в разделе **Настройки → Эксперименты**, чтобы показать галерею **Инструменты Oleafly**. В ней конвертеры между LaTeX, Typst, Markdown, Word, HTML и изображениями, а также сборщики библиографии, валидаторы, научные справочники, статистические калькуляторы и помощники письма. [Руководство по инструментам Oleafly](/docs/tools/) рассказывает о каждом.

## Где полка хранится на диске

Каждая книга — обычная папка в `~/.oleafly/projects/` с человекочитаемым случайным именем вроде `flying-pink-pikachu`. В библиотеке нет ничего проприетарного: см. [Где хранятся ваши данные](/docs/where-your-data-lives/).

## Корзина

Удалённый проект остаётся в Корзине, пока вы не восстановите его или не удалите навсегда. Оба действия находятся в разделе **Настройки → Хранение данных**. См. [Хранилище и Корзина](/docs/settings/storage/#recycle-bin).
