> 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/qaadh-almarfh/077-how-to-search-in-an-overleaf-project.md).

# كيفية البحث داخل مشروع Overleaf

تشرح هذه المقالة طريقتين للبحث عن النص داخل مشروع Overleaf الخاص بك.

* [**البحث والاستبدال داخل الملف الحالي**](#search-and-replace-within-the-current-file) يتيح لك العثور على النص واستبداله داخل ملف قابل للتحرير مفتوح حاليًا في المحرر.
* [**البحث على مستوى المشروع**](#project-wide-search) يتيح لك البحث عبر جميع الملفات النصية في مشروعك.

## البحث والاستبدال داخل الملف الحالي

تتيح لك هذه الميزة العثور على النص واستبداله داخل ملف قابل للتحرير معروض في المحرر. هذه الميزة غير متاحة للملفات ذات القراءة فقط مثل:

* الملفات النصية [التي تم تحميلها من عنوان URL خارجي](/latex/ar/qaadh-almarfh/081-how-to-upload-a-file-using-an-external-url.md)، بما في ذلك الملفات المخزنة على Google Drive، و `.bib` الملفات (مكتبات المراجع) المستوردة من [Papers](/latex/ar/qaadh-almarfh/071-how-to-link-papers-to-your-overleaf-account.md), [Mendeley](/latex/ar/qaadh-almarfh/070-how-to-link-mendeley-to-your-overleaf-account.md)، أو [Zotero](/latex/ar/qaadh-almarfh/073-how-to-link-zotero-to-your-overleaf-account.md)
* الملفات النصية التي يتجاوز حجمها 2 ميجابايت لأن المحرر يتعامل معها على أنها للقراءة فقط

### كيفية الوصول إلى البحث والاستبدال

استخدم أيًّا من الطريقتين التاليتين للوصول إلى هذه الميزة:

1. اختصارات لوحة المفاتيح:

* ويندوز/لينكس: Ctrl+f
* ماك أو إس: Cmd+f

3. حدّد **تبديل البحث** الأيقونة الموجودة أعلى المحرر:

![صورة توضح موقع البحث في الملف](/files/00d3a99f20b4068133a9308d0265786320731d13)

تعرض أيٌّ من الطريقتين لوحة بحث موجودة في أسفل المحرر.

![صورة توضح موقع لوحة البحث في الملف](/files/6973a5fdb4fe2c46b699722fe0dcd967b798c979)

توفر لوحة البحث عناصر التحكم التالية.

![صورة توضح عناصر التحكم المتوفرة في لوحة البحث في الملف](/files/5806eeaf7f540a319bb002a768bcf3e2bab432dc)

### كيفية استخدام البحث أو البحث والاستبدال

1. يمكنك تكوين بحثك باختيار خيار واحد أو أكثر من الخيارات التالية، أو المتابعة إلى البحث دون اختيار أيٍّ منها.

* ![Icon for case sensitive search](/files/82e55926e6bd0016badde74cf36ec62765b56677): استخدام بحث يراعي حالة الأحرف
* ![Icon for searching using regular expressions](/files/cea6cdc061b63c32a1dc542df5101f216c263509): استخدام التعابير النمطية
* ![Icon for whole word search](/files/3c2d28564a916106b74d1240ef8c0f2faafc48c9): البحث عن الكلمات الكاملة فقط
* ![Icon for searching within selected text](/files/c5cbf7b907b85703670b67f723f4b7398a72aa85): البحث فقط ضمن النص المظلل في المحرر

3. بعد اختيار خيارات البحث، اكتب عبارة البحث في المربع المسمى **بحث عن**. سيبدأ Overleaf بالبحث أثناء الكتابة وسيُبرز أول نتيجة ناجحة.
4. استخدم زري التالي والسابق للعثور على أي نتائج بحث إضافية.

![صورة توضح عنصر التحكم في نتيجة البحث السابقة والتالية](/files/3cd2f8d4c86d03eeb309fea7cd62ed0100c1e759)

6. لاستبدال نص نتائج البحث، أدخل نص الاستبدال في **استبدال بـ** واستخدم إحدى الطرق التالية:

* *الاستبدال اليدوي*: حدِّد **استبدال** لتحديث تطابق واحد وجعل Overleaf يُبرز التطابق التالي. واصل التنقل بين النتائج باستخدام زري السابق/التالي وانقر على **استبدال** لتحديث تطابقات إضافية.
* *الاستبدال التلقائي*: حدِّد **استبدال الكل** لاستبدال جميع التطابقات دفعة واحدة.

8. **ملاحظة**: يؤدي تحديد زر البحث (![A button to access project-wide search](/files/7ec802271a43e3d4153da0acbe4a96f0055f5d72)) إلى التبديل إلى البحث على مستوى المشروع.

## البحث على مستوى المشروع

تتيح لك هذه الميزة البحث عن النص عبر جميع الملفات في مشروعك، شريطة أن يكون حجمها أقل من 2 ميجابايت. تُستبعد الملفات الأكبر من 2 ميجابايت من نتائج البحث (انظر [فيديو](#video-demonstrating-project-wide-search) للاطلاع على مثال على ذلك).

### كيفية الوصول إلى البحث على مستوى المشروع

استخدم أيًّا من الطرق التالية للوصول إلى هذه الميزة:

1. اختصارات لوحة المفاتيح:

* ويندوز/لينكس: Ctrl+Shift+f
* ماك أو إس: Cmd+Shift+f

3. حدّد **مربع البحث** الأيقونة الموجودة أعلى شجرة الملفات:

![صورة توضح موقع أيقونة البحث على مستوى المشروع](/files/495be4605af6c8bddf41e1483047d36a37e2ac55)

5. حدِّد زر البحث (![A button to access project-wide search](/files/7ec802271a43e3d4153da0acbe4a96f0055f5d72)) الموجود في [لوحة البحث](#how-to-access-search-and-replace).

تعرض كل طريقة من هذه الطرق مربع بحث يُخفي شجرة الملفات مؤقتًا.

![صورة توضح مربع البحث على مستوى المشروع](/files/a08f052916e61db38175ad5c5ab00c8ae0a4c39f)

### كيفية استخدام البحث على مستوى المشروع

1. يمكنك تكوين بحثك باختيار خيار واحد أو أكثر من الخيارات التالية، أو المتابعة إلى البحث دون اختيار أيٍّ منها.

![صورة توضح عناصر التحكم لتكوين البحث على مستوى المشروع](/files/fad4c52acb79dc29e9ffb8c213c8134c1482d40b)

* ![Icon for case sensitive search](/files/82e55926e6bd0016badde74cf36ec62765b56677): استخدام بحث يراعي حالة الأحرف
* ![Icon for searching using regular expressions](/files/cea6cdc061b63c32a1dc542df5101f216c263509): استخدام التعابير النمطية
* ![Icon for whole word search](/files/3c2d28564a916106b74d1240ef8c0f2faafc48c9): البحث عن الكلمات الكاملة فقط

4. اكتب عبارة البحث في المربع المخصص وحدِّد أيقونة البحث (![Image showing project-wide search icon](/files/27d5313dc64da6285034d6f119dc553532aca3a3))، أو اضغط Enter.
5. تُسرد أي نتائج بحث وتُجمَّع حسب الملف.
6. حدِّد إحدى نتائج البحث للانتقال إلى موقع الملف المقابل.

### فيديو يوضح البحث على مستوى المشروع

يوضح الفيديو التالي البحث على مستوى المشروع باستخدام مشروع Overleaf [Typeset، توثيق الشيفرة المصدرية لـ TeX أو e-TeX أو pdfTeX](https://www.overleaf.com/latex/examples/typeset-the-source-code-documentation-for-tex-e-tex-or-pdftex/qkgfgyspnhcv). تم اختيار هذا المشروع لأنه يحتوي على ملفات كبيرة `.tex` بما في ذلك `pdftex.tex`، وهو يتجاوز حد الحجم البالغ 2 ميجابايت ويُستبعد من نتائج البحث.

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/21dsGfzi4yynX5beA2eBz3/4bd76333ece5ae522e09bb9745b8d6ca/NewSearch.mp4>" %}


---

# 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/qaadh-almarfh/077-how-to-search-in-an-overleaf-project.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.
