> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Інтеграція із Zotero

> Дозвольте користувачам імпортувати файл .bib зі своєї бібліотеки Zotero у проєкт.

> [!NOTE]
>
> Цю функцію спочатку розробили [davrot](https://github.com/davrot) і [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), а [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) доопрацював її, додавши OAuth. Вона доступна починаючи з v6.2.0. Функція досі перебуває в статусі бета-версії. Якщо у вас виникнуть проблеми, нам потрібен ваш відгук.

![](https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max\&auto=format\&n=x9kfDjtWlyyhG_mR\&q=85\&s=80eb902caf484c8cfc1c776017ac2c66)

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-41.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=366c8e9396506163e23ffdc92fbe8c02)

### Налаштування інтеграції із Zotero

1. Відкрийте [це посилання](https://www.zotero.org/oauth/apps), щоб створити OAuth-клієнт Zotero (як показано на зображенні)
2. Виберіть **Application Type**: **Browser**
3. Укажіть Callback URL у вигляді `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Налаштуйте свій `config/variables.env`

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-42.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=7b2ed79ba28f7d77bc07711068ca71fc)

```dotenv title="config/variables.env" theme={null}
#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=
```

### Примітки

> [!WARNING]
>
> Під час оновлення наявної інсталяції, що містить пов'язані файли бібліографії Zotero, до перевипущеної версії 6.3.0 дотримуйтеся [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/uk/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Для нових інсталяцій ця міграція не потрібна.

> [!CAUTION]
>
> Оскільки Ayakaleaf — це платформа для спільної роботи, з метою підвищення безпеки, починаючи з версії 6.3.0, оновлювати імпортований файл `bib` із посиланнями зможе лише його початковий автор.

Наприклад, припустімо, що власник проєкту, Користувач A, вмикає спільний доступ за посиланням і створює в проєкті файл `test.bib`, пов'язуючи його зі своїм обліковим записом Zotero. Якщо інший користувач, Користувач B, отримає доступ до проєкту через спільне посилання, він зможе читати й завантажувати `test.bib`, але не зможе оновити або повторно імпортувати файл із Zotero. Виконувати оновлення може лише Користувач A як початковий автор файлу з посиланнями. Інакше кажучи, право оновлювати файл `.bib` має лише його початковий автор.

### Питання та відповіді

> [accordion] Як використовувати Zotero у проєкті?
>
> **Відповідь:** Після прив'язки Zotero в **Account Settings** відкрийте проєкт і натисніть **New file → From Zotero**. Виберіть назву файлу (за замовчуванням `zotero.bib`) і бібліотеку, а потім створіть файл. Цитуйте його записи як зазвичай, наприклад за допомогою `\bibliography{zotero}`.
>
> У редакторі файл доступний лише для читання. Після зміни вашої бібліотеки Zotero відкрийте файл і натисніть **Refresh**, щоб імпортувати його знову.

> [accordion] Чому «Main bibliography file for this project» порожній або неактивний?
>
> **Відповідь:** Цей параметр показує лише файли `.bib`, які можна редагувати в редакторі. Файли, імпортовані із Zotero, доступні лише для читання, тому їх не показано. Це очікувана поведінка: ви все одно можете цитувати їхні записи.

> [accordion] Чи має мій екземпляр бути доступним з інтернету?
>
> **Відповідь:** Ні. Прив'язка Zotero відбувається через браузер користувача, тож доступ до Zotero потрібен лише серверу. Якщо для цього потрібен проксі, встановіть `ZOTERO_PROXY_URL`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.