الانتقال إلى المحتوى الرئيسي
يتضمن Ayakaleaf Pro وحدة تنزّل الصفحات من موقع MediaWiki على عنوان URL تحدده أنت، وتقدّمها تحت المسار /learn في نسختك. لا يشحن Ayakaleaf Pro أي محتوى Wiki ولا يستضيفه ولا يوزّعه بنفسه. لتفعيل الوحدة، أضف OVERLEAF_PROXY_LEARN=true إلى ملف config/variables.env في Toolkit ثم شغّل الأمر bin/up. يمكن للمستخدمين بعد ذلك فتح صفحات Wiki بالنقر على زر Documentation في قائمة التنقل، دون مغادرة نسختك.
افتراضيًا، لا يمكن فتح /learn إلا للمستخدمين المسجلين دخولهم. لإتاحتها للزوار غير المسجلين، اضبط أيضًا OVERLEAF_ALLOW_PUBLIC_ACCESS=true، راجع Page Access.
في عمليات النشر باستخدام Docker Compose، ستحتاج إلى إضافة متغير البيئة OVERLEAF_PROXY_LEARN: true إلى قسم environment الخاص بخدمة sharelatex في ملف docker-compose.yml.
عند تفعيل هذا الخيار لأول مرة وإعادة تشغيل حاوية Overleaf في Docker، يحتاج النظام إلى تنزيل صفحات Wiki ذات الصلة، وقد يستغرق ذلك 5 دقائق أو أكثر. ولن تتمكن من رؤية صفحة تسجيل الدخول إلى Overleaf بنجاح إلا بعد اكتمال التنزيل.

اختيار مصدر Wiki

يُحدَّد موقع Wiki المراد تمريره عبر الوكيل باستخدام WIKI_URL. إذا تركته دون ضبط، تُستخدم القيمة الافتراضية الموروثة من إعدادات Overleaf الأصلية (services/web/config/settings.defaults.js):
هذا هو موقع Wiki الذي تقوم عليه صفحات Overleaf Learn. تحتاج نسختك إلى الوصول إلى الإنترنت للوصول إليه.
انتبه لحقوق النشر. تجلب الوحدة المحتوى فقط من عنوان URL المحدد في WIKI_URL؛ والمحتوى ملك لمن يدير ذلك الموقع. عند تفعيلها، تنزّل نسختك كل صفحة من صفحات ذلك الموقع وتحتفظ بنسخة منها على خادمك. يدير Overleaf موقع Wiki الافتراضي، ومحتواه مملوك لـ Overleaf وليس لـ Ayakaleaf Pro. قبل تفعيل الوحدة، تحقق من أن تنزيل تلك الصفحات وتخزينها وتقديمها يتوافق مع شروط Overleaf، خاصة إذا كانت نسختك مفتوحة للزوار غير المسجلين. إن كنت في شك، فوجّه WIKI_URL إلى موقع Wiki تملك محتواه أو لديك ترخيص باستخدامه.
يمكنك بدلًا من ذلك توجيه WIKI_URL إلى موقع Wiki خاص بك، مثل قاعدة معرفة داخلية:
يجب أن يكون موقع Wiki موقع MediaWiki يقدّم:
  • واجهته البرمجية (API) على <WIKI_URL>/learn-scripts/api.php، مع إمكانية القراءة المجهولة لـ action=query وaction=parse
  • الصور المرفوعة تحت <WIKI_URL>/learn-scripts/images/
  • روابط المقالات بالصيغة /learn/<Page>، والتي تعيد الوحدة كتابتها إلى /learn/latex/<Page> في نسختك
هذه المسارات ثابتة في الوحدة وتتبع بنية موقع Wiki الافتراضي. يستخدم تثبيت MediaWiki الجديد مسارات مختلفة، لذا اضبط ما يلي في ملف LocalSettings.php الخاص به (أو اربط المسارات في الوكيل العكسي لديك):
تُربط الصفحات على النحو التالي:

ذاكرة التخزين المؤقت

تُخزَّن الصفحات المجلوبة مؤقتًا في /var/lib/overleaf/data/learnPages داخل حاوية sharelatex. تُحدَّث الصفحة المخزنة مؤقتًا عندما يتجاوز عمرها WIKI_MAX_CACHE_AGE ميلي ثانية (القيمة الافتراضية 300000، أي 5 دقائق). إذا تعذّر الوصول إلى موقع Wiki، يستمر تقديم النسخة المخزنة مؤقتًا.

شكر وتقدير

يستند تنفيذ الوحدة إلى وكيل learn في overleaf-go من تطوير Jakob Ackermann، وهو نسخة من Overleaf بلغة Golang مرخّصة بموجب AGPL-3.0، بما في ذلك طريقة ربط الصفحات واستخدام واجهة MediaWiki البرمجية.
آخر تعديل في ٢ نوفمبر ٢٠٢٦