> ## 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 وما بعده. ولا تزال في مرحلة تجريبية (beta). نحتاج إلى ملاحظاتك إذا واجهت أي مشكلة.

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