Интеграция с Mendeley

Эта возможность предоставляется ayaka-notes/ayakaleaf-pro с поддержкой OAuth 2.0 и доступна начиная с версии v6.3.0. Если вы столкнётесь с проблемами, мы будем рады вашим отзывам.

​

Настройка интеграции с Mendeley

1. Перейдите по этой ссылке, чтобы зарегистрировать OAuth-приложение Mendeley
2. Укажите Redirect URL: ${OVERLEAF_SITE_URL}/user/mendeley/oauth/callback
3. Запишите сгенерированные ID (обычно числовой, например 24061, как показано ниже) и Secret вашего приложения
4. Измените файл config/variables.env
5. Оставьте Authorisation Flow: Elsevier (как рекомендуется)

config/variables.env

#################
#   Mendeley    #
#################
# 'mendeley' must be in ENABLED_LINKED_FILE_TYPES (keep 'zotero' too if you use both)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,mendeley

# From a Mendeley OAuth application (register at https://dev.mendeley.com/myapps.html)
# Redirect URL -> ${OVERLEAF_SITE_URL}/user/mendeley/oauth/callback
MENDELEY_CLIENT_ID=
MENDELEY_CLIENT_SECRET=
# Encrypts the Mendeley OAuth tokens in mongo; if unset, a key file is generated
# in /var/lib/overleaf/data on first use
# How to generate: `openssl rand -hex 32`
MENDELEY_CIPHER_PASSWORD=
# Optional: route the module's server-side Mendeley 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) MENDELEY_PROXY_URL=

mendeley должен быть включён в ENABLED_LINKED_FILE_TYPES (если вы используете обе интеграции, оставьте в списке и zotero). MENDELEY_CLIENT_ID и MENDELEY_CLIENT_SECRET берутся из зарегистрированного OAuth-приложения. Пароль шифрования (cipher password) используется для шифрования OAuth-токенов Mendeley в MongoDB (его можно сгенерировать командой openssl rand -hex 32); если он не задан, при первом использовании в томе данных будет создан файл ключа. При необходимости задайте MENDELEY_PROXY_URL, чтобы направлять серверные запросы к Mendeley (OAuth + API) через HTTP-прокси, доступный из контейнера web.

​

Примечания

При обновлении существующей установки, содержащей связанные файлы библиографии Mendeley, до повторно выпущенной версии 6.3.0 следуйте инструкциям по миграции Zotero / Mendeley. Для новых установок эта миграция не требуется.

Поскольку Ayakaleaf — платформа для совместной работы, в целях повышения безопасности, начиная с версии 6.3.0, обновлять импортированный файл библиографии bib может только его первоначальный создатель.

Например, предположим, что владелец проекта, пользователь A, включает доступ по ссылке и создаёт в проекте файл test.bib, связывая его со своей учётной записью Zotero. Если другой пользователь, пользователь B, получает доступ к проекту по общей ссылке, он по-прежнему сможет читать и скачивать test.bib, но не сможет обновить или повторно импортировать файл из Zotero. Выполнять обновления может только пользователь A как первоначальный создатель файла библиографии. Иными словами, право обновлять файл .bib есть только у его первоначального создателя.