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

Знайдіть джерело, перегляньте його метадані, додайте його до потрібної бібліографії, процитуйте в позиції курсора, виберіть стиль цитування 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:` до блоку метаданих на початку файла, коли це потрібно.

Якщо 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:` у блоці метаданих 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:` у блоці метаданих.

Коли бібліографію не оголошено, 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 імпортує до 5,000 записів. Сторінка [Підключення дослідницьких джерел](/docs/integrations/research-sources/#zotero) пояснює налаштування крок за кроком.

Oleafly перетворює записи у формат BibTeX і пропускає джерела, чиї DOI вже є в цільовій бібліотеці або раніше в тій самій партії. Він створює ключі без конфліктів і додає результат одним записом. У повідомленні сказано, скільки джерел додано і скільки вже було раніше. Імпорт бібліотеки не вставляє цитування в позицію курсора.

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

## Очищення бібліотеки джерел

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

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

Засіб очищення перейменовує ключі на послідовний шаблон автор-рік-назва й оновлює цитування в усіх вихідних файлах проєкту. Він видаляє дублікат DOI, лише коли збережений запис містить усі поля видаленого. Конфліктні записи DOI та схожі назви позначаються для перегляду, а не зливаються наосліп.

Коментарі та визначення рядків BibTeX зберігаються. Застосування спершу перевіряє, що бібліотека все ще відповідає попередньому перегляду, і створює резервну копію перед зміною файлів. Великі різниці показують у попередньому перегляді перші 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/) шукає в наукових покажчиках або сканує відкриту чернетку на уривки, які можуть потребувати опори. Прочитайте статтю, перш ніж цитувати її, і тримайте кожне твердження в межах того, що встановлюють методи й результати.
