الأسئلة الشائعة واستكشاف الأخطاء
إجابات سريعة حول بدء الاستخدام والمشاريع والبناء والمساعدات والنسخ الاحتياطي.
البدء
قسم بعنوان “البدء”هل أحتاج إلى حساب؟
قسم بعنوان “هل أحتاج إلى حساب؟”لا. نزل Oleafly وافتحه وابدأ الكتابة. الخدمات الاختيارية، مثل مزود ذكاء اصطناعي سحابي أو GitHub أو Dropbox، تستخدم حساباتها الخاصة.
هل يدعم Oleafly لغات LaTeX وTypst وMarkdown؟
قسم بعنوان “هل يدعم Oleafly لغات LaTeX وTypst وMarkdown؟”نعم. اختر المحرك عند إنشاء المشروع. لكل محرك قدراته الخاصة في التحرير والتصدير. يرشدك دليل البدء السريع خلال خطوات الحصول على ملف PDF الأول لديك.
هل يمكنني إحضار ورقة بحثية أو سيرة ذاتية موجودة مسبقًا؟
قسم بعنوان “هل يمكنني إحضار ورقة بحثية أو سيرة ذاتية موجودة مسبقًا؟”نعم. استورد مصدر مشروع، أو أرشيف ZIP، أو مستودع Git. ويوفر Oleafly أيضًا مسارات تحويل لملفات DOCX وملفات PDF النصية. اقرأ إحضار مشروع موجود لتختار المسار المناسب.
هل يمكنني العمل دون اتصال؟
قسم بعنوان “هل يمكنني العمل دون اتصال؟”يمكنك الكتابة وتنظيم الملفات واستخدام التدقيق اللغوي المحلي وتشغيل نموذج ذكاء اصطناعي محلي منزل من دون اتصال سحابي. ويستطيع Tectonic البناء بالحزم المخبأة. أما الحزم الجديدة والمراجع البعيدة والنماذج السحابية وGitHub والتنزيلات فتتطلب اتصالًا. جهز مشروعًا بعملية بناء ناجحة قبل أن تأخذه إلى العمل دون اتصال.
أين توجد ملفاتي؟
قسم بعنوان “أين توجد ملفاتي؟”مشاريعك مجلدات عادية داخل مكتبتك المحلية. يمكنك نسخها أو الاحتفاظ بنسخة احتياطية منها أو فتحها في أداة أخرى. ويشرح مكان وجود بياناتك ملفات المشروع وإعدادات التطبيق ونقاط التحقق.
هل يمكنني استخدام Oleafly لأطروحة أو سيرة ذاتية؟
قسم بعنوان “هل يمكنني استخدام Oleafly لأطروحة أو سيرة ذاتية؟”نعم. ابدأ بسير عمل الأطروحة أو سير عمل السيرة الذاتية. يستخدم كلاهما المحرر والمعاينة والمراجع وأدوات التصدير نفسها المستخدمة في الورقة البحثية.
التثبيت
قسم بعنوان “التثبيت”يمنع نظام التشغيل المثبت
قسم بعنوان “يمنع نظام التشغيل المثبت”تحقق من أن الملف مصدره الإصدارات الرسمية (يفتح في علامة تبويب جديدة) وأنه يطابق منصتك. واتبع دليل التثبيت للاطلاع على خطوات التشغيل الأول الخاصة بمنصتك.
أي حزمة Linux ينبغي أن أستخدم؟
قسم بعنوان “أي حزمة Linux ينبغي أن أستخدم؟”اختر البنية التي تطابق حاسوبك، ثم حزمة 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 مثبّتًا.
يقول MiKTeX إن latexmk يحتاج إلى Perl
قسم بعنوان “يقول MiKTeX إن latexmk يحتاج إلى Perl”يعمل latexmk في MiKTeX على Perl، ولا يتضمنه MiKTeX. ثبّت Strawberry Perl، أو ثبّت TinyTeX من Settings → Engines → LaTeX، فهو يأتي بـPerl خاص به ويتولى عمليات البناء بدلًا من MiKTeX. انظر MiKTeX وPerl.
نص مفقود من ملف PDF لدي
قسم بعنوان “نص مفقود من ملف PDF لدي”ليس في الخط رموز لتلك الأحرف. يحدث هذا غالبًا مع النص الكوري والصيني والياباني، ويترك 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 للأسئلة والمساعدة المتعلقة بسير العمل.