التكامل مع Zotero

اسمح للمستخدمين باستيراد ملف ‎.bib من مكتبة Zotero الخاصة بهم إلى مشروع.

طُوّرت هذه الميزة في البداية من قِبل davrot و yu-i-i/overleaf-cep، ثم عدّلها ayaka-notes/ayakaleaf-pro لتدعم OAuth. وقد قُدّمت بدءًا من الإصدار v6.2.0 وما بعده. ولا تزال في مرحلة تجريبية (beta). نحتاج إلى ملاحظاتك إذا واجهت أي مشكلة.

​

إعداد التكامل مع Zotero

1. افتح هذا الرابط لإنشاء عميل Zotero OAuth (كما هو موضح في الصورة)
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، إلى المشروع عبر الرابط المشترك، فسيظل بإمكان المستخدم 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.