> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ar/mqalat-mtamqh/13-getting-started-with-biblatex.md).

# البدء باستخدام BibLaTeX

**المؤلف: Josh Cassidy (يوليو 2013)**

لسنوات، كان مستخدمو LaTeX يستخدمون BibTeX إلى جانب عدة حزم إضافية مثل `natbib` لكتابة المراجع. لكن الآن يوجد خيار جديد، وهو BibLaTeX. وقد صُمِّم ليمنحك خيارات أكثر بكثير لتكوين المراجع/الاستشهادات بسهولة. ولحسن الحظ، فإن `.bib` الملفات الموجودة على الأرجح لن تحتاج إلى الكثير من التعديل لتعمل مع BibLaTeX. وإضافة إلى أكثر من 300 صفحة من [توثيق BibLaTeX](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf)، يحتوي CTAN أيضًا على [ورقة غش BibLaTeX](http://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf). ولتكملة تلك الموارد، إليك درسًا فيديويًا يتبعه بعض الملاحظات/الأمثلة لمساعدتك على البدء.

{% embed url="<https://www.youtube.com/embed/nH9If8c5VCs>" %}

### الأوامر والأنماط الأساسية

أولًا، الأوامر التي تستخدمها في ملف tex لإضافة قائمة مراجع إلى المستند تختلف كثيرًا. في المقدمة تحتاج إلى استخدام الكود التالي:

```latex
\usepackage{biblatex}
\\addbibresource{}
```

الأمر الأول يقوم فقط بتحميل `biblatex` الحزمة. أما الثاني فيُستخدم لتحديد ملفات bib التي تريد استخدامها. ما عليك سوى إدخال اسم الملف بين الأقواس المعقوفة بما في ذلك `.bib` الامتداد. ثم في متن المستند، بدلًا من استخدام `\bibliography` أمر لإنشاء قائمة المراجع، تستخدم `\printbibliography` الأمر. عند استخدام BibTeX تحدد نمط المراجع باستخدام `\bibliographystyle` الأمر. في `biblatex` لم نعد نستخدم هذا الأمر، بل نحدد خيارات النمط بتمرير مزيد من الوسائط إلى `\usepackage` الأمر. وللقيام بذلك ندخل `النمط=` يتبعها اسم النمط داخل أقواس مربعة مباشرةً قبل الأقواس المعقوفة. على سبيل المثال:

```latex
\\usepackage[style=numeric]{biblatex}
```

بدلًا من ذلك، إذا أردت تحديد نمط واحد للاقتباسات ونمطًا مختلفًا لقائمة المراجع، فتستخدم الكلمتين `citestyle` و `bibstyle`. إليك مثال:

```latex
\\usepackage[citestyle=alphabetic,bibstyle=authortitle]{biblatex}
```

قبل أن أتابع، سأعرض بسرعة كيف تبدو بعض هذه الأنماط لكلٍ من الاقتباسات ومدخل قائمة المراجع الفعلي. ومع ذلك، يمكنك [الرجوع إلى التوثيق](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf) للاطلاع على القائمة الكاملة للأنماط.

* ال `رقمي` النمط: ![BiBLaTeXnumeric.png](/files/0a06aa5ab7252bd270654625cb9b659f134f5f59)- الـ `أبجدي` النمط: ![BiBLaTeXalphabetic.png](/files/8bca19d97462005d95086df0733d86fef8d1f09c)- الـ `القراءة` النمط: ![BiBLaTeXreading.png](/files/fccb501a3729afa15384212d471b583f8aaad967)- الـ `المؤلف-السنة` النمط: ![BiBLaTeXauthoryear.png](/files/56e32c56338f748f001e5e56b28c68fd9200e354)

وسيط آخر يمكنك أن تمرره إلى `\usepackage` الأمر هو خيار الفرز. على سبيل المثال:

```latex
\\usepackage[style=authoryear,sorting=ynt]{biblatex}
```

سيستخدم هذا نمط المؤلف-السنة ثم يرتب إدخالات قائمة المراجع حسب السنة، والاسم، والعنوان. إليك قائمة ببعض خيارات الفرز المختلفة المتاحة:

* `nty`—يرتب الإدخالات حسب الاسم، والعنوان، والسنة؛
* `nyt`—يرتب الإدخالات حسب الاسم، والسنة، والعنوان؛
* `nyvt`—يرتب الإدخالات حسب الاسم، والسنة، والمجلد، والعنوان؛
* `anyt`—يرتب الإدخالات حسب الوسم الأبجدي، والاسم، والسنة، والعنوان؛
* `anyvt`—يرتب الإدخالات حسب الوسم الأبجدي، والاسم، والسنة، والمجلد، والعنوان؛
* `ynt`—يرتب الإدخالات حسب السنة، والاسم، والعنوان؛
* `ydnt`—يرتب الإدخالات حسب السنة (ترتيب تنازلي)، والاسم، والعنوان؛
* `none`—لا يوجد فرز. تظهر الإدخالات بالترتيب الذي تظهر به في النص.

إذا لم تحدد ترتيبًا فالقيمة الافتراضية هي `nty`.

### أوامر الاستشهاد

تم أيضًا تجديد أوامر الاستشهاد في `biblatex`. تتيح لك هذه الأوامر الأكثر ذكاءً خيار إضافة `ملاحظة تمهيدية` و `ملاحظة لاحقة` كوسائط:

* a `ملاحظة تمهيدية` هي كلمة أو عبارة مثل 'see' تُدرج في بداية الاستشهاد؛
* a `ملاحظة لاحقة` هو النص الذي تريد إدراجه في نهاية الاستشهاد.

لإضافة هذه الملاحظات، تستخدم مجموعتين من الأقواس المربعة في أمر الاستشهاد. إليك مثالًا:

```latex
\\cite[see][page 12]{latexcompanion}
```

في هذا المثال قمنا بالفعل بتحميل `أبجدي` النمط و `latexcompanion` هو مجرد مفتاح الاستشهاد. هذا ما سيبدو عليه الاستشهاد في النص:

![BiBLaTeXprepost.png](/files/d1292eef1c5c0986e13b9990f894047f2e230588)

إذا فتحت مجموعة واحدة فقط من الأقواس المربعة، فسيفترض أن محتوى الأقواس هو `ملاحظة لاحقة`، لذا إذا كنت تريد فقط `ملاحظة تمهيدية` تأكد من أنك ما تزال تفتح المجموعة الثانية من الأقواس المربعة ثم اتركها فارغة فقط.

هناك أيضًا عدد من أوامر الاستشهاد المختلفة المتاحة لك لاستخدامها. إليك بعض الأوامر القياسية:

* `\cite`—الأبسط بينها. يطبع من دون أي أقواس، باستثناء عند استخدام `أبجدي` أو `رقمي` النمط عندما يستخدم الأقواس المربعة؛
* `\\parencite`—يطبع الاستشهادات بين قوسين باستثناء عند استخدام `أبجدي` أو `رقمي` النمط عندما يستخدم الأقواس المربعة؛
* `\\footcite`—يضع الاستشهاد في حاشية سفلية.

### تقسيم قوائم المراجع الفرعية

من الأشياء الجميلة في `biblatex` هو أنه يمكنك تقسيم قوائم المراجع الفرعية وفقًا لنوع المصدر. إليك مثالًا على التقسيم حسب نوع المصدر:

```latex
\\printbibheading
\\printbibliography[type=book,heading=subbibliography,title={Book Sources}]
\\printbibliography[nottype=book,heading=subbibliography,title={Other Sources}]
```

في هذا المثال نقسم قائمة المراجع إلى قسمين، واحد للمصادر التي هي كتب وآخر للمصادر التي ليست كذلك. إليك مثالًا على الناتج:

![BiBLaTeXtypes.png](/files/c35f8778bf971f3ca280eefe6c49c165db03ac81)

طريقة أخرى يمكنك بها تقسيم قوائم المراجع هي استخدام عامل تصفية للكلمات المفتاحية. للقيام بذلك تحتاج إلى إضافة `الكلمات المفتاحية` حقلًا إلى الإدخالات في `.bib` . على سبيل المثال:

```latex
@article{key,
	keywords = {keywordA,keywordB,keywordC}
```

إليك مثالًا على كيفية التقسيم لاحقًا حسب الكلمة المفتاحية:

```latex
\\printbibheading
\\printbibliography[keyword=major,heading=subbibliography,title={Major Sources}]
\\printbibliography[keyword=minor,heading=subbibliography,title={Minor Sources}]
```

والناتج المقابل:

![BiBLaTeXmajor.png](/files/08107cc744e590137e5fc5d18d3696c112dbd628)

يبدو أنه ذات يوم قريب لن يكون BibTeX سوى جزء من تاريخ LaTeX! آمل أن يكون هذا قد ساعدك على البدء مع `biblatex`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ar/mqalat-mtamqh/13-getting-started-with-biblatex.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.