# الأسئلة الشائعة واستكشاف الأخطاء

إجابات سريعة حول بدء الاستخدام والمشاريع والبناء والمساعدات والنسخ الاحتياطي.

## البدء

### هل أحتاج إلى حساب؟

لا. نزل Oleafly وافتحه وابدأ الكتابة. الخدمات الاختيارية، مثل مزود ذكاء اصطناعي سحابي أو GitHub أو Dropbox، تستخدم حساباتها الخاصة.

### هل يدعم Oleafly لغات LaTeX وTypst وMarkdown؟

نعم. اختر المحرك عند إنشاء المشروع. لكل محرك قدراته الخاصة في التحرير والتصدير. يرشدك [دليل البدء السريع](/docs/getting-started/) خلال خطوات الحصول على ملف PDF الأول لديك.

### هل يمكنني إحضار ورقة بحثية أو سيرة ذاتية موجودة مسبقًا؟

نعم. استورد مصدر مشروع، أو أرشيف ZIP، أو مستودع Git. ويوفر Oleafly أيضًا مسارات تحويل لملفات DOCX وملفات PDF النصية. اقرأ [إحضار مشروع موجود](/docs/import-project/) لتختار المسار المناسب.

### هل يمكنني العمل دون اتصال؟

يمكنك الكتابة وتنظيم الملفات واستخدام التدقيق اللغوي المحلي وتشغيل نموذج ذكاء اصطناعي محلي منزل من دون اتصال سحابي. ويستطيع Tectonic البناء بالحزم المخبأة. أما الحزم الجديدة والمراجع البعيدة والنماذج السحابية وGitHub والتنزيلات فتتطلب اتصالًا. جهز مشروعًا بعملية بناء ناجحة قبل أن تأخذه إلى العمل دون اتصال.

### أين توجد ملفاتي؟

مشاريعك مجلدات عادية داخل مكتبتك المحلية. يمكنك نسخها أو الاحتفاظ بنسخة احتياطية منها أو فتحها في أداة أخرى. ويشرح [مكان وجود بياناتك](/docs/where-your-data-lives/) ملفات المشروع وإعدادات التطبيق ونقاط التحقق.

### هل يمكنني استخدام Oleafly لأطروحة أو سيرة ذاتية؟

نعم. ابدأ بسير عمل [الأطروحة](/docs/workflows/thesis/) أو سير عمل [السيرة الذاتية](/docs/workflows/resume/). يستخدم كلاهما المحرر والمعاينة والمراجع وأدوات التصدير نفسها المستخدمة في الورقة البحثية.

## التثبيت

### يمنع نظام التشغيل المثبت

تحقق من أن الملف مصدره [الإصدارات الرسمية](https://github.com/Oleafly/Oleafly/releases/latest) وأنه يطابق منصتك. واتبع [دليل التثبيت](/docs/install/#first-launch) للاطلاع على خطوات التشغيل الأول الخاصة بمنصتك.

### أي حزمة Linux ينبغي أن أستخدم؟

اختر البنية التي تطابق حاسوبك، ثم حزمة AppImage أو حزمة Debian أو حزمة RPM. انظر [تثبيت Linux](/docs/install/#linux) للاطلاع على متطلبات النظام.

## البناء

### عملية البناء الأولى لدي بطيئة

قد يحتاج Tectonic إلى تنزيل حزم يستخدمها هذا المستند، كما يجلب أول بناء على الحاسوب دفعة من الحزم الشائعة. وتخبأ هذه الحزم لعمليات البناء اللاحقة. وما دامت الحزم لا تزال تُنزَّل، قد يتجاوز البناء حده المعتاد البالغ خمس دقائق. افتح [Logs](/docs/compiling/#reading-the-logs) لترى ما يجري.

### توجد حزمة مفقودة

إذا كان Offline mode مفعلًا، فاختر **Turn off and compile** في الرسالة، أو عطّله لعملية بناء واحدة لجلب الحزمة. وعلى سلسلة أدوات TeX النظامية، استخدم **Find and install** في الخطأ. أما TeX Live القادم من Debian أو Ubuntu أو Fedora فيحصل على حزمه عبر `apt` أو `dnf`. انظر [محركات وحزم LaTeX](/docs/latex-engines/#recover-from-a-missing-file).

### اخترت pdfLaTeX ويطلب Oleafly توزيعة TeX

تعمل pdfLaTeX وXeLaTeX وLuaLaTeX وupLaTeX وpLaTeX على توزيعة TeX مثبّتة على حاسوبك. وحين لا توجد واحدة، يفتح اختيار أي منها حوارًا قبل أن يُجمَّع أي شيء. اختر **Download and use TinyTeX** لتثبيت واحدة، أو **Switch back to Tectonic** للعودة إلى المحرك المدمج. وبعد بناء فاشل، تعرض المعاينة الاختيار نفسه بالزرين **Download and use TinyTeX** و**Use Tectonic**. انظر [عندما لا يكون TeX مثبّتًا](/docs/latex-engines/#when-no-tex-is-installed).

### يقول MiKTeX إن latexmk يحتاج إلى Perl

يعمل `latexmk` في MiKTeX على Perl، ولا يتضمنه MiKTeX. ثبّت Strawberry Perl، أو ثبّت TinyTeX من **Settings → Engines → LaTeX**، فهو يأتي بـPerl خاص به ويتولى عمليات البناء بدلًا من MiKTeX. انظر [MiKTeX وPerl](/docs/latex-engines/#miktex-and-perl).

### نص مفقود من ملف PDF لدي

ليس في الخط رموز لتلك الأحرف. يحدث هذا غالبًا مع النص الكوري والصيني والياباني، ويترك TeX الأحرف دون أن يفشل البناء. ينبّهك Oleafly ويسردها في السجل. في LaTeX، الصق الإعداد الذي يعطيه التنبيه لنظام الكتابة لديك. وفي Typst، نزّل حزمة الخطوط التي تعرضها الملاحظة، أو أضف خطًا يحوي الأحرف إلى مجلد `fonts` في المشروع. وفي Markdown، اضبط `mainfont` أو `CJKmainfont` في ترويسة YAML على خط يحويها. انظر [أحرف مفقودة من ملف PDF](/docs/latex-engines/#characters-missing-from-the-pdf) و[أحرف تظهر مربعات](/docs/typst/#characters-that-show-as-boxes).

### أوقف Oleafly بنائي لأنه استغرق وقتًا طويلًا

يستطيع البناء أن يعمل 5 دقائق. وما دامت الحزم لا تزال تُنزَّل، يمتد الحد حتى 30 دقيقة. ويحصل Markdown إلى PDF على 15 دقيقة، ويحصل Quarto وCalepin على ساعة. جمّع مرة أخرى: يتابع التنزيل من حيث توقف. وللمسودات الطويلة على Tectonic، اضبط **Compile mode** على **Fast** في قائمة التجميع.

### هل يمكن للمشاريع الجديدة استخدام تثبيت TeX الخاص بي؟

نعم. افتح **Settings → Engines → LaTeX** واضبط **Default compile engine** على **latexmk (system TeX)**. وبذلك تبدأ عليه مشاريع LaTeX الجديدة والمستوردة والمحولة. انظر [تعيين محرك افتراضي للمشاريع الجديدة](/docs/engines/#set-a-default-for-new-projects).

### يستخدم مستندي الحزمة minted أو PythonTeX

تشغل هاتان الحزتان برامج أخرى أثناء بناء المستند، وهو أمر يمنعه Oleafly افتراضيًا. وتحتاجان إلى LaTeX نظامي. إذا كنت تثق بكل ملف في المشروع، فاختر **Allow external commands** في الشريط الظاهر أعلى المحرر. انظر [السماح بالأوامر الخارجية](/docs/latex-engines/#allow-external-commands).

### انتهت عملية البناء مع تحذيرات

افتح **Logs** وافحص أولًا الاستشهادات والمراجع غير المعرفة. ويساعدك [Preflight](/docs/preflight/) في العثور على المواضع المتأثرة في المصدر قبل التصدير.

### لا أفهم رسالة خطأ في البناء

اطلب من المساعد قراءة السجل وإصلاح الخطأ وإعادة البناء. واستخدم **Ask for approval** عندما تريد مراجعة الإجراءات المقترحة أثناء التنفيذ. ويمكنك أيضًا نشر السجل في منتدى المساعدة على [Discord](/discord).

### لماذا لا تظهر إحدى صيغ التصدير؟

تعتمد الصيغ المتاحة على المحرك ونوع المستند. راجع [جدول التصدير](/docs/export/#editable-formats).

## مساعدو الذكاء الاصطناعي

### أي مساعد يمكنني استخدامه؟

اربط مزود نماذج، أو استخدم نموذجًا محليًا، أو اختر [وكيل CLI](/docs/cli-agents/). ويغطي [إعداد الذكاء الاصطناعي](/docs/ai-setup/) كل مسار من هذه المسارات.

### هل أحتاج إلى الذكاء الاصطناعي لاستخدام المحرر؟

لا. الكتابة والبناء والاستشهادات المرجعية والمعاينات والمخططات وسجل المشروع والتصديرات كلها متاحة من دون مساعد.

### ما الذي يستطيع المساعد فعله؟

يستطيع العمل مع ملفات المشروع، والبحث عن المصادر، وفحص ملف PDF، وإنشاء الأشكال، وتشغيل الأدوات، والمساعدة في إصلاح عملية البناء. اختر خطة وسياسة موافقة تناسب العمل. انظر [الدردشة والأدوات](/docs/ai-chat/).

### ماذا تعني كلمة Verified التي تظهر بجوار أحد النماذج؟

اجتاز النموذج فحصًا لاستدعاء الأدوات. تساعدك هذه العلامة على اختيار نموذج لإجراءات المشروع؛ لكنها لا تقيّم جودة كتابته أو بحثه. انظر [إعداد الذكاء الاصطناعي](/docs/ai-setup/).

### لماذا يظهر الاستخدام بصيغة Unknown؟

بعض المزودين ووكلاء CLI لا يبلغون عن الاستخدام. وتعني Unknown أن القيمة غير متاحة. اقرأ [الاستخدام والميزانيات](/docs/ai-usage/).

### هل يمكنني ربط مساعد خارجي؟

نعم. استخدم [اتصال وكيل CLI](/docs/cli-agents/) مدمجًا، أو فعّل [خادم MCP](/docs/mcp/) المحلي الخاص بـ Oleafly، أو اربط وكيلك بـ[الأمر `oleafly`](/docs/cli/) الذي يعمل أيضًا والتطبيق مغلق.

## السجل والتعاون

### كيف أستعيد إصدارًا سابقًا؟

افتح [Checkpoints](/docs/checkpoints/) لمقارنة المصدر الناتج عن عمليات البناء الناجحة واستعادة أحد الإصدارات. واستخدم [Source Control](/docs/git-history/) لتنفيذات Git التي تديرها بنفسك.

### هل يمكنني العمل مع مؤلف مشارك؟

نعم. مع [التعاون المباشر](/docs/collaboration/)، تحرر أنت ومؤلفوك المشاركون المشروع نفسه في الوقت نفسه عبر خادم تعاوني يشغله فريقكم. ويحتفظ كل منكم بالمشروع بوصفه ملفات على حاسوبه الخاص. ويمكنك أيضًا مشاركة أرشيفات المصدر أو استخدام [مزامنة GitHub](/docs/github-sync/) لتبادل التنفيذات.

### هل يمكنني استخدام مشاريعي على حاسوبين؟

نعم. تحتفظ [مزامنة السحابة](/docs/cloud-sync/) بمشاريع مكتبتك وإعداداتك في Dropbox الخاص بك، ويمكن لكل حاسوب توصله تنزيلها. افتح **Settings → Data Storage → Cloud sync** لتوصيلها. ويمكنك أيضًا نقل مشروع بين حاسوبين باستخدام [مزامنة GitHub](/docs/github-sync/).

### هل يؤدي تصدير المصدر إلى نسخ كل شيء احتياطيًا؟

ينسخ احتياطيًا مصدر المشروع. أما نقاط التحقق التلقائية وتفضيلات التطبيق وبيانات الاعتماد فموجودة في أماكن منفصلة. اتبع [دليل النسخ الاحتياطي](/docs/where-your-data-lives/#back-up-your-work) لتشمل النسخة الاحتياطية ما تحتاج إليه.

## الإبلاغ عن مشكلة

افتح **Settings → Help & About → Copy Info** وأرفق تلك التفاصيل مع وصف قصير للمشكلة، والخطوات اللازمة لإعادة إنتاجها، والسجل ذي الصلة. أبلغ عنها في [Issues](https://github.com/Oleafly/Oleafly/issues)؛ واستخدم [مجتمع Discord](/discord) للأسئلة والمساعدة المتعلقة بسير العمل.
