الانتقال إلى المحتوى الرئيسي
جمعنا هنا إجابات عن بعض الأسئلة الشائعة حول Ayakaleaf Pro.

أسئلة أساسية

لا. Ayakaleaf Pro مجاني تمامًا للاستخدام. ليس نسخة تجريبية ولا يتطلب أي ترخيص.
نعم. يتضمن Ayakaleaf Pro جميع ميزات Overleaf Server Pro، بما في ذلك تكامل Git-Bridge. كما يتضمن ميزات مختارة من منصة Overleaf SaaS. ونواصل تطوير Ayakaleaf Pro وتحسينه.
تبلغ تكلفة Overleaf Server Pro نحو $300 لكل مستخدم سنويًا. ويتطلب 10 تراخيص على الأقل، لذا تبدأ تكلفة النشر من نحو $3,000 سنويًا. وتُظهر العقود العامة الأصغر في الولايات المتحدة تكاليف سنوية تبلغ نحو $320–$370 لكل مستخدم. وهذا يجعل Server Pro مكلفًا، خاصةً للفرق الصغيرة. راجع #information-and-price-about-overleaf-server-pro للاطلاع على عمليات الشراء والأسعار الموثّقة.
يُستخدم Overleaf Server Pro عادةً من قبل المؤسسات الحكومية. فهي تنشره على شبكات خاصة وتتحكم في الوصول إليه بصرامة. ولحماية البيانات الحساسة، تتجنب ميزاته المضمّنة تبادل البيانات مع خدمات الجهات الخارجية. إذا كنت بحاجة إلى GitHub Sync أو الذكاء الاصطناعي أو ميزات متصلة مشابهة، فإن Overleaf توصي بالاشتراك في منصتها SaaS.
Ayakaleaf Pro مفتوح المصدر. نراجع الشيفرة باستخدام أدوات مثل Codex Security لتعزيز أمانه وموثوقيته. إذا لم تفعّل مزامنة البيانات مع جهات خارجية، فستبقى بياناتك على خادمك. لا يحتوي Ayakaleaf Pro على أي قياس عن بُعد (telemetry) يرسل بياناتك إلى أي مكان آخر.
سنبذل قصارى جهدنا لصيانة هذا المشروع على المدى الطويل.
Ayakaleaf Pro هو تفرّع (fork) مجتمعي. تأتي شيفرته وميزاته المدمجة من مساهمات المجتمع. وهو مرخّص بموجب AGPL v3. ويمكن لعمليات النشر الامتثال لهذا الترخيص عندما تستوفي متطلباته.
كان اسم المشروع في الأصل Overleaf Pro في عام 2024. توقف التطوير لفترة، ثم استؤنف في أواخر عام 2025. وفي الربع الأول من عام 2026، أعادت Overleaf تسمية خطة اشتراكها المدعومة بالذكاء الاصطناعي إلى Pro. كما أشارت ملاحظات المجتمع إلى أن اسم Overleaf Pro قد ينطوي على مخاطر تتعلق بالعلامات التجارية وانتحال الصفة، وقد يجعل المستخدمين يظنون أن المشروع رسمي.أعدنا تسمية المشروع إلى Ayakaleaf Pro لتجنب هذا الالتباس. ويمكن قراءة الاسم على أنه “Ayaka-notes Overleaf Pro”. ويساهم المشرف على المشروع (يمكنك مناداتي ayaka!) في تطوير مجتمع Overleaf منذ سنوات دراسته، أي منذ أكثر من خمس سنوات. وتدعم هذه الخبرة التزامنا بالصيانة طويلة الأمد.
منذ عام 2026، أصدر مجتمع المصادر المفتوحة العديد من محررات LaTeX المبنية بالذكاء الاصطناعي، بما فيها OpenAI Prism. يحتفظ Ayakaleaf Pro ببياناتك وخدماتك على خادمك الخاص، مما يمنحك تحكمًا مباشرًا في عملية النشر وفي بياناتك.لا تملك العديد من المحررات المجتمعية التجريبية خطة صيانة طويلة الأمد راسخة. كما قد تتوقف منصات ترجمة LaTeX التابعة لجهات خارجية عن العمل عندما تكون قاعدة مستخدميها أو إيراداتها غير كافية. يوفّر Ayakaleaf Pro الشيفرة المصدرية كاملة ويتيح لك استضافة كل خدمة ذاتيًا. وحتى لو توقفت الصيانة، يمكن لخدمتك المستضافة ذاتيًا الحالية أن تستمر في العمل.
أُعيدت تسميته إلى ayaka-notes/ayakaleaf-pro مع إعادة تسمية المشروع (راجع س08). لم يُؤرشف ولم يُستبدل: إنه المستودع نفسه، ويعيد GitHub توجيه روابط ayaka-notes/overleaf-pro القديمة ومستودعات Git البعيدة (remotes) إلى الاسم الجديد. وتحتفظ صورة Docker باسمها، ghcr.io/ayaka-notes/overleaf-pro، لذا لا تحتاج إلى تغيير config/overleaf.rc أو config/version.

الميزات

يُرجى مراجعة وثائقنا للاطلاع على قائمة الميزات الحالية. إذا كانت هناك ميزة تودّ أن نضيفها، فلا تتردد في فتح مشكلة (issue) على GitHub (لطلب ميزة). سنبذل قصارى جهدنا لتنفيذ الميزات المطلوبة، لكن التطوير يستغرق وقتًا، ولا يمكننا ضمان تقديم كل ميزة على الفور.
المساهمات مرحّب بها، لكن قبولها غير مضمون. نقيّم كل طلب سحب بناءً على تأثيره في قاعدة شيفرة Overleaf الأساسية، وعبء صيانته، والقيمة التي يقدّمها للمستخدمين. وسنبذل قصارى جهدنا لدمج المساهمات القيّمة وصيانتها.ومع ذلك، قد نرفض طلبات السحب التي تُدخل تغييرات مفرطة، أو تتكوّن من شيفرة مولّدة بالذكاء الاصطناعي لم تُراجَع أو لم تُفهم جيدًا (“vibe coding”)، أو تضيف ميزات يصعب صيانتها بمرور الوقت.
نحدّث الوثائق عمومًا كلما أصدرنا ميزة جديدة. يُرجى الرجوع إلى الوثائق ذات الصلة للاطلاع على تعليمات الإعداد التفصيلية وشرح متغيرات البيئة المتاحة.
يشغّل Python Runner لغة Python في متصفح المستخدم باستخدام Pyodide 0.29.3، وليس على الخادم. ويحمّل الحزم التي تستوردها شيفرتك من الحزم المضمّنة في Pyodide، مثل NumPy وpandas وMatplotlib. أما الحزم المثبتة باستخدام pip والحزم الأخرى فغير متاحة. لا يوجد ما يلزم تكوينه على الخادم.
لا. لا يملك المدقق الإملائي قاموسًا للغة اليابانية أو الصينية، لذا فهاتان اللغتان غير موجودتين في قائمة لغات التدقيق الإملائي. يمكن للمستخدمين إيقاف التدقيق الإملائي لمشروع ما من إعدادات المحرر.لمنع وضع علامة على كلمة على أنها خطأ إملائي، انقر عليها بزر الفأرة الأيمن واختر Add to dictionary. تُحفظ الكلمات المضافة في حسابك وتنطبق على جميع مشاريعك. لمراجعتها أو إزالتها، افتح إعدادات المحرر، ثم Spelling and language → Dictionary → Edit. ولا تؤدي إضافة الكلمات إلى إضافة لغة تدقيق إملائي جديدة.
لا يوجد مُثبِّت للإضافات. الميزات عبارة عن وحدات (modules) في services/web/modules من الشيفرة المصدرية، مبنية ضمن صورة Docker وتُفعَّل بالإعدادات الواردة في هذه الوثائق. لإضافة ميزاتك الخاصة، أضف وحدة إلى الشيفرة المصدرية وابنِ صورتك الخاصة.

النشر

بالنسبة إلى معظم المستخدمين، نوصي بالنشر باستخدام Toolkit. ودعم Kubernetes تجريبي: تعرض صفحة استخدام Kubernetes ملفات البيان (manifests) التي اختبرناها مع نسخة متماثلة واحدة أو عدة نسخ متماثلة (replicas)، لكن العنقود يضيف تعقيدًا تشغيليًا وجهدًا في الصيانة. تنشئ Sandboxed Compiles حاويات الترجمة الخاصة بها عبر مقبس Docker (Docker socket)، لذا تحتاج كل عقدة تشغّل Ayakaleaf Pro إلى Docker Engine. ولا نوفّر إعدادات لـ CRI-O أو Podman أو Quadlet.
يُرجى الرجوع إلى دليل التوسّع الأفقي. يمكنك نشر عدة نسخ من Overleaf وتكوين موازن تحميل (load balancer) لتوزيع حركة المرور بينها.
إذا كانت لديك نسخة قائمة من Overleaf Server Pro، فيسعدنا مساعدتك في الترحيل إلى Ayakaleaf Pro. يُرجى التواصل عبر البريد الإلكتروني أو المشكلات (issues).
لا. يجب تقديم Ayakaleaf Pro من جذر النطاق. استخدم نطاقًا أو نطاقًا فرعيًا مخصصًا، مثل https://overleaf.example.com.
نعم. يعمل Toolkit على Linux، وعلى macOS باستخدام Docker Desktop، وعلى Windows باستخدام WSL 2 وDocker Desktop. نوصي بنظام Linux للخوادم المشتركة وخوادم الإنتاج. يتضمن دليلا macOS وWindows إعداد Sandboxed Compiles.لا نوفر ملف docker-compose.yml مستقلًا. لرؤية إعدادات Compose التي يستخدمها Toolkit، شغّل bin/docker-compose config في مجلد Toolkit.
لا يوجد سكربت لإلغاء التثبيت. في مجلد Toolkit:
  1. أوقف الحاويات واحذفها باستخدام bin/docker-compose down.
  2. احذف البيانات. توجد افتراضيًا في المجلد data/ الخاص بـ Toolkit. إذا غيّرت OVERLEAF_DATA_PATH أو MONGO_DATA_PATH أو REDIS_DATA_PATH أو GIT_BRIDGE_DATA_PATH في config/overleaf.rc، فاحذف تلك المجلدات أيضًا. لا يمكن التراجع عن ذلك، لذا خذ نسخة احتياطية أولًا إذا كنت قد تحتاج إلى البيانات.
  3. احذف مجلد Toolkit.
  4. احذف صور Docker، التي يمكنك سردها باستخدام docker images: ghcr.io/ayaka-notes/overleaf-pro وصورة git-bridge وmongo وredis وصور TeX Live.
شغّل هذه الأوامر في مجلد Toolkit:
  • 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، راجع قسم الأسئلة والأجوبة في متغيرات البيئة.
في التطبيق الذي تنشئه لدى المزوّد، وليس في Ayakaleaf Pro. لا يوجد إعداد للاستدعاء في config/variables.env لأي من هذه التكاملات: يبني Ayakaleaf Pro كل عنوان URL للاستدعاء من OVERLEAF_SITE_URL ويرسله إلى المزوّد، الذي يرفضه ما لم يطابق العنوان المسجّل للتطبيق. لذا ما عليك سوى تسجيله لدى المزوّد، وضبط OVERLEAF_SITE_URL على العنوان الذي يفتحه المستخدمون.إذا غيّرت OVERLEAF_SITE_URL، على سبيل المثال إلى نطاق جديد، فحدّث عنوان URL لدى كل مزوّد أيضًا، وإلا فسيفشل الربط.
افتراضيًا، يبقى كل شيء على القرص المحلي للخادم، في مجلد 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/*.
نعم، بشرط أن يبقى Windows في وضع التشغيل وأن يبقى Docker Desktop قيد التشغيل. فعّل Start Docker Desktop when you sign in to your computer، وأبقِ على سياسات restart: always الخاصة بـ Toolkit، وعطّل السكون (sleep) والإسبات (hibernation) التلقائيين عند التوصيل بالتيار الكهربائي. يمكن أن تنطفئ الشاشة؛ أما سلوك إغلاق غطاء الحاسوب المحمول فهو إعداد منفصل. لا يؤدي إغلاق طرفية Ubuntu بعد bin/up -d إلى إيقاف الحاويات المنفصلة (detached). أما الخروج من Docker Desktop، أو إيقاف محركه مؤقتًا، أو تشغيل wsl --shutdown فيقطع الخدمة.يختلف Resource Saver في Docker Desktop عن سكون Windows: فهو يُطبَّق عندما لا تكون هناك حاويات قيد التشغيل، لذا لا تُعدّ حزمة Ayakaleaf العاملة خاملة لمجرد أن أحدًا لا يحرّر. وبعد إعادة تشغيل Windows، يظل إعداد بدء التشغيل عند تسجيل الدخول يتطلب أن يسجّل أحدهم الدخول. اتبع إبقاء النسخة متاحة لعمليات التحقق وخطوات الاستعادة. يبقى Linux توصيتنا عندما يجب ألا يعتمد التوافر على تسجيل دخول تفاعلي إلى سطح المكتب.
يستخدم هذا الدليل WSL 2 backend. ويتطلب تفعيل المحاكاة الافتراضية للمعالج (CPU virtualization) في BIOS/UEFI، وميزة Virtual Machine Platform في Windows، وتثبيتًا سليمًا لـ WSL 2. أما ميزة Hyper-V الكاملة فهي واجهة خلفية منفصلة لـ Docker Desktop وليست شرطًا مسبقًا لإعداد WSL هذا.تحقّق من Task Manager → Performance → CPU → Virtualization ومن wsl --list --verbose في PowerShell. قد تعني أخطاء مثل 0x80370102 أن المحاكاة الافتراضية، أو ميزة Windows، أو برنامج hypervisor عند الإقلاع معطّل. راجع خطوات استكشاف أخطاء تثبيت Windows وإصلاحها، مع روابط الإصلاح من Microsoft وDocker. أعد تشغيل Windows بعد تفعيل الميزات المطلوبة؛ إذ لا يمكن لإعادة تثبيت Ayakaleaf إصلاح محرك Docker لا يبدأ.

LaTeX

عند تفعيل Sandbox Compiles، تعمل عملية الترجمة الخاصة بكل مستخدم في حاوية Docker منفصلة، وتكون معزولة عن عمليات ترجمة المستخدمين الآخرين. يكون Shell Escape مفعّلًا افتراضيًا في Sandbox Compiles.
حسّنّا صورة TeX Live Full الخاصة بـ Sandbox Compiles على مدى السنوات الثلاث الماضية. في معظم الحالات، تُترجم المشاريع التي تُترجم بنجاح على overleaf.com بشكل صحيح أيضًا باستخدام Ayakaleaf Pro. إذا لم يكن أحد الخطوط المطلوبة متاحًا، فارفع ذلك الخط إلى مشروعك يدويًا.
يُرجى رفع مشروعك إلى موقع Overleaf الرسمي، وتفعيل مشاركة الرابط للقراءة فقط، وتضمين الرابط في مشكلة (issue) على GitHub.سنحقّق في أي أخطاء تمنع ترجمة مشروع في Ayakaleaf Pro ونصلحها، متى كان المشروع يُترجم بنجاح على موقع Overleaf الرسمي. أما مشكلات الترجمة الخارجة عن هذا النطاق فلا يشملها دعمنا.
آخر تعديل في ٨ نوفمبر ٢٠٢٦