# الملفات والمجلدات

لوحة Explorer: إنشاء الملفات وإعادة تسميتها ونقلها ونسخها، وحالة Git، والمستند الرئيسي، والتبويبات، وعروض الصور وPDF، وكيف يحمي الحفظ التلقائي عملك.

كل مشروع هو مجلد حقيقي من الملفات، ولوحة **Explorer** (التبويب الأول في الشريط الجانبي الأيسر) هي وسيلتك للعمل معه. المشاريع متعددة الملفات مدعومة دعمًا كاملًا: قسّم الفصول إلى ملفات `.tex` خاصة بكل منها، وأبقِ الصور في مجلد، وسيتبع Oleafly ذلك كله في التجميع والتنقل والبحث.

![شجرة ملفات LLaMA. استخدم عناصر التحكم الثلاثة بجانب عنوان اللوحة لإنشاء ملف أو إنشاء مجلد أو استيراد ملفات موجودة.](https://cdn.oleafly.com/images/screenshots/desktop/docs/project-files-dark-window-v2.png#view=0,45,344,638)

![بحث في جميع ملفات المشروع، ثم فتح إحدى النتائج عند سطرها.](https://cdn.oleafly.com/images/gifs/desktop/project-search.gif?v=2)

## لوحة Explorer

تُرتَّب المجلدات أولًا ثم الملفات بعدها أبجديًا. انقر مجلدًا لتوسيعه أو طيّه، وانقر ملفًا لفتحه في تبويب، واستخدم مفاتيح الأسهم مع Enter للتنقل الكامل بلوحة المفاتيح. يُعلَّم **المستند الرئيسي** للمشروع (الملف الذي يبدأ منه المجمّع) بنجمة.

زرّان في ترويسة اللوحة ينشئان العناصر: **New file** و**New folder**. ينشئ كلاهما داخل المجلد المحدد حاليًا، أو في جذر المشروع إذا لم يكن أي شيء محددًا. اكتب الاسم في مكانه واضغط Enter؛ وتفتح الملفات الجديدة فورًا.

أعمال التنظيف الداخلية غير مرئية: المجلدات الداخلية مثل `.git` وذاكرة البناء المؤقتة لا تظهر أبدًا في الشجرة، ولا تُتبَع الروابط الرمزية.

## حالة Git في الشجرة

عندما يستخدم المشروع Git، يعلّم Explorer الملفات المتغيرة بالحروف نفسها التي يستخدمها [Source Control](/docs/git-history/):

| الحرف | المعنى |
|---|---|
| **M** | معدَّل |
| **A** | مضاف |
| **D** | محذوف |
| **R** | معاد تسميته |
| **U** | غير متتبَّع (ملف جديد لم يبدأ Git تتبعه بعد) |
| **!** | تعارض |

يجلس الحرف في الطرف الأيمن من الصف، ويُظهر التحويم فوقه اسم الحالة. تحتفظ أسماء الملفات بلونها المعتاد. ويأخذ المجلد الذي يحوي تغييرات نقطةً بدلًا من حرف، ملونةً وفق أشد التغييرات إلحاحًا في داخله، لذا يظهر تعارض في أعماق `sections/` على صف `sections` حتى والمجلد مطوي.

## قائمة النقر بالزر الأيمن

على **ملف**:

- **Open**
- **Set as main document** (متاح لأنواع الملفات التي يجمّعها محرك المشروع، مثل `.tex` أو `.typ` أو `.md`): يجعل هذا الملف نقطة دخول التجميع وينقل النجمة.
- **Rename**: حرّر الاسم في مكانه. تتبع إعادةَ التسمية التبويباتُ المفتوحة والتعديلاتُ غير المحفوظة ومؤشرُ المستند الرئيسي، ويمكن كذلك أن تتبعها [المسارات التي تشير إلى الملف](#paths-follow-a-moved-file).
- **Make a copy**: ينشئ `name copy.tex` بجوار الأصل. يعمل بايتًا ببايت، لذا تُنسخ الصور وسائر الملفات الثنائية بأمان.
- **Delete**: يزيل الملف بعد تأكيد. لا يمكن التراجع عن هذا من داخل التطبيق، غير أن [سجل Git](/docs/git-history/) يستطيع إعادة أي شيء كنت قد أضفته في commit. وفي مجلد فتحته في مكانه، ينقل Delete الملف إلى سلة المحذوفات (Recycle Bin في Windows) بدلًا من ذلك.

وعلى **مجلد**: **New file**، و**New folder**، و**Import file(s)**، و**Import folder**، و**Rename**، و**Make a copy** (ينسخ المجلد كاملًا نسخًا تكراريًا)، و**Delete**.

## نقل العناصر: السحب والإفلات

اسحب أي ملف أو مجلد إلى مجلد آخر لنقله إلى داخله، أو إلى المنطقة الفارغة أسفل الشجرة لنقله إلى جذر المشروع. تُبرَز أهداف الإفلات أثناء التحويم فوقها. ويرفض Oleafly أي نقل يضع مجلدًا داخل نفسه.

تُنسخ الملفات والمجلدات المسحوبة من مدير الملفات لديك إلى المجلد الواقع تحت المؤشر. يعمل هذا على macOS وWindows وLinux.

## المسارات تتبع الملف المنقول

قد تكسر إعادةُ تسمية ملف أو نقله المساراتِ التي تشير إليه. يجد Oleafly تلك المسارات ويحدّثها:

- في LaTeX: الأوامر `\input` و`\include` و`\includegraphics` و`\bibliography` والأوامر المشابهة.
- في Typst: `#include` و`image()` و`bibliography()`.
- في Markdown: الروابط والصور.

يمكنك بدء ذلك من المحرر أو من Explorer. في المحرر، ضع المؤشر على مسار واضغط F2، أو اختر **Rename file…** من قائمة النقر بالزر الأيمن. يقبل حوار **Rename file** مسارًا كاملًا، فيستطيع نقل الملف إلى مجلد آخر أيضًا، وهو ينشئ المجلدات غير الموجودة بعد. وفي Explorer، استخدم **Rename** أو اسحب الملف إلى مجلد جديد.

يسأل Oleafly أولًا افتراضيًا. يعرض حوارٌ كل ملف لا يزال يستخدم المسار القديم وعدد المراجع التي يحويها. اختر **Update references** أو **Don't update**، وعلّم **Don't ask again** للاحتفاظ بذلك الجواب. ولتغييره لاحقًا، اضبط **When a file moves** في **Settings → Appearance → Editor** على **Ask** أو **Always update** أو **Never update**. الملف الذي تغيّر بعد النقل، أو تعذّر حفظه، يحتفظ بالمسار القديم، ويذكر الحوار ذلك.

## التبويبات

تظهر الملفات المفتوحة تبويباتٍ فوق المحرر، بالترتيب الذي فتحتها فيه. تعني النقطة على التبويب وجود تعديلات غير محفوظة معلّقة (ستُحفَظ تلقائيًا بعد لحظة). وتفتح [عروض الفروقات](/docs/git-history/) الخاصة بـGit تبويباتٍ في الشريط نفسه، معنونةً باسم الملف مضافًا إليه `(Index)` أو `(Working Tree)`.

إغلاق التبويب النشط يفعّل التبويب السابق. ولا يعبر تاريخ التراجع الملفاتِ أبدًا: لكل ملف تاريخه الخاص.

## كيف تُفتح أنواع الملفات المختلفة

- **ملفات LaTeX والنصوص** (`.tex` و`.sty` و`.cls` و`.bib` و`.md` وما شابهها) تفتح في المحرر مع تظليل تركيب نحوي يناسب الامتداد.
- **الصور** (`.png` و`.jpg` و`.gif` و`.webp` و`.svg` وغيرها) تفتح صورةً معروضة.
- **ملفات PDF** تفتح في عارض PDF.
- **الملفات الثنائية المعتمة** (`.zip` و`.eps` وملفات الخطوط) تعرض إشعار «Binary file. No preview available.» بدل المخاطرة بإفسادها بتحميلها نصًّا.
- **ملفات `.bib`** تُحلَّل أيضًا في الخلفية لحظة فتح المشروع، وهذا ما يشغّل [الإكمال التلقائي للاستشهادات](/docs/citations/#complete-and-navigate-references).

## الحفظ التلقائي

لا تضغط حفظًا أبدًا. تُكتب التعديلات على القرص بعد نحو 1.5 ثانية من توقفك عن الكتابة، ويذهب Oleafly أبعد من مؤقت بسيط:

- حرّر الملف A ثم انتقل إلى الملف B قبل انطلاق المؤقت، ويظل A يُحفَظ.
- إغلاق التطبيق أو إعادة تحميله يفرغ كل عمليات الحفظ المعلقة أولًا، فلا يضيع شيء بالإغلاق داخل نافذة المهلة.
- يحفظ التجميعُ الملف النشط أولًا، فيعكس PDF دائمًا ما تراه.

## إضافة ملفات موجودة

استخدم **Import file(s)** أو **Import folder** (في قائمة ترويسة اللوحة وفي قائمة النقر بالزر الأيمن) لنسخ الصور أو ملفات `.bib` أو أدلة كاملة من أي مكان على القرص إلى المشروع. الاستيراد داخل مجلد محدد يضع النسخ هناك؛ وإلا فتصل إلى جذر المشروع.

ولأن المشروع مجلد عادي أيضًا، يعمل المسار المباشر كذلك: أفلت الملفات في `~/.oleafly/projects/<project>/` بمدير الملفات لديك، ثم أعد فتح المشروع ليلتقطها Oleafly. نفّذ النسخ والمشروع مغلق (أو أعد الفتح بعده مباشرة)، لأن الحفظ التلقائي للتطبيق يكتب ما يحمله في الذاكرة.
