> ## 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/ru/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.