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

> اربط حسابك في Zotero، واستورد مكتبة إلى ملف .bib، واقتبس منه، وحدّثه، وألغِ الربط.

استورد مكتبة Zotero إلى مشروع كملف `.bib`، ثم اقتبس منه كالمعتاد. الملف نسخة: لا يتغير إلا عندما تنقر على **Refresh**.

> [!NOTE]
>
> إذا لم يظهر لك خيار Zotero في **Account settings**، فاطلب من المسؤول تفعيل [تكامل Zotero](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md).

## اربط حسابك في Zotero

تفعل ذلك مرة واحدة.

**1. افتح إعدادات حسابك**

انقر على **Account**، ثم على **Account settings**. ضمن **Reference managers**، ابحث عن **Zotero** وانقر على **Link to Zotero**.

![قسم Zotero في إعدادات الحساب مع زر Link to Zotero](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-link.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=bd8103eadfb8c79e5d2f58a83a5ac33e)

Zotero في إعدادات الحساب

تنقلك بطاقة **Zotero** في لوحة **Integrations** بالمحرر إلى المكان نفسه، في علامة التبويب نفسها.

![لوحة Integrations مع بطاقة Zotero](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-integrations.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=ee6c0da4ffd26db23956a92eebf60765)

لوحة Integrations

**2. امنح الإذن في Zotero**

تُفتح Zotero. سجّل الدخول إذا طُلب منك ذلك، ثم امنح التطبيق الإذن. لا يطلب إلا قراءة مكتبتك ومجموعاتك، لذا لا يستطيع تغيير أي شيء في Zotero.

**3. تحقق من الربط**

تعود إلى إعدادات الحساب. تظهر رسالة خضراء تقول **Reference manager linked**، ويصبح الزر **Unlink**.

![قسم Zotero في إعدادات الحساب مع رسالة خضراء وزر Unlink](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-linked.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=185a0e5c172d3a5f6a9e50a325f32cf3)

حسابك في Zotero مرتبط

إذا لم تسمح بالوصول في Zotero، يعرض القسم نفسه **Sorry, something went wrong**. انقر على **Link to Zotero** للمحاولة مرة أخرى.

## أنشئ ملفًا من مكتبتك

**1. افتح مربع الحوار Add files**

افتح مشروعًا. في شجرة الملفات، انقر على **New file**، ثم على **From Zotero**. لا يظهر هذا الخيار إلا بعد ربط حسابك.

**2. اختر اسم الملف والمكتبة**

تكون قيمة **File Name** في البداية `zotero.bib`. احتفظ بالامتداد `.bib`: فبدونه لن تحصل على معاينة، ولن يجد `\cite` ولا `\bibliography` المدخلات.

تكون قيمة **Library** في البداية **My Library**، وتعرض أيضًا مكتبات مجموعاتك. يحتوي الملف الواحد على مكتبة واحدة.

![علامة التبويب From Zotero في مربع الحوار Add files مع zotero.bib وMy Library](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-new-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=707728eb955b49101ab3977d1b19baa6)

ملف من مكتبتك الشخصية

**3. انقر على Create**

يُغلق مربع الحوار ويظهر الملف في شجرة الملفات. انقر عليه: يعرض وقت استيراده ومدخلاته. لا يمكنك تعديله في المحرر.

![الملف zotero.bib المستورد مفتوحًا في المحرر مع زر Refresh](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=b2d3560f942619fcc479ea875e7f7957)

الملف المستورد

إذا بدا أن **Create** لا يفعل شيئًا، فهناك ملف بهذا الاسم بالفعل. اختر اسمًا آخر.

### استيراد مكتبة مجموعة

كرر الخطوات نفسها باسم ملف خاص بها، واختر المجموعة ضمن **Library**. يمكن أن يحتوي المشروع على عدة ملفات من هذا النوع.

![علامة التبويب From Zotero مع اسم الملف reading-group.bib والمكتبة Reading group](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-group.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=a5cb43fdf5d97546eb1609160147aeee)

ملف من مكتبة مجموعة

## الاقتباس من الملف

**1. ابدأ اقتباسًا**

في ملف `.tex`، اكتب `\cite{`. تعرض القائمة مدخلات جميع ملفات `.bib` في المشروع. انقر على أحدها لإدراجه.

![المحرر يعرض مفاتيح الاقتباس أسفل اقتباس](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-cite.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=394bda9a2a326e5d878fc16932ec0322)

مدخلات الملفات المستوردة

**2. أو ابحث بالعنوان أو المؤلف**

انقر على **Search** أسفل القائمة، أو اضغط Ctrl+Space داخل الأقواس المعقوفة. اكتب للتصفية، وانقر على مدخل واحد أو أكثر، ثم انقر على **Insert**.

![مربع الحوار Search the .bib files in this project مع مدخل واحد محدد](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-search.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=027a2212a2b3cb83b7017014fe40ce22)

البحث عن المراجع

**3. أضف قائمة المراجع**

أضف هذه الأسطر قبل `\end{document}`، مستخدمًا أسماء ملفاتك دون `.bib`، مفصولة بفواصل:

```latex theme={null}
\bibliographystyle{plain}
\bibliography{reading-group,zotero}
```

انقر على **Recompile**. يظهر المرجع في ملف PDF.

![المحرر مع الاقتباس وقائمة المراجع، وملف PDF المجمّع مع مرجع](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-compiled.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=9c593d72f5d12495dc4ec2863dd0546d)

المرجع بعد التجميع

لا تُعرض الملفات المستوردة في **Settings** ضمن **References**، **Main bibliography file for this project**، لذا تبقى القائمة فارغة إذا لم يكن في المشروع ملف `.bib` آخر. ومع ذلك يمكنك الاقتباس منها.

![علامة التبويب References في إعدادات المشروع مع قائمة فارغة ومعطّلة](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-settings-references.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=48dad4818c2dac63afc46decea21790f)

القائمة الفارغة أمر متوقع

## حدّث الملف

لا تصل التغييرات في مكتبتك على Zotero إلى المشروع من تلقاء نفسها، ولا يجلبها التجميع.

**1. افتح الملف**

في شجرة الملفات، انقر على الملف المستورد.

**2. انقر على Refresh**

يُعاد استيراد الملف بالكامل من المكتبة التي اخترتها عند إنشائه: تظهر المدخلات الجديدة وتختفي المحذوفة. ويتغير الوقت في الأعلى.

![الملف zotero.bib بعد التحديث مع مدخل جديد ووقت استيراد جديد](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-refresh.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=aa095ac91264ef0e4517a860fb94b5c9)

الملف بعد التحديث

**3. أعد التجميع**

تظهر المدخلات الجديدة في قائمة `\cite{` فورًا. انقر على **Recompile** لتحديث ملف PDF.

يُحدَّث كل ملف على حدة: حدّث ملف مجموعتك بشكل منفصل. لمعرفة من يمكنه تحديث ملف في مشروع مشترك، راجع [ملاحظات المسؤولين](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md#notes).

## ألغِ ربط حسابك في Zotero

في **Account settings**، ضمن **Zotero**، انقر على **Unlink**، ثم انقر على **Unlink** مرة أخرى في مربع الحوار. يعود الزر إلى **Link to Zotero**.

![مربع الحوار Unlink Zotero Account](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-unlink.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=3783d8622dee66277c2420154294220e)

إلغاء ربط حسابك

تبقى الملفات التي استوردتها في مشاريعك وتظل قابلة للتجميع. يختفي **From Zotero** من مربع الحوار **Add files**، ويعرض **Refresh** خطأ حتى تربط حسابك مرة أخرى.

![ملف مستورد يعرض الخطأ Could not load references from Zotero, please re-link your account and try again](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-relink-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=d0c678b299fa6604d857398aad9bca18)

التحديث دون حساب مرتبط

بعد إعادة الربط، يعمل **Refresh** على الملفات نفسها.

## إذا حدث خطأ ما

**Could not load references from Zotero, please re-link your account and try again**، أو **There was an error accessing your Zotero data** في مربع الحوار **Add files**: لم يعد Overleaf قادرًا على قراءة مكتبتك، مثلًا لأنك ألغيت وصوله في Zotero. في **Account settings**، انقر على **Unlink**، ثم على **Link to Zotero**. وحتى ذلك الحين يفشل **Create** أيضًا مع الرسالة **The project that contains this file is not shared with you**، حتى في مشروعك الخاص.

![علامة التبويب From Zotero مع رسالتي الخطأ](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-access-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=65bee2963ce16aec585fb55945e6554d)

لم يعد Overleaf قادرًا على قراءة مكتبتك

**The remote service produced an error** عند النقر على **Refresh**: فشل الطلب إلى Zotero. يحتفظ الملف بمحتواه. انقر على **Refresh** مرة أخرى لاحقًا.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.