ملفاتك وبياناتك
اعرف ما يرافق المشروع وكيف تنسخ احتياطيًا المصدر والتاريخ وبيانات التطبيق.
مخطوطتك مجلد من ملفات المصدر العادية. يمكنك فتح تلك الملفات بمحرر آخر، أو نسخها احتياطيًا، أو إخراجها من Oleafly.
ملفات المشروع
قسم بعنوان “ملفات المشروع”تعيش مشاريع المكتبة عادة تحت ~/.oleafly/projects/. ويمكن أن يحتوي المشروع على مستند رئيسي بتنسيق LaTeX أو Typst أو Markdown، وعلى توثيق مراجع، وأشكال، ومادة بحثية.
يسجل project.json هوية المشروع وإعداداته، بما في ذلك مستنده الرئيسي ومحركه ونسخة Typst المثبتة. ويحمل مجلد .git سجل Git. ويبدأ المشروع الذي ينشئه Oleafly أو يستورده عادة بإيداع واحد لملفاته يسمى «Create project» (انظر Git وإدارة المصدر). ويحتوي المجلد .oleafly/build/ على مخرجات البناء المولدة ويمكن إعادة إنشائه بالتجميع.
يمكن لمشروع Typst أن يحتفظ بنسخ من الحزم التي يستوردها في مجلد typst-packages، فيُجمَّع دون اتصال وعلى حواسيب أخرى. ويستخدم Typst أيضًا الخطوط في مجلد fonts الخاص بالمشروع. وكلا المجلدين يرافق المشروع.
المجلد الذي تفتحه في مكانه يبقى حيث هو. ويحتفظ Oleafly ببناءات ذلك المجلد وإعداداته ونقاط حفظه ومحادثاته في مجلد بياناته الخاص، فلا يُضاف شيء إلى مجلدك.
البيانات المخزنة خارج المشروع
قسم بعنوان “البيانات المخزنة خارج المشروع”تنتمي تفضيلات التطبيق وبيانات اعتماد المزودين المشفرة وسجلات المحادثة والاستخدام والأدوات المنزّلة مثل نسخ Typst الإضافية ونقاط الحفظ المحفوظة إلى مخزن التطبيق المحلي. وكذلك الحال في نسخ المشروع التي يحتفظ بها Oleafly من قبل كل دور للمساعد أو الوكيل، والتي تتيح لك التراجع عن الملفات التي غيّرها ذلك الدور. وتعيش نسخة مكتبة Zotero التي يقرأها البحث بـ@ هناك أيضًا، لا في المشروع. ونسخ مجلد المخطوطة احتياطيًا لا ينسخ كل بيانات التطبيق تلك.
تبقى المجلدات المرتبطة في مواقعها الأصلية. ولا يتضمن أرشيف المصدر محتوياتها لمجرد أنك ربطتها.
أين توجد الملاحظات
قسم بعنوان “أين توجد الملاحظات”الملاحظات ملفات Markdown على حاسوبك. وكل ملاحظة شخصية مجلد في مجلد المشاريع، بجانب مشاريع مكتبتك. أما ملاحظة المشروع فهي ملف .md في مجلد notes بالمشروع، لذا تنتقل مع المشروع. راجع أين تُخزَّن الملاحظات لمعرفة المجلد على Windows وmacOS وLinux، وما يحويه مجلد الملاحظة.
أين يوجد TinyTeX
قسم بعنوان “أين يوجد TinyTeX”عندما تثبّت TinyTeX من Settings → Engines → LaTeX، يضعه Oleafly في ~/.oleafly/tinytex. وتستثنى Windows حين يحوي اسم مجلد المستخدم لديك حروفًا منبّرة أو غير لاتينية، مثل اسم كوري أو صيني، لأن TeX Live لا يستطيع العمل من مجلد كهذا. فيذهب TinyTeX حينئذ إلى مجلد اسمه Oleafly- متبوعًا برمز قصير داخل ProgramData، وهو عادة C:\ProgramData. ولا يلزم وصول المسؤول. وإذا لم يستطع Oleafly إعداد ذلك المجلد أيضًا، فإنه يقول ذلك. ويمكنك مواصلة التجميع بـTectonic، أو تثبيت TeX Live بنفسك في C:\texlive.
يعرض صف TinyTeX تحت Manage TeX distributions المجلد؛ مرّر المؤشر فوق المسار المموّه لقراءته. أزل TinyTeX من ذلك الصف بدلًا من حذف المجلد يدويًا.
انسخ عملك احتياطيًا
قسم بعنوان “انسخ عملك احتياطيًا”| ما تريد الحفاظ عليه | كيف تحافظ عليه |
|---|---|
| مصدر المخطوطة وأصول المشروع | انسخ مجلد المشروع أو صدّر ملف ZIP للمصدر |
| إيداعات Git | انسخ المستودع احتياطيًا أو ادفع إلى البعيد المكون لديك |
| نقاط الحفظ المحفوظة | صدّر أرشيف تاريخ مشفرًا من Versioning |
| تفضيلات التطبيق والسجلات المحلية | ضمّن مجلد بيانات Oleafly في نسخك الاحتياطي المعتاد للحاسوب |
| البيانات والمراجع المرتبطة | انسخ مجلداتها الأصلية احتياطيًا |
| مشاريع المكتبة والإعدادات، خارج هذا الحاسوب | فعّل المزامنة السحابية للاحتفاظ بنسخة في Dropbox لديك |
يستبعد ملف ZIP للمصدر ذاكرات التخزين المؤقت للبناء وGit. واستخدم مزامنة GitHub لمستودع بعيد، وأرشيفات نقاط الحفظ لتاريخ نقاط الحفظ.
الانتقال إلى حاسوب آخر
قسم بعنوان “الانتقال إلى حاسوب آخر”ثبّت Oleafly وانسخ مشروع المخطوطة أو استنسخه. وأعد ربط المجلدات المرتبطة ومزودي النماذج على ذلك الجهاز. يحمل المشروع اختيار المجمّع والبيانات الوصفية الخاصة به؛ وقد تحتاج أدوات أو حزم إضافية إلى التثبيت. ومشروع Typst الذي يثبّت نسخة غير موجودة على هذا الحاسوب يعرض تنزيلها قبل التجميع.
المسارات على الشاشة
قسم بعنوان “المسارات على الشاشة”تظهر المسارات داخل مجلدك الرئيسي بصيغة ~/… في Settings وسجل الإصدارات وتفاصيل المحرك والوكيل والمحادثة. وفي Settings، تظل مسارات الملفات والمجلدات مموهة حتى تحوم فوقها أو تصل إليها بمفتاح Tab، فلا تُظهر لقطة الشاشة مكان ملفاتك.
الوصول إلى الشبكة
قسم بعنوان “الوصول إلى الشبكة”تحدث الكتابة والتدقيق المحلي على جهازك. ويستقبل الذكاء الاصطناعي المستضاف السياق المزود إلى المزود المختار. وتستخدم الأدوات التي تقرأ الصور وملفات PDF الممسوحة ضوئيًا نموذج Ollama محليًا ما لم تختر نموذجًا مستضافًا أو Mathpix لها، وعندها يذهب الملف إلى تلك الخدمة. وتتحدث استشهادات Zotero مع تطبيق Zotero على حاسوبك، أو مع zotero.org عندما تربط حسابًا. ويجري البحث عن الاستشهادات واستيراد Zotero وأدوات alphaXiv ومزامنة GitHub وتنزيل حزم Typst وإصداراتها والتنزيلات الأخرى وفحوصات التحديث اتصالًا بخدماتها المعنية. وترسل المشاركة الحية كل مشروع مشترك إلى خادم المشاركة الذي شُرك عليه. وترسل المزامنة السحابية مشاريع مكتبتك وإعداداتك إلى Dropbox الخاص بك. ويجلب فتح Settings → Help & About أرقامًا عامة: عدد نجوم المشروع وتشعباته على GitHub وعدد الأعضاء المتصلين في مجتمع Discord. ولا تحمل الطلبات أي معلومات حساب أو مشروع أو استخدام، ويتخطى وضع عدم الاتصال طلب Discord. ويدعم كل من Tectonic وTypst التجميع عبر ذاكرة تخزين مؤقتة من خلال وضع عدم الاتصال.