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

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

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

​

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

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

config/variables.env

#################
#    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=

​

Примітки

Під час оновлення наявної інсталяції, що містить пов’язані файли бібліографії Zotero, до перевипущеної версії 6.3.0 дотримуйтеся #ayakaleaf-pro-6.3.0. Для нових інсталяцій ця міграція не потрібна.

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

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

​

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

Як використовувати Zotero у проєкті?

Відповідь: Після прив’язки Zotero в Account Settings відкрийте проєкт і натисніть New file → From Zotero. Виберіть назву файлу (за замовчуванням zotero.bib) і бібліотеку, а потім створіть файл. Цитуйте його записи як зазвичай, наприклад за допомогою \bibliography{zotero}.

У редакторі файл доступний лише для читання. Після зміни вашої бібліотеки Zotero відкрийте файл і натисніть Refresh, щоб імпортувати його знову.

Чому «Main bibliography file for this project» порожній або неактивний?

Відповідь: Цей параметр показує лише файли .bib, які можна редагувати в редакторі. Файли, імпортовані із Zotero, доступні лише для читання, тому їх не показано. Це очікувана поведінка: ви все одно можете цитувати їхні записи.

Чи має мій екземпляр бути доступним з інтернету?

Відповідь: Ні. Прив’язка Zotero відбувається через браузер користувача, тож доступ до Zotero потрібен лише серверу. Якщо для цього потрібен проксі, встановіть ZOTERO_PROXY_URL.