أسئلة أساسية
س01: هل Ayakaleaf Pro نسخة تجريبية مجانية؟ هل يتطلب ترخيصًا؟
س01: هل Ayakaleaf Pro نسخة تجريبية مجانية؟ هل يتطلب ترخيصًا؟
س02: هل يتضمن Ayakaleaf Pro جميع ميزات Overleaf Server Pro؟
س02: هل يتضمن Ayakaleaf Pro جميع ميزات Overleaf Server Pro؟
س03: كم تبلغ تكلفة Overleaf Server Pro؟
س03: كم تبلغ تكلفة Overleaf Server Pro؟
س04: لماذا لا يتضمن Overleaf Server Pro ميزة GitHub Sync أو ميزات الذكاء الاصطناعي؟
س04: لماذا لا يتضمن Overleaf Server Pro ميزة GitHub Sync أو ميزات الذكاء الاصطناعي؟
س05: هل Ayakaleaf Pro آمن وموثوق؟
س05: هل Ayakaleaf Pro آمن وموثوق؟
س06: هل ستتم صيانة Ayakaleaf Pro على المدى الطويل؟
س06: هل ستتم صيانة Ayakaleaf Pro على المدى الطويل؟
س07: هل Ayakaleaf Pro متوافق مع الأنظمة والتراخيص؟
س07: هل Ayakaleaf Pro متوافق مع الأنظمة والتراخيص؟
س08: لماذا يُسمّى المشروع Ayakaleaf Pro؟
س08: لماذا يُسمّى المشروع Ayakaleaf Pro؟
س09: ما الذي يميّز Ayakaleaf Pro عن محررات LaTeX الأحدث المبنية بالذكاء الاصطناعي؟
س09: ما الذي يميّز Ayakaleaf Pro عن محررات LaTeX الأحدث المبنية بالذكاء الاصطناعي؟
س10: ماذا حدث لمستودع GitHub ayaka-notes/overleaf-pro؟
س10: ماذا حدث لمستودع GitHub ayaka-notes/overleaf-pro؟
ayaka-notes/overleaf-pro القديمة ومستودعات Git البعيدة (remotes) إلى الاسم الجديد. وتحتفظ صورة Docker باسمها، ghcr.io/ayaka-notes/overleaf-pro، لذا لا تحتاج إلى تغيير config/overleaf.rc أو config/version.الميزات
س01: ما الميزات التي يقدّمها Ayakaleaf Pro؟ هل يمكنني طلب ميزة جديدة؟
س01: ما الميزات التي يقدّمها Ayakaleaf Pro؟ هل يمكنني طلب ميزة جديدة؟
س02: لقد طوّرت بعض الميزات. هل يمكنني إرسال طلب سحب (PR)، وهل قبوله مضمون؟
س02: لقد طوّرت بعض الميزات. هل يمكنني إرسال طلب سحب (PR)، وهل قبوله مضمون؟
س03: كيف أكوّن ميزة معيّنة؟
س03: كيف أكوّن ميزة معيّنة؟
س04: ما مكتبات Python التي يمكن لـ Python Runner استخدامها؟
س04: ما مكتبات Python التي يمكن لـ Python Runner استخدامها؟
pip والحزم الأخرى فغير متاحة. لا يوجد ما يلزم تكوينه على الخادم.س05: هل يمكن للتدقيق الإملائي التحقق من اللغة اليابانية أو الصينية؟
س05: هل يمكن للتدقيق الإملائي التحقق من اللغة اليابانية أو الصينية؟
س06: هل يمكنني إضافة إضافات (plugins)؟
س06: هل يمكنني إضافة إضافات (plugins)؟
services/web/modules من الشيفرة المصدرية، مبنية ضمن صورة Docker وتُفعَّل بالإعدادات الواردة في هذه الوثائق. لإضافة ميزاتك الخاصة، أضف وحدة إلى الشيفرة المصدرية وابنِ صورتك الخاصة.النشر
س01: هل يدعم Ayakaleaf Pro النشر الموزّع في k8s؟
س01: هل يدعم Ayakaleaf Pro النشر الموزّع في k8s؟
س02: كيف يمكنني ضمان التوفّر عند خدمة آلاف المستخدمين؟
س02: كيف يمكنني ضمان التوفّر عند خدمة آلاف المستخدمين؟
س03: هل يمكنكم مساعدتي في النشر أو الترحيل؟
س03: هل يمكنكم مساعدتي في النشر أو الترحيل؟
س04: هل يمكنني استضافة Ayakaleaf Pro تحت مسار فرعي في عنوان URL، مثل https://example.com/overleaf؟
س04: هل يمكنني استضافة Ayakaleaf Pro تحت مسار فرعي في عنوان URL، مثل https://example.com/overleaf؟
https://overleaf.example.com.س05: هل يمكنني تشغيل Ayakaleaf Pro على Windows أو macOS، أو بدون Toolkit؟
س05: هل يمكنني تشغيل Ayakaleaf Pro على Windows أو macOS، أو بدون Toolkit؟
docker-compose.yml مستقلًا. لرؤية إعدادات Compose التي يستخدمها Toolkit، شغّل bin/docker-compose config في مجلد Toolkit.س06: كيف ألغي تثبيت Ayakaleaf Pro؟
س06: كيف ألغي تثبيت Ayakaleaf Pro؟
- أوقف الحاويات واحذفها باستخدام
bin/docker-compose down. - احذف البيانات. توجد افتراضيًا في المجلد
data/الخاص بـ Toolkit. إذا غيّرتOVERLEAF_DATA_PATHأوMONGO_DATA_PATHأوREDIS_DATA_PATHأوGIT_BRIDGE_DATA_PATHفيconfig/overleaf.rc، فاحذف تلك المجلدات أيضًا. لا يمكن التراجع عن ذلك، لذا خذ نسخة احتياطية أولًا إذا كنت قد تحتاج إلى البيانات. - احذف مجلد Toolkit.
- احذف صور Docker، التي يمكنك سردها باستخدام
docker images:ghcr.io/ayaka-notes/overleaf-proوصورة git-bridge وmongoوredisوصور TeX Live.
س07: كيف أوقف Ayakaleaf Pro أو أشغّله أو أعيد تشغيله؟
س07: كيف أوقف Ayakaleaf Pro أو أشغّله أو أعيد تشغيله؟
bin/stopيوقف جميع الحاويات، وbin/startيشغّلها مجددًا. يُحتفظ بالحاويات، لذا يبقى المستخدمون مسجّلي الدخول.bin/up -dينشئ الحاويات ويشغّلها في الخلفية. شغّله بعد تغييرconfig/variables.envأوconfig/overleaf.rcأوconfig/version: إذ يعيد إنشاء الحاويات التي تغيّرت إعداداتها، وعندها فقط تسري التغييرات. لا يطبّقهاbin/stopوbin/start.bin/docker-compose restart sharelatexيعيد تشغيل حاوية Overleaf فقط، دون تطبيق تغييرات الإعدادات.
bin/up إنشاء الحاوية، فاضبط OVERLEAF_SESSION_SECRET، راجع قسم الأسئلة والأجوبة في متغيرات البيئة.س08: أين أضع عنوان URL لاستدعاء OAuth (callback)؟
س08: أين أضع عنوان URL لاستدعاء OAuth (callback)؟
config/variables.env لأي من هذه التكاملات: يبني Ayakaleaf Pro كل عنوان URL للاستدعاء من OVERLEAF_SITE_URL ويرسله إلى المزوّد، الذي يرفضه ما لم يطابق العنوان المسجّل للتطبيق. لذا ما عليك سوى تسجيله لدى المزوّد، وضبط OVERLEAF_SITE_URL على العنوان الذي يفتحه المستخدمون.OVERLEAF_SITE_URL، على سبيل المثال إلى نطاق جديد، فحدّث عنوان URL لدى كل مزوّد أيضًا، وإلا فسيفشل الربط.س09: أين تُخزَّن البيانات، وما مقدار مساحة القرص التي أحتاجها؟
س09: أين تُخزَّن البيانات، وما مقدار مساحة القرص التي أحتاجها؟
data/ الخاص بـ Toolkit: data/overleaf (ملفات المشاريع وسجلها ومخرجات الترجمة)، و data/mongo و data/redis. وللمثيلات التي تضم أقل من 1000 مستخدم، نوصي بالقرص المحلي مع نسخ احتياطية منتظمة.تشغل صورة Ayakaleaf Pro نحو 5 GB. أما الحد الأدنى البالغ 40 GB المذكور في المقدمة فهو مخصص لـ Sandboxed Compiles، التي تشغل كل صورة من صور texlive-full الخاصة بها نحو 28 GB. ودون Sandboxed Compiles، تعمل عمليات الترجمة داخل حاوية sharelatex باستخدام مخطط TeX Live الأساسي (basic scheme) بالإضافة إلى latexmk و texcount و synctex و etoolbox و xetex، لذا تفشل مشاريع كثيرة بسبب حزم مفقودة. ثم يكبر مجلد data/ مع مشاريعك وسجلها؛ تحقّق منه باستخدام du -sh data/*.س10: هل يمكنني إبقاء Ayakaleaf قيد التشغيل على Windows على مدار 24 ساعة يوميًا؟
س10: هل يمكنني إبقاء Ayakaleaf قيد التشغيل على Windows على مدار 24 ساعة يوميًا؟
restart: always الخاصة بـ Toolkit، وعطّل السكون (sleep) والإسبات (hibernation) التلقائيين عند التوصيل بالتيار الكهربائي. يمكن أن تنطفئ الشاشة؛ أما سلوك إغلاق غطاء الحاسوب المحمول فهو إعداد منفصل. لا يؤدي إغلاق طرفية Ubuntu بعد bin/up -d إلى إيقاف الحاويات المنفصلة (detached). أما الخروج من Docker Desktop، أو إيقاف محركه مؤقتًا، أو تشغيل wsl --shutdown فيقطع الخدمة.يختلف Resource Saver في Docker Desktop عن سكون Windows: فهو يُطبَّق عندما لا تكون هناك حاويات قيد التشغيل، لذا لا تُعدّ حزمة Ayakaleaf العاملة خاملة لمجرد أن أحدًا لا يحرّر. وبعد إعادة تشغيل Windows، يظل إعداد بدء التشغيل عند تسجيل الدخول يتطلب أن يسجّل أحدهم الدخول. اتبع إبقاء النسخة متاحة لعمليات التحقق وخطوات الاستعادة. يبقى Linux توصيتنا عندما يجب ألا يعتمد التوافر على تسجيل دخول تفاعلي إلى سطح المكتب.س11: يقول Docker Desktop إن المحاكاة الافتراضية معطّلة. هل أحتاج إلى Hyper-V؟
س11: يقول Docker Desktop إن المحاكاة الافتراضية معطّلة. هل أحتاج إلى Hyper-V؟
wsl --list --verbose في PowerShell. قد تعني أخطاء مثل 0x80370102 أن المحاكاة الافتراضية، أو ميزة Windows، أو برنامج hypervisor عند الإقلاع معطّل. راجع خطوات استكشاف أخطاء تثبيت Windows وإصلاحها، مع روابط الإصلاح من Microsoft وDocker. أعد تشغيل Windows بعد تفعيل الميزات المطلوبة؛ إذ لا يمكن لإعادة تثبيت Ayakaleaf إصلاح محرك Docker لا يبدأ.LaTeX
س01: هل عمليات ترجمة مشاريع LaTeX الخاصة بالمستخدمين معزولة؟ هل Shell Escape مفعّل؟
س01: هل عمليات ترجمة مشاريع LaTeX الخاصة بالمستخدمين معزولة؟ هل Shell Escape مفعّل؟
س02: هل صورة Sandbox Compiles موثوقة؟ هل يمكن أن تفشل الترجمة؟
س02: هل صورة Sandbox Compiles موثوقة؟ هل يمكن أن تفشل الترجمة؟
س03: لا يُترجم مشروعي. هل يمكنكم مساعدتي في تشخيص المشكلة؟
س03: لا يُترجم مشروعي. هل يمكنكم مساعدتي في تشخيص المشكلة؟

