تخطَّ إلى المحتوى
Oleaflyv0.4.12

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

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

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

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

قسم بعنوان “هل يدعم Oleafly لغات LaTeX وTypst وMarkdown؟”

نعم. اختر المحرك عند إنشاء المشروع. لكل محرك قدراته الخاصة في التحرير والتصدير. يرشدك دليل البدء السريع خلال خطوات الحصول على ملف PDF الأول لديك.

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

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

نعم. استورد مصدر مشروع، أو أرشيف ZIP، أو مستودع Git. ويوفر Oleafly أيضًا مسارات تحويل لملفات DOCX وملفات PDF النصية. اقرأ إحضار مشروع موجود لتختار المسار المناسب.

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

مشاريعك مجلدات عادية داخل مكتبتك المحلية. يمكنك نسخها أو الاحتفاظ بنسخة احتياطية منها أو فتحها في أداة أخرى. ويشرح مكان وجود بياناتك ملفات المشروع وإعدادات التطبيق ونقاط التحقق.

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

قسم بعنوان “هل يمكنني استخدام Oleafly لأطروحة أو سيرة ذاتية؟”

نعم. ابدأ بسير عمل الأطروحة أو سير عمل السيرة الذاتية. يستخدم كلاهما المحرر والمعاينة والمراجع وأدوات التصدير نفسها المستخدمة في الورقة البحثية.

تحقق من أن الملف مصدره الإصدارات الرسمية (يفتح في علامة تبويب جديدة) وأنه يطابق منصتك. واتبع دليل التثبيت للاطلاع على خطوات التشغيل الأول الخاصة بمنصتك.

اختر البنية التي تطابق حاسوبك، ثم حزمة AppImage أو حزمة Debian أو حزمة RPM. انظر تثبيت Linux للاطلاع على متطلبات النظام.

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

قسم بعنوان “عملية البناء الأولى لدي بطيئة”

قد يحتاج Tectonic إلى تنزيل حزم يستخدمها هذا المستند، كما يجلب أول بناء على الحاسوب دفعة من الحزم الشائعة. وتخبأ هذه الحزم لعمليات البناء اللاحقة. وما دامت الحزم لا تزال تُنزَّل، قد يتجاوز البناء حده المعتاد البالغ خمس دقائق. افتح Logs لترى ما يجري.

إذا كان Offline mode مفعلًا، فاختر Turn off and compile في الرسالة، أو عطّله لعملية بناء واحدة لجلب الحزمة. وعلى سلسلة أدوات TeX النظامية، استخدم Find and install في الخطأ. أما TeX Live القادم من Debian أو Ubuntu أو Fedora فيحصل على حزمه عبر apt أو dnf. انظر محركات وحزم LaTeX.

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

قسم بعنوان “اخترت pdfLaTeX ويطلب Oleafly توزيعة TeX”

تعمل pdfLaTeX وXeLaTeX وLuaLaTeX وupLaTeX وpLaTeX على توزيعة TeX مثبّتة على حاسوبك. وحين لا توجد واحدة، يفتح اختيار أي منها حوارًا قبل أن يُجمَّع أي شيء. اختر Download and use TinyTeX لتثبيت واحدة، أو Switch back to Tectonic للعودة إلى المحرك المدمج. وبعد بناء فاشل، تعرض المعاينة الاختيار نفسه بالزرين Download and use TinyTeX وUse Tectonic. انظر عندما لا يكون TeX مثبّتًا.

يعمل latexmk في MiKTeX على Perl، ولا يتضمنه MiKTeX. ثبّت Strawberry Perl، أو ثبّت TinyTeX من Settings → Engines → LaTeX، فهو يأتي بـPerl خاص به ويتولى عمليات البناء بدلًا من MiKTeX. انظر MiKTeX وPerl.

ليس في الخط رموز لتلك الأحرف. يحدث هذا غالبًا مع النص الكوري والصيني والياباني، ويترك TeX الأحرف دون أن يفشل البناء. ينبّهك Oleafly ويسردها في السجل. في LaTeX، الصق الإعداد الذي يعطيه التنبيه لنظام الكتابة لديك. وفي Typst، نزّل حزمة الخطوط التي تعرضها الملاحظة، أو أضف خطًا يحوي الأحرف إلى مجلد fonts في المشروع. وفي Markdown، اضبط mainfont أو CJKmainfont في ترويسة YAML على خط يحويها. انظر أحرف مفقودة من ملف PDF وأحرف تظهر مربعات.

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

قسم بعنوان “أوقف Oleafly بنائي لأنه استغرق وقتًا طويلًا”

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

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

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

نعم. افتح Settings → Engines → LaTeX واضبط Default compile engine على latexmk (system TeX). وبذلك تبدأ عليه مشاريع LaTeX الجديدة والمستوردة والمحولة. انظر تعيين محرك افتراضي للمشاريع الجديدة.

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

قسم بعنوان “يستخدم مستندي الحزمة minted أو PythonTeX”

تشغل هاتان الحزتان برامج أخرى أثناء بناء المستند، وهو أمر يمنعه Oleafly افتراضيًا. وتحتاجان إلى LaTeX نظامي. إذا كنت تثق بكل ملف في المشروع، فاختر Allow external commands في الشريط الظاهر أعلى المحرر. انظر السماح بالأوامر الخارجية.

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

قسم بعنوان “انتهت عملية البناء مع تحذيرات”

افتح Logs وافحص أولًا الاستشهادات والمراجع غير المعرفة. ويساعدك Preflight في العثور على المواضع المتأثرة في المصدر قبل التصدير.

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

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

قسم بعنوان “لماذا لا تظهر إحدى صيغ التصدير؟”

تعتمد الصيغ المتاحة على المحرك ونوع المستند. راجع جدول التصدير.

اربط مزود نماذج، أو استخدم نموذجًا محليًا، أو اختر وكيل CLI. ويغطي إعداد الذكاء الاصطناعي كل مسار من هذه المسارات.

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

قسم بعنوان “هل أحتاج إلى الذكاء الاصطناعي لاستخدام المحرر؟”

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

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

قسم بعنوان “ما الذي يستطيع المساعد فعله؟”

يستطيع العمل مع ملفات المشروع، والبحث عن المصادر، وفحص ملف PDF، وإنشاء الأشكال، وتشغيل الأدوات، والمساعدة في إصلاح عملية البناء. اختر خطة وسياسة موافقة تناسب العمل. انظر الدردشة والأدوات.

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

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

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

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

قسم بعنوان “لماذا يظهر الاستخدام بصيغة Unknown؟”

بعض المزودين ووكلاء CLI لا يبلغون عن الاستخدام. وتعني Unknown أن القيمة غير متاحة. اقرأ الاستخدام والميزانيات.

نعم. استخدم اتصال وكيل CLI مدمجًا، أو فعّل خادم MCP المحلي الخاص بـ Oleafly، أو اربط وكيلك بـالأمر oleafly الذي يعمل أيضًا والتطبيق مغلق.

افتح Checkpoints لمقارنة المصدر الناتج عن عمليات البناء الناجحة واستعادة أحد الإصدارات. واستخدم Source Control لتنفيذات Git التي تديرها بنفسك.

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

قسم بعنوان “هل يمكنني العمل مع مؤلف مشارك؟”

نعم. مع التعاون المباشر، تحرر أنت ومؤلفوك المشاركون المشروع نفسه في الوقت نفسه عبر خادم تعاوني يشغله فريقكم. ويحتفظ كل منكم بالمشروع بوصفه ملفات على حاسوبه الخاص. ويمكنك أيضًا مشاركة أرشيفات المصدر أو استخدام مزامنة GitHub لتبادل التنفيذات.

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

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

نعم. تحتفظ مزامنة السحابة بمشاريع مكتبتك وإعداداتك في Dropbox الخاص بك، ويمكن لكل حاسوب توصله تنزيلها. افتح Settings → Data Storage → Cloud sync لتوصيلها. ويمكنك أيضًا نقل مشروع بين حاسوبين باستخدام مزامنة GitHub.

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

قسم بعنوان “هل يؤدي تصدير المصدر إلى نسخ كل شيء احتياطيًا؟”

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

افتح Settings → Help & About → Copy Info وأرفق تلك التفاصيل مع وصف قصير للمشكلة، والخطوات اللازمة لإعادة إنتاجها، والسجل ذي الصلة. أبلغ عنها في Issues (يفتح في علامة تبويب جديدة)؛ واستخدم مجتمع Discord للأسئلة والمساعدة المتعلقة بسير العمل.

معاينة الصورة

تعذّر تحميل إجابات الذكاء الاصطناعي

حاول مرة أخرى، أو ابحث في الوثائق.