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

استشهد أثناء الكتابة
قسم بعنوان “استشهد أثناء الكتابة”
في شريط أدوات 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 الخاصة بك”بعد اتصال 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”المفتاح المستشهد به والمفقود من .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 من تلقاء نفسه أبدًا.

اعثر على مرجع جديد وأضِفه
قسم بعنوان “اعثر على مرجع جديد وأضِفه”اختر 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 بما يلي:
- يضيف مفتاحًا خاليًا من التعارض إلى قائمة المراجع النشطة؛
- يعيد استخدام مدخل موجود عندما يكون DOI موجودًا مسبقًا؛
- يُدرج الاستشهاد عند المؤشر الحالي؛
- يحدّث شجرة الملفات ولوحة References فورًا.
البيانات الوصفية قابلة للتعديل. صحّح السجل قبل أن يصبح جزءًا من المخطوطة.
عندما يعلن المستند عن أكثر من قائمة مراجع واحدة، يعرض مربع الحوار قائمة Bibliography. يدخل المدخل في الملف الذي تختاره، ويتذكّر Oleafly الاختيار لهذا المشروع.
كيف يختار 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”عندما يحتوي مستند 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 عنصر. ويشرح ربط مصادر البحث خطوات الإعداد.
يحوّل Oleafly السجلات إلى BibTeX ويتخطى أي مرجع يكون DOI الخاص به موجودًا مسبقًا في المكتبة الهدف أو في وقت سابق من الدفعة نفسها. وينشئ مفاتيح خالية من التعارض ويضيف النتيجة في عملية كتابة واحدة. وتذكر الرسالة عدد المراجع التي أُضيفت وعدد ما كان موجودًا مسبقًا. استيراد المكتبة لا يُدرج استشهادًا عند المؤشر.
بعد الاستيراد، ابحث عن المدخلات الجديدة في منتقي الاستشهادات وتحقق من عيّنة منها مقابل الدليل الأصلي.
نظّف مكتبة مراجع
قسم بعنوان “نظّف مكتبة مراجع”تستطيع لوحة References معاينة التنظيف قبل تغيير الملفات.
- افتح المشروع واختر Clean reference library في لوحة References.
- حدّد ملف
.bibعندما يحتوي المشروع على أكثر من ملف واحد. - اقرأ قائمة الإجراءات والفرق بين الحالتين قبل وبعد.
- افحص كل إعادة تسمية مفتاح مقترَحة، وكل نسخة DOI مكررة تُزال، وكل تنبيه.
- طبّق فقط بعد أن تطابق المعاينة قصدك.
يعيد المنقّي تسمية المفاتيح وفق نمط مؤلف-سنة-عنوان متسق ويحدّث الاستشهادات عبر ملفات مصدر المشروع. ولا يزيل نسخة DOI المكررة إلا عندما يحتفظ المدخل الباقي بكل حقل من المدخل المُزال. وتُعلَّم سجلات DOI المتعارضة والعناوين المتشابهة للمراجعة، ولا تُدمج بناءً على تخمين.
تُحفظ التعليقات وتعريفات سلاسل BibTeX النصية. ويتحقق التطبيق من أن المكتبة ما تزال تطابق المعاينة ويكتب نسخة احتياطية قبل تغيير الملفات. وتعرض الفروق الكبيرة أول 500 سطر في المعاينة؛ ومع ذلك تُستخدم الملفات الكاملة عند تطبيق التغييرات.
أكمل المراجع وتنقّل فيها
قسم بعنوان “أكمل المراجع وتنقّل فيها”داخل أوامر الاستشهاد في LaTeX مثل \cite{} و\citep{} و\citet{} و\parencite{} و\textcite{}، يبحث الإكمال التلقائي في كل ملف .bib في المشروع. وفي Typst، يكمّل @ المفاتيح من ملفات .bib وملفات Hayagriva معًا. ومع اتصال Zotero، تتضمن القائمة مكتبة Zotero لديك أيضًا.
يُحل الاستشهاد بمدخل أُضيف إلى .bib أثناء عدم فتح ذلك الملف، من المساعد مثلًا أو من Zotero، على الفور. لا حاجة إلى الكتابة في المستند أولًا.
- ينقلك F12 أو النقر مع مفتاح تعديل من مفتاح الاستشهاد إلى مدخله.
- يسرد ⇧F12 كل استخدام لمصدر.
- يعيد F2 تسمية مفتاح عبر ملفات المصدر وقائمة المراجع.
- يُظهر التحويم الهدف؛ وتُعلَّم المفاتيح غير المحلولة أو الغامضة قبل التجميع.
يشرح ذكاء الكود نموذج التنقل الكامل.
الاستشهاد بـ Oleafly
قسم بعنوان “الاستشهاد بـ Oleafly”إذا ساعد Oleafly في ورقة بحثية، فشغّل Cite Oleafly in this paper من لوحة الأوامر أو من أسفل عرض Citations في لوحة References. يضيف Oleafly مدخلًا بالمفتاح oleafly إلى قائمة المراجع التي يعلنها المستند، بصيغة BibTeX أو، لملف Hayagriva، بصيغة Hayagriva. وتذكر رسالة اسم الملف والصيغة الواجب استخدامها، مثل \cite{oleafly} أو @oleafly، مع زر Undo بجانبها. وإذا كان المدخل موجودًا مسبقًا، تحصل بدلًا من ذلك على تذكير بالمفتاح.
يُترك المشروع الذي لا يحتوي على ملف قائمة مراجع دون تغيير، ويعرض مربع حوار المدخل لتنسخه. والمدخل نفسه متاح دائمًا في Settings → Help & About.
بناء قائمة المراجع وBiber
قسم بعنوان “بناء قائمة المراجع وBiber”بالنسبة إلى biblatex، يعيد Oleafly تشغيل خطوة Biber المقابلة له عندما لا يكون المُجمِّع قد أنتج ملف .bbl قابلًا للاستخدام. وتظهر رسائل Biber، بما في ذلك مسار .bib المفقود، في سجل التجميع وفي تشخيصات المحرر.
عندما يفشل Biber نفسه، يذكر سجل التجميع السبب. فهو يسمّي مكتبة نظام مفقودة، ويقترح \usepackage[backend=bibtex]{biblatex} وسيلةً للبناء دون Biber. وعلى Fedora، توصي حزمة .rpm الخاصة بـ Oleafly بالمكتبتين اللتين يحتاجهما Biber.
إذا بقيت المراجع غير معرّفة:
- تحقق من تعريف قائمة المراجع ومسارها.
- افتح Logs واعثر على أول رسالة من Biber أو عن قائمة المراجع.
- تأكد من أن مفتاح الاستشهاد موجود مرة واحدة بالضبط.
- أعد التجميع بعد حفظ ملف
.bib.
راجع التجميع والسجلات ومحركات LaTeX والحزم لمعرفة خطوات الاسترداد الخاصة بكل محرك.
أدوات مراجع مستقلة
قسم بعنوان “أدوات مراجع مستقلة”يمكنك تجهيز المراجع دون فتح مشروع:
- يقبل مولّد الاستشهادات المعرّفات والعناوين والحقول المنظمة أو BibTeX.
- يبني مولّد قوائم المراجع قائمة ويتحقق منها.
- يقارن مولّدات الاستشهادات حسب النمط ثمانية أنماط.
- تتولى أدوات متخصصة معرّفات DOI وأرقام ISBN ومعرّفات PubMed وarXiv وعناوين الويب.
يبقى التحرير اليدوي وتنسيق الاستشهادات محليين. أما البحث بالمعرّف وبالعنوان فيتطلب اتصالًا. ويحجب الوضع دون اتصال عمليات البحث تلك بينما يواصل إكمال قائمة المراجع الموجودة والتنقل فيها العمل.
اعثر على الدليل ثم تحقق منه
قسم بعنوان “اعثر على الدليل ثم تحقق منه”يبحث البحث عن الاستشهادات في الفهارس الأكاديمية أو يفحص المسودة المفتوحة للعثور على مقاطع قد تحتاج إلى دعم. اقرأ الورقة البحثية قبل الاستشهاد بها، وأبقِ كل ادعاء في حدود ما تثبته المنهجية والنتائج.