# Цитирование и библиография

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

Цитата — это цепочка: утверждение указывает на ключ, ключ указывает на запись в библиографии, а запись указывает на реальный источник. Oleafly держит эту цепочку на виду, чтобы быстрый поиск не превращался позже в загадочную ссылку.

![Панель «Источники» в Oleafly. Переключайтесь между разделами «Источники», «Цитаты» и «Символы»; фильтруйте текущий вид из поля поиска.](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## Цитирование во время работы

![Команда «Сослаться из проекта» открывает окно выбора библиографии. Ищите по ключу, автору или заголовку; «Найти и добавить новую цитату» открывает поиск в интернете.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

На панели инструментов LaTeX или Typst выберите **Сослаться из проекта** (значок `@`). Выполните поиск в текущей библиографии по ключу, автору или заголовку и выберите запись.

Можно также запустить **Добавить цитату** из палитры команд ⌘K или Ctrl+K. Oleafly вставляет синтаксис для активного проекта:

- `\cite{key}` в LaTeX;
- `@key` в Typst, со строкой `#bibliography(...)` в конце основного документа, если её там нет;
- `[@key]` в Markdown, со строкой `bibliography:` во front matter при необходимости.

Когда Zotero подключён, **Добавить цитату** показывает первыми совпадения из вашей библиотеки Zotero.

## Цитирование из библиотеки Zotero

Когда [Zotero подключён](/docs/integrations/research-sources/#zotero), введите `@` и часть имени автора, слово из заголовка, год или ключ. Рядом с собственными источниками проекта появляется вся ваша библиотека Zotero. Выберите статью, и Oleafly вставит ссылку тем способом, которым документ уже цитирует. В LaTeX подставляется команда, которую документ использует чаще всего, например `\citep` или `\parencite`, в Typst — `@key`, в Markdown — `[@key]`. Ввод `@` внутри существующей `\cite{...}` добавляет в неё ещё один ключ.

В `.bib` проекта попадает только эта одна запись, в конец файла, а остальной файл остаётся как был. Статья, которая уже есть в `.bib` под своим ключом или своим DOI, никогда не добавляется дважды. Записи никогда не содержат путей к PDF-файлам на вашем компьютере. Если в проекте ещё нет строки библиографии, Oleafly добавляет её: `\bibliography` или `\addbibresource` в LaTeX, `#bibliography` в Typst или `bibliography:` во front matter Markdown. Если файлов `.bib` несколько, Oleafly один раз спрашивает, в какой файл добавлять новые источники, и запоминает ваш ответ.

При первом цитировании из Zotero в статье LaTeX, где источники перечислены вручную в окружении `thebibliography`, Oleafly предлагает перенести этот список в `.bib`. После этого все источники находятся в одном нумерованном списке.

### Держите .bib в согласии с Zotero

Если процитированный ключ отсутствует в `.bib`, но есть в Zotero, доступно действие **Добавить из Zotero**. Запустите **Добавить недостающие цитаты из Zotero** из палитры ⌘K, чтобы сразу проверить все процитированные ключи. Команда добавляет те, что есть в Zotero, перечисляет отсутствующие и указывает ключи, ссылающиеся на работу, которая уже есть в вашей библиографии.

Когда статья меняется в Zotero, её запись в `.bib` получает действие **Обновить из Zotero**. Команда **Обновить записи .bib из Zotero** в палитре проверяет все изменённые записи. Запись, которую вы редактировали вручную, заменяется только после вашего подтверждения. **Синхронизировать библиотеку Zotero** перечитывает библиотеку. Oleafly никогда ничего не удаляет из `.bib` сам.

![Часть названия статьи вставлена в поиск, и её запись BibTeX сохранена в refs.bib.](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## Поиск и добавление нового источника

Выберите **Найти и добавить новую цитату** в окне выбора. Отправной точкой может быть любой из вариантов:

- DOI, например `10.1145/3592979`;
- идентификатор arXiv, например `1706.03762`;
- ISBN-10 или ISBN-13;
- идентификатор PubMed (PMID);
- URL, содержащий один из этих идентификаторов;
- заголовок статьи.

Поиск по DOI, arXiv, ISBN и PubMed использует их публичные каталоги. Поиск по заголовку возвращает возможные совпадения с авторами, годом и местом публикации, чтобы вы могли выбрать сами, а не принимать догадку.

Проверьте возвращённый BibTeX, затем выберите **Добавить в .bib и сослаться**. Oleafly:

1. добавляет ключ без конфликтов в активную библиографию;
2. использует существующую запись, если такой DOI уже есть;
3. вставляет ссылку в позиции курсора;
4. сразу обновляет дерево файлов и панель «Источники».

Метаданные можно редактировать. Исправьте запись до того, как она станет частью рукописи.

Когда документ объявляет больше одной библиографии, в диалоге появляется меню **Библиография**. Запись попадает в выбранный вами файл, и Oleafly запоминает выбор для этого проекта.

## Как Oleafly выбирает библиографию

Проекты LaTeX следуют объявлениям в действующем основном документе:

- `\addbibresource{references.bib}` для `biblatex`;
- `\bibliography{references}` для рабочих процессов BibTeX.

Пути разрешаются с тем же расширением и тем же поведением относительных путей, какого ожидает инструментарий TeX. Объявление, указывающее на отсутствующий файл, отмечается прямо в той строке исходника, а не приводит к тихой записи куда-то ещё.

Проекты Typst следуют вызову `#bibliography(...)`, называет ли он один файл или список и являются ли файлы BibTeX `.bib` или Hayagriva `.yml` и `.yaml`. Новая ссылка попадает в файл, объявленный документом. Если это файл Hayagriva, Oleafly преобразует запись BibTeX перед записью. Когда вызов называет несколько файлов, выберите целевой файл в меню **Библиография** диалога.

Проекты Markdown следуют полю `bibliography:` во front matter.

Когда библиография не объявлена, Oleafly использует первый `.bib` в проекте. Если такого нет, он создаёт `references.bib` и делает его доступным в дереве файлов и в окне выбора цитат.

В проекте с несколькими библиотеками проверяйте выбранный целевой файл перед добавлением записи.

## Выбор стиля цитирования в Typst

Когда в документе Typst есть вызов `#bibliography(...)`, внизу вида **Цитаты** панели «Источники» появляется меню **Стиль цитирования**. В нём перечислены встроенные стили Typst для версии Typst этого проекта, а также все файлы `.csl` в проекте. Выбор стиля записывает его в аргумент `style:` этого вызова. Без него Typst использует `ieee`.

Для LaTeX стиль задаётся в исходнике. `\bibliographystyle{` дополняет обычные стили BibTeX; с `biblatex` используйте его параметр `style=`.

## Импорт целой библиотеки источников

На панели «Источники» выберите **Импорт библиотеки источников**. Можно импортировать файл или вашу библиотеку Zotero.

**Из файла** выберите экспортированную библиотеку:

| Формат источника | Файл |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**Из Zotero**: один раз подключите аккаунт zotero.org в разделе **Настройки → Интеграции → Zotero**, затем выберите **Импортировать библиотеку Zotero** на карточке Zotero. Oleafly импортирует до 5000 элементов. Страница [Подключение источников для исследований](/docs/integrations/research-sources/#zotero) подробно описывает настройку.

Oleafly преобразует записи в BibTeX и пропускает источники, чей DOI уже есть в целевой библиотеке или раньше в той же партии. Он создаёт ключи без конфликтов и дописывает результат за одну запись в файл. В сообщении говорится, сколько источников добавлено и сколько уже было. Импорт библиотеки не вставляет ссылку в позиции курсора.

После импорта найдите новые записи в окне выбора цитат и проверьте выборку по исходному каталогу.

## Очистка библиотеки источников

Панель «Источники» может показать предпросмотр очистки до изменения файлов.

1. Откройте проект и выберите **Очистить библиотеку источников** на панели «Источники».
2. Выберите файл `.bib`, если в проекте их несколько.
3. Изучите список действий и diff «до/после».
4. Проверьте каждое предлагаемое переименование ключа, каждый удаляемый дубликат по DOI и каждое замечание.
5. Применяйте изменения, только когда предпросмотр соответствует вашим намерениям.

Очистка переименовывает ключи к единому шаблону «автор-год-заголовок» и обновляет ссылки во всех исходных файлах проекта. Дубликат по DOI удаляется, только если сохраняемая запись содержит все поля удаляемой. Конфликтующие записи с одним DOI и похожие заголовки помечаются для проверки, а не объединяются наугад.

Комментарии и определения строк BibTeX сохраняются. При применении Oleafly проверяет, что библиотека всё ещё соответствует предпросмотру, и создаёт резервную копию перед изменением файлов. Для больших различий предпросмотр показывает первые 500 строк; при применении изменений используются полные файлы.

:::caution[Проверьте перед применением]
Два издания, переводы, препринт и журнальная версия или статьи с похожими заголовками могут быть раздельными намеренно. Прочитайте замечание и сравните сами источники, прежде чем объединять что-либо вручную.
:::

## Автодополнение и навигация по источникам

Внутри команд цитирования LaTeX, таких как `\cite{}`, `\citep{}`, `\citet{}`, `\parencite{}` и `\textcite{}`, автодополнение ищет по всем файлам `.bib` проекта. В Typst `@` дополняет ключи из файлов `.bib` и Hayagriva. При подключённом Zotero список включает и вашу библиотеку Zotero.

Ссылка на запись, добавленную в `.bib`, пока этот файл не был открыт, например ассистентом или из Zotero, разрешается сразу. Не нужно сначала что-то печатать в документе.

- F12 или щелчок с клавишей-модификатором переходит от ключа цитирования к его записи.
- ⇧F12 перечисляет все использования источника.
- F2 переименовывает ключ во всех файлах исходников и библиографии.
- Наведение указателя показывает цель; неразрешённые или неоднозначные ключи помечаются до компиляции.

Страница [Анализ кода](/docs/code-intelligence/) подробно описывает модель навигации.

## Ссылка на Oleafly

Если Oleafly помог вам со статьёй, запустите **Сослаться на Oleafly в этой статье** из палитры команд или из нижней части вида **Цитаты** панели «Источники». Oleafly добавляет запись с ключом `oleafly` в объявленную документом библиографию: в формате BibTeX, а для файла Hayagriva — в Hayagriva. В сообщении называются файл и синтаксис для использования, например `\cite{oleafly}` или `@oleafly`, а рядом находится кнопка **Отменить**. Если запись уже есть, вы получите лишь напоминание о ключе.

Проект без файла библиографии остаётся без изменений, а диалог показывает запись, чтобы вы могли её скопировать. Та же запись всегда доступна в разделе [Настройки → Справка и о программе](/docs/settings/help/#cite-oleafly-in-a-paper).

## Сборка библиографии и Biber

Для `biblatex` Oleafly повторно запускает соответствующий шаг Biber, когда компилятор не создал пригодный `.bbl`. Сообщения Biber, включая отсутствие пути к `.bib`, появляются в журнале компиляции и в диагностике редактора.

Когда сбой происходит в самом Biber, журнал компиляции объясняет причину. Он называет недостающую системную библиотеку и предлагает `\usepackage[backend=bibtex]{biblatex}` как способ собрать документ без Biber. В Fedora `.rpm`-пакет Oleafly рекомендует две библиотеки, которые нужны Biber.

Если ссылки остаются неопределёнными:

1. Проверьте объявление библиографии и путь.
2. Откройте **Журнал** и найдите первое сообщение Biber или о библиографии.
3. Убедитесь, что ключ цитирования существует ровно один раз.
4. Перекомпилируйте после сохранения файла `.bib`.

Способы восстановления для конкретных движков описаны в разделах [Компиляция и журналы](/docs/compiling/) и [Движки и пакеты LaTeX](/docs/latex-engines/).

## Отдельные инструменты для источников

Готовить ссылки можно и без открытия проекта:

- [Генератор цитирования](/docs/tools/citation-generator/) принимает идентификаторы, заголовки, структурированные поля или BibTeX.
- [Генератор библиографии](/docs/tools/bibliography-generator/) собирает и проверяет список.
- [Генераторы цитирования по стилям](/docs/tools/citation-styles/) сравнивают восемь стилей.
- Отдельные инструменты работают с [DOI](/docs/tools/doi-to-bibtex/), [ISBN](/docs/tools/isbn-to-bibtex/), [идентификаторами PubMed](/docs/tools/pubmed-to-bibtex/), [arXiv](/docs/tools/arxiv-citation-generator/) и [веб-адресами](/docs/tools/url-to-bibtex/).

Ручное редактирование и форматирование цитат выполняются локально. Для поиска по идентификатору и заголовку нужно соединение с сетью. [Офлайн-режим](/docs/settings/general/#offline-mode) блокирует такой поиск, при этом автодополнение по существующей библиографии и навигация продолжают работать.

## Найдите подтверждение, а затем проверьте его

[Поиск цитат](/docs/tools/find-citations/) выполняет поиск по научным индексам или сканирует открытый черновик в поисках фрагментов, которым может понадобиться подтверждение. Прочитайте статью, прежде чем цитировать её, и держите каждое утверждение в рамках того, что устанавливают методы и результаты.
