الترحيل من نشر قائم

رحّل نشرًا قائمًا من Overleaf Toolkit إلى Ayakaleaf Pro.

من المهم التأكد من أخذ نسخة احتياطية متسقة قبل كل ترحيل إلى إصدار رئيسي، حتى تتمكن من التراجع إن احتجت إلى ذلك.

​

الترحيل من Overleaf Community

​

الحالة 01: من Overleaf Toolkit

إذا كنت تستخدم Overleaf Toolkit الرسمية للنسخة المجتمعية من Overleaf، فما عليك سوى إضافة ملف باسم docker-compose.override.yml بالمحتوى التالي أو ما يشبهه إلى المجلد overleaf-toolkit/config:

docker-compose.override.yml

---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version

لبدء تشغيل المثيل، نفّذ:

bin/up

هذا كل شيء! أصبحت جاهزًا. بعد ذلك، يمكنك التحقق من أن مثيل Ayakaleaf يعمل بشكل صحيح وأنك تستطيع الوصول إلى واجهة الويب. وبعد أن يعمل كل شيء، تابع خطوات الإعداد أدناه لتفعيل الميزات المتقدمة مثل:

• sandboxed-compiles.md
• authentication
• github-synchronisation.md
• zotero-integration.md

​

الحالة 02: من ملف Docker Compose

إذا كنت تستخدم ملف docker-compose.yml مستقلًا، فرحّله أولًا إلى Overleaf Toolkit. إذ تُبسّط Toolkit التثبيت المحلي والترقيات والصيانة.

اتبع docker-compose.yml-to-toolkit-migration.md لتحويل نشرك الحالي. وحافظ على إعداداتك الحالية ومسارات وحدات تخزين البيانات أثناء هذا الترحيل.

بعد أن يعمل النشر عبر Toolkit، اتبع #from-overleaf-toolkit لتبديل صورته إلى Ayakaleaf Pro. ابدأ تشغيل المثيل باستخدام bin/up، ثم تحقق من أنك تستطيع الوصول إلى واجهة الويب.

---

​

الترحيل من Overleaf Server Pro

إذا كنت تشغّل حاليًا مثيلًا مرخّصًا تجاريًا من Overleaf Server Pro وترغب في الترحيل إلى Ayakaleaf Pro، فيُرجى العلم بأن الترحيل قد يتطلب بعض العمل الإضافي لأن بعض صيغ البيانات (templates) قد لا تكون متوافقة تمامًا. ومع ذلك، يسعدنا مساعدتك. يُرجى فتح مشكلة (issue) أو التواصل معنا عبر [e-mail]، وسنساعدك على الترحيل إلى Ayakaleaf Pro مجانًا.

---

​

الترحيل من Overleaf CEP

نتلقى كثيرًا أسئلة من المستخدمين حول إمكانية الترحيل من Overleaf CEP إلى Ayakaleaf Pro. في معظم الحالات، يقدم Overleaf CEP وAyakaleaf Pro وظائف متكافئة إلى حد كبير، ويظلان متوافقين من حيث البيانات حتى الإصدار 6.2.0. وقد يطرح المشروعان الميزات في أوقات مختلفة؛ فعلى سبيل المثال، قد ننتقي (cherry-pick) ميزة من Overleaf CEP، والعكس صحيح. ورغم أن تطبيقاتنا للميزة نفسها قد تختلف قليلًا، فلا يوجد عمومًا سبب مقنع للترحيل.

إذا كنت لا تزال ترغب في الترحيل إلى Ayakaleaf Pro أو تجربته، فيُرجى الرجوع إلى: #case-01-from-overleaf-toolkit. فعملية الترحيل هي نفسها.

---

​

الترحيل من Overleaf SaaS

للأسف، قد يكون الترحيل من منصة Overleaf SaaS إلى مثيل Ayakaleaf Pro مستضاف ذاتيًا أصعب بكثير. ففي الوقت الحالي، الطريقة الوحيدة المتاحة عمومًا هي تنزيل كل مشروع كأرشيف ZIP ثم رفعه إلى مثيل Ayakaleaf Pro المستضاف ذاتيًا. ولا ينقل ذلك سوى ملفات المشروع الحالية، مما يعني أنك ستفقد:

• كامل سجل المشروع والمراجعات السابقة
• جميع التعليقات والتغييرات المتعقَّبة
• جميع بيانات Git الوصفية وسجل الإيداعات
• جميع روابط المزامنة مع GitHub وإعداداتها
• جميع الروابط بين ملفات BibTeX ومنصات إدارة المراجع الخارجية

---

​

الترحيل من نسخة متفرعة خارجية من Overleaf

قد لا يدعم Ayakaleaf Pro ميزات خاصة بنسخة متفرعة (fork) خارجية معينة من Overleaf. فبمجرد أن تبتعد نسخة متفرعة كثيرًا عن قاعدة شيفرة Overleaf الأصلية، أو تُدخل تغييرات دون الحفاظ على التوافق مع المصدر الأصلي، قد يصبح دمج إصدارات Overleaf اللاحقة صعبًا للغاية. ولا يزال بإمكانك تجربة طريقة الترحيل الموضحة أعلاه، لكن التوافق غير مضمون، وقد لا نتمكن من تقديم المساعدة أو الدعم الفني لعمليات الترحيل من النسخ المتفرعة غير المدعومة.