# الاستشهادات وقوائم المراجع

ابحث عن مصدر، وافحص بياناته الوصفية، وأضِفه إلى قائمة المراجع الصحيحة، واستشهد به عند المؤشر، واختر نمط استشهاد Typst، ونظّف مكتبة مراجع دون فقدان الأصل.

الاستشهاد سلسلة: يشير الادعاء إلى مفتاح، ويشير المفتاح إلى مدخل في قائمة المراجع، ويشير المدخل إلى مصدر حقيقي. يُبقي Oleafly هذه السلسلة مرئية حتى لا يتحوّل البحث السريع إلى مرجع غامض في وقت لاحق.

![لوحة References في Oleafly. بدّل بين References وCitations وSymbols؛ رشّح العرض الحالي من حقل البحث.](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## استشهد أثناء الكتابة

![يفتح Cite from project منتقي قائمة المراجع. ابحث بالمفتاح أو المؤلف أو العنوان؛ ويفتح Find and add a new citation البحث عبر الإنترنت.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

في شريط أدوات LaTeX أو Typst، اختر **Cite from project** (الأيقونة `@`). ابحث في قائمة المراجع الحالية بالمفتاح أو المؤلف أو العنوان وحدّد مدخلًا.

يمكنك أيضًا تشغيل **Add citation** من لوحة الأوامر ⌘K أو Ctrl+K. يُدرج Oleafly الصيغة الخاصة بالمشروع النشط:

- `\cite{key}` في LaTeX؛
- `@key` في Typst، مع إضافة سطر `#bibliography(...)` في نهاية المستند الرئيسي عندما لا يحتوي على واحد؛
- `[@key]` في Markdown، مع إضافة سطر `bibliography:` إلى بيانات front matter عند الحاجة.

مع اتصال Zotero، يعرض **Add citation** المطابقات من مكتبة Zotero لديك أولًا.

## استشهد من مكتبة Zotero الخاصة بك

بعد [اتصال Zotero](/docs/integrations/research-sources/#zotero)، اكتب `@` وجزءًا من اسم مؤلف، أو كلمة من العنوان، أو سنة، أو مفتاحًا. تظهر مكتبة Zotero لديك كاملة بجوار مراجع المشروع نفسها. اختر ورقة بحثية فيُدرج Oleafly الاستشهاد بالطريقة التي يستشهد بها المستند فعلًا. يحصل LaTeX على الأمر الأكثر استخدامًا في المستند، مثل `\citep` أو `\parencite`، ويحصل Typst على `@key`، ويحصل Markdown على `[@key]`. وكتابة `@` داخل أمر `\cite{...}` قائم تضيف مفتاحًا آخر إليه.

يدخل ذلك المدخل وحده إلى ملف `.bib` الخاص بالمشروع، في نهاية الملف، ويبقى ما تبقى من الملف كما كان. الورقة البحثية الموجودة مسبقًا في `.bib`، بمفتاحها أو بمعرّف DOI الخاص بها، لا تُضاف مرتين أبدًا. ولا تتضمن المدخلات أبدًا مسارات ملفات PDF على حاسوبك. إذا لم يكن في المشروع سطر قائمة مراجع بعد، يضيف Oleafly واحدًا: `\bibliography` أو `\addbibresource` في LaTeX، أو `#bibliography` في Typst، أو `bibliography:` في بيانات front matter لـMarkdown. وعند وجود أكثر من ملف `.bib`، يسأل Oleafly مرة واحدة عن الملف الذي ستذهب إليه المراجع الجديدة ويتذكّر إجابتك.

في المرة الأولى التي تستشهد فيها من Zotero في ورقة LaTeX تسرد مراجعها يدويًا، داخل بيئة `thebibliography`، يعرض Oleafly نقل تلك القائمة إلى `.bib`. عندها يشارك كل مرجع في قائمة مرقّمة واحدة.

### أبقِ ملف .bib متوافقًا مع Zotero

المفتاح المستشهد به والمفقود من `.bib` لكنه موجود في Zotero يوفّر خيار **Add from Zotero**. شغّل **Add missing citations from Zotero** من لوحة ⌘K لفحص كل مفتاح مستشهد به دفعة واحدة. يضيف ما يملكه Zotero، ويسرد ما لا يملكه، ويشير إلى المفاتيح التي تستشهد بورقة موجودة مسبقًا في قائمة مراجعك.

عندما تتغير ورقة بحثية في Zotero، يوفّر مدخلها في `.bib` خيار **Update from Zotero**. ويراجع **Update .bib entries from Zotero** في اللوحة كل مدخل تغيّر. المدخل الذي حرّرته يدويًا لا يُستبدل إلا بعد تأكيدك. ويقرأ **Sync Zotero library** المكتبة من جديد. لا يحذف Oleafly شيئًا من `.bib` من تلقاء نفسه أبدًا.

![لصق جزء من عنوان ورقة بحثية، وحفظ مدخل BibTeX الخاص بها في refs.bib.](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## اعثر على مرجع جديد وأضِفه

اختر **Find and add a new citation** من المنتقي. ابدأ بأي مما يلي:

- معرّف DOI مثل `10.1145/3592979`؛
- معرّف arXiv مثل `1706.03762`؛
- رقم ISBN-10 أو ISBN-13؛
- معرّف PubMed (PMID)؛
- عنوان URL يحتوي على أحد تلك المعرّفات؛
- عنوان ورقة بحثية.

تستخدم عمليات البحث في DOI وarXiv وISBN وPubMed الأدلة العامة الخاصة بها. ويعيد البحث بالعنوان مطابقات محتملة مع المؤلفين والسنة ومكان النشر لتختار بنفسك بدلًا من قبول تخمين.

راجع BibTeX المُعاد ثم اختر **Add to .bib and cite**. يقوم Oleafly بما يلي:

1. يضيف مفتاحًا خاليًا من التعارض إلى قائمة المراجع النشطة؛
2. يعيد استخدام مدخل موجود عندما يكون DOI موجودًا مسبقًا؛
3. يُدرج الاستشهاد عند المؤشر الحالي؛
4. يحدّث شجرة الملفات ولوحة References فورًا.

البيانات الوصفية قابلة للتعديل. صحّح السجل قبل أن يصبح جزءًا من المخطوطة.

عندما يعلن المستند عن أكثر من قائمة مراجع واحدة، يعرض مربع الحوار قائمة **Bibliography**. يدخل المدخل في الملف الذي تختاره، ويتذكّر Oleafly الاختيار لهذا المشروع.

## كيف يختار Oleafly قائمة المراجع

تتبع مشاريع LaTeX التعريفات الواردة في المستند الرئيسي الفعلي:

- `\addbibresource{references.bib}` من أجل `biblatex`؛
- `\bibliography{references}` لسير عمل BibTeX.

تُحلّ المسارات بامتداد الملف نفسه وبسلوك المسار النسبي نفسه الذي تتوقعه سلسلة أدوات TeX. التعريف الذي يشير إلى ملف مفقود يُبلَّغ عنه عند سطر المصدر ذاك بدلًا من الكتابة بصمت في مكان آخر.

تتبع مشاريع Typst استدعاء `#bibliography(...)`، سواء سمّى ملفًا واحدًا أو قائمة، وسواء كانت الملفات BibTeX `.bib` أو Hayagriva `.yml` و`.yaml`. يذهب الاستشهاد الجديد إلى الملف الذي يعلنه المستند. إذا كان ذلك الملف بصيغة Hayagriva، يحوّل Oleafly مدخل BibTeX قبل كتابته. وعندما يسمّي الاستدعاء أكثر من ملف واحد، اختر الهدف في قائمة **Bibliography** داخل مربع الحوار.

تتبع مشاريع Markdown حقل `bibliography:` في بيانات front matter.

عندما لا تكون هناك قائمة مراجع معلنة، يستخدم Oleafly أول ملف `.bib` في المشروع. وإن لم يوجد أي ملف، ينشئ Oleafly ملف `references.bib` ويجعله متاحًا في شجرة الملفات وفي منتقي الاستشهادات.

للمشروع ذي المكتبات المتعددة، افحص الهدف المحدد قبل إضافة سجل.

## اختر نمط استشهاد Typst

عندما يحتوي مستند Typst على استدعاء `#bibliography(...)`، يعرض أسفل عرض **Citations** في لوحة References قائمة **Citation style**. تسرد هذه القائمة الأنماط المدمجة في Typst لإصدار Typst الخاص بالمشروع، إضافة إلى أي ملفات `.csl` في المشروع. اختيار نمط يكتبه في الوسيطة `style:` الخاصة بذلك الاستدعاء. ومن دون نمط، يستخدم Typst نمط `ieee`.

بالنسبة إلى LaTeX، عيّن النمط في المصدر. يُكمل `\bibliographystyle{` أنماط BibTeX المعتادة؛ ومع `biblatex`، استخدم خيار `style=` الخاص به.

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

في لوحة References، اختر **Import reference library**. يمكنك استيراد ملف أو مكتبة Zotero الخاصة بك.

**من ملف**، اختر مكتبة مُصدَّرة:

| صيغة المصدر | الملف |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**من Zotero**، اربط حساب zotero.org لديك مرة واحدة في **Settings → Integrations → Zotero**، ثم اختر **Import Zotero library** في بطاقة Zotero. يستورد Oleafly ما يصل إلى 5000 عنصر. ويشرح [ربط مصادر البحث](/docs/integrations/research-sources/#zotero) خطوات الإعداد.

يحوّل Oleafly السجلات إلى BibTeX ويتخطى أي مرجع يكون DOI الخاص به موجودًا مسبقًا في المكتبة الهدف أو في وقت سابق من الدفعة نفسها. وينشئ مفاتيح خالية من التعارض ويضيف النتيجة في عملية كتابة واحدة. وتذكر الرسالة عدد المراجع التي أُضيفت وعدد ما كان موجودًا مسبقًا. استيراد المكتبة لا يُدرج استشهادًا عند المؤشر.

بعد الاستيراد، ابحث عن المدخلات الجديدة في منتقي الاستشهادات وتحقق من عيّنة منها مقابل الدليل الأصلي.

## نظّف مكتبة مراجع

تستطيع لوحة References معاينة التنظيف قبل تغيير الملفات.

1. افتح المشروع واختر **Clean reference library** في لوحة References.
2. حدّد ملف `.bib` عندما يحتوي المشروع على أكثر من ملف واحد.
3. اقرأ قائمة الإجراءات والفرق بين الحالتين قبل وبعد.
4. افحص كل إعادة تسمية مفتاح مقترَحة، وكل نسخة DOI مكررة تُزال، وكل تنبيه.
5. طبّق فقط بعد أن تطابق المعاينة قصدك.

يعيد المنقّي تسمية المفاتيح وفق نمط مؤلف-سنة-عنوان متسق ويحدّث الاستشهادات عبر ملفات مصدر المشروع. ولا يزيل نسخة DOI المكررة إلا عندما يحتفظ المدخل الباقي بكل حقل من المدخل المُزال. وتُعلَّم سجلات DOI المتعارضة والعناوين المتشابهة للمراجعة، ولا تُدمج بناءً على تخمين.

تُحفظ التعليقات وتعريفات سلاسل BibTeX النصية. ويتحقق التطبيق من أن المكتبة ما تزال تطابق المعاينة ويكتب نسخة احتياطية قبل تغيير الملفات. وتعرض الفروق الكبيرة أول 500 سطر في المعاينة؛ ومع ذلك تُستخدم الملفات الكاملة عند تطبيق التغييرات.

:::caution[راجع قبل التطبيق]
قد تكون طبعات مختلفة أو ترجمات أو نسختا ما قبل الطباعة والمجلة أو أوراق ذات عناوين متشابهة منفصلة عن قصد. اقرأ التنبيه وقارن المصادر الفعلية قبل دمج أي شيء يدويًا.
:::

## أكمل المراجع وتنقّل فيها

داخل أوامر الاستشهاد في LaTeX مثل `\cite{}` و`\citep{}` و`\citet{}` و`\parencite{}` و`\textcite{}`، يبحث الإكمال التلقائي في كل ملف `.bib` في المشروع. وفي Typst، يكمّل `@` المفاتيح من ملفات `.bib` وملفات Hayagriva معًا. ومع اتصال Zotero، تتضمن القائمة مكتبة Zotero لديك أيضًا.

يُحل الاستشهاد بمدخل أُضيف إلى `.bib` أثناء عدم فتح ذلك الملف، من المساعد مثلًا أو من Zotero، على الفور. لا حاجة إلى الكتابة في المستند أولًا.

- ينقلك F12 أو النقر مع مفتاح تعديل من مفتاح الاستشهاد إلى مدخله.
- يسرد ⇧F12 كل استخدام لمصدر.
- يعيد F2 تسمية مفتاح عبر ملفات المصدر وقائمة المراجع.
- يُظهر التحويم الهدف؛ وتُعلَّم المفاتيح غير المحلولة أو الغامضة قبل التجميع.

يشرح [ذكاء الكود](/docs/code-intelligence/) نموذج التنقل الكامل.

## الاستشهاد بـ Oleafly

إذا ساعد Oleafly في ورقة بحثية، فشغّل **Cite Oleafly in this paper** من لوحة الأوامر أو من أسفل عرض **Citations** في لوحة References. يضيف Oleafly مدخلًا بالمفتاح `oleafly` إلى قائمة المراجع التي يعلنها المستند، بصيغة BibTeX أو، لملف Hayagriva، بصيغة Hayagriva. وتذكر رسالة اسم الملف والصيغة الواجب استخدامها، مثل `\cite{oleafly}` أو `@oleafly`، مع زر **Undo** بجانبها. وإذا كان المدخل موجودًا مسبقًا، تحصل بدلًا من ذلك على تذكير بالمفتاح.

يُترك المشروع الذي لا يحتوي على ملف قائمة مراجع دون تغيير، ويعرض مربع حوار المدخل لتنسخه. والمدخل نفسه متاح دائمًا في [Settings → Help & About](/docs/settings/help/#cite-oleafly-in-a-paper).

## بناء قائمة المراجع وBiber

بالنسبة إلى `biblatex`، يعيد Oleafly تشغيل خطوة Biber المقابلة له عندما لا يكون المُجمِّع قد أنتج ملف `.bbl` قابلًا للاستخدام. وتظهر رسائل Biber، بما في ذلك مسار `.bib` المفقود، في سجل التجميع وفي تشخيصات المحرر.

عندما يفشل Biber نفسه، يذكر سجل التجميع السبب. فهو يسمّي مكتبة نظام مفقودة، ويقترح `\usepackage[backend=bibtex]{biblatex}` وسيلةً للبناء دون Biber. وعلى Fedora، توصي حزمة `.rpm` الخاصة بـ Oleafly بالمكتبتين اللتين يحتاجهما Biber.

إذا بقيت المراجع غير معرّفة:

1. تحقق من تعريف قائمة المراجع ومسارها.
2. افتح **Logs** واعثر على أول رسالة من Biber أو عن قائمة المراجع.
3. تأكد من أن مفتاح الاستشهاد موجود مرة واحدة بالضبط.
4. أعد التجميع بعد حفظ ملف `.bib`.

راجع [التجميع والسجلات](/docs/compiling/) و[محركات LaTeX والحزم](/docs/latex-engines/) لمعرفة خطوات الاسترداد الخاصة بكل محرك.

## أدوات مراجع مستقلة

يمكنك تجهيز المراجع دون فتح مشروع:

- يقبل [مولّد الاستشهادات](/docs/tools/citation-generator/) المعرّفات والعناوين والحقول المنظمة أو BibTeX.
- يبني [مولّد قوائم المراجع](/docs/tools/bibliography-generator/) قائمة ويتحقق منها.
- يقارن [مولّدات الاستشهادات حسب النمط](/docs/tools/citation-styles/) ثمانية أنماط.
- تتولى أدوات متخصصة [معرّفات DOI](/docs/tools/doi-to-bibtex/) و[أرقام ISBN](/docs/tools/isbn-to-bibtex/) و[معرّفات PubMed](/docs/tools/pubmed-to-bibtex/) و[arXiv](/docs/tools/arxiv-citation-generator/) و[عناوين الويب](/docs/tools/url-to-bibtex/).

يبقى التحرير اليدوي وتنسيق الاستشهادات محليين. أما البحث بالمعرّف وبالعنوان فيتطلب اتصالًا. ويحجب [الوضع دون اتصال](/docs/settings/general/#offline-mode) عمليات البحث تلك بينما يواصل إكمال قائمة المراجع الموجودة والتنقل فيها العمل.

## اعثر على الدليل ثم تحقق منه

يبحث [البحث عن الاستشهادات](/docs/tools/find-citations/) في الفهارس الأكاديمية أو يفحص المسودة المفتوحة للعثور على مقاطع قد تحتاج إلى دعم. اقرأ الورقة البحثية قبل الاستشهاد بها، وأبقِ كل ادعاء في حدود ما تثبته المنهجية والنتائج.
