الطبيب (Doctor)
يأتي Overleaf Toolkit مع سكربتdoctor مفيد للمساعدة في تصحيح الأخطاء. شغّل bin/doctor وسيطبع السكربت معلومات حول بيئة الجهاز المضيف، وإعداداتك، والتبعيات التي يحتاجها Toolkit. ويمكن لهذه المخرجات أيضًا أن تساعدنا في تشخيص مشكلات تثبيتات Ayakaleaf Pro الخاصة بك.
يمكن لمستخدمي Overleaf Pro فتح مشكلة (issue) على GitHub.من الجيد تضمين مخرجات السكربت
bin/doctor في رسالتك.استشارة الطبيب
شغّل سكربت doctor:Run doctor
مثال على المخرجات الكاملة
مثال على المخرجات الكاملة
معلومات الجهاز المضيف
يحتوي القسمHost Information على معلومات حول الجهاز الذي يشغّل Toolkit (على سبيل المثال، توزيعة Linux وإصدارها).
مثال على مخرجات معلومات الجهاز المضيف
مثال على مخرجات معلومات الجهاز المضيف
التبعيات
يسرد القسمDependencies الأدوات اللازمة لعمل Toolkit. إذا كانت الأداة موجودة فستُدرج بالحالة status: present مع معلومات الإصدار. وإذا كانت مفقودة فستُدرج بالحالة status: MISSING! وسيُضاف تحذير في أسفل مخرجات doctor.
مثال على مخرجات التبعيات (موجودة)
مثال على مخرجات التبعيات (موجودة)
مثال على مخرجات التبعيات (مفقودة)
مثال على مخرجات التبعيات (مفقودة)
الإعدادات
يحتوي القسمConfiguration على معلومات حول الملفات الموجودة في المجلد config/. بالنسبة للملف config/overleaf.rc، يطبع doctor بعض القيم الأساسية. وستُدرج الملفات المفقودة بالحالة status: MISSING! وسيُضاف تحذير في أسفل مخرجات doctor.
مثال على مخرجات الإعدادات
مثال على مخرجات الإعدادات
- قد لا يكون تعيين
OVERLEAF_DATA_PATHإلى/tmp/overleafموقعًا آمنًا للبيانات المهمة. - تعني
MONGO_ENABLED: falseأن Toolkit لن يوفّر MongoDB خاصًا به؛ تأكد من أنMONGO_URLيشير إلى MongoDB مُدار خارجيًا إذا لزم الأمر. - الملف
config/variables.envمفقود في المثال.
التحذيرات
يلخّص القسمWarnings المشكلات التي اكتشفها سكربت doctor. وإذا لم تكن هناك مشكلات، فسيشير هذا القسم إلى ذلك.
مثال على مخرجات التحذيرات
مثال على مخرجات التحذيرات
أسئلة وأجوبة
هل تحتاج رسائل quay.io وإعدادات Docker والإعدادات المحلية (locale) لـ Perl الصادرة عن bin/doctor إلى إصلاح؟
هل تحتاج رسائل quay.io وإعدادات Docker والإعدادات المحلية (locale) لـ Perl الصادرة عن bin/doctor إلى إصلاح؟
الإجابة: لا، الرسائل الثلاث كلها للعلم فقط. يطبع
bin/doctor تقريرًا فحسب، ولا يوقف bin/up.logged in to quay.io: falseوالتحذيرServer Pro enabled, but not logged in to quay.io repository: يأتي هذا الفحص من Toolkit الرسمي، حيث تكون صورة Server Pro على سجل quay.io خاص. ومعSERVER_PRO=true، يسحب Toolkit الصورةghcr.io/ayaka-notes/overleaf-pro، وهي عامة، لذا لا حاجة إلى تسجيل الدخول. تجاهل هذا التحذير.grep: /root/.docker/config.json: No such file or directory(أو مجلد منزلي آخر): يبحث فحص quay.io عنquay.ioفي ذلك الملف. لا يكتب Docker هذا الملف إلا عندما تكون لديه إعدادات لحفظها، مثلًا بعدdocker login، لذا فهو غير موجود على كثير من الخوادم. وهو غير مطلوب.perl: warning: Setting locale failed: لا يستخدم Toolkit الأمرperlإلا هنا، فيbin/doctor، لطباعة إصداره، ويُصدر Perl تحذيرًا عندما يشيرLANGأوLC_ALLإلى إعداد محلي (locale) غير مثبّت على المضيف. ومع ذلك يُطبع الإصدار. لإخفاء التحذير، اضبط هذه المتغيرات على إعداد محلي مُدرج في ناتجlocale -a، مثلC.UTF-8.
Docker daemon is not running أو docker not found أو Docker Compose not found أو وجود ملف مفقود في config/ فتحتاج إلى إصلاح: إذ لا يمكن لـ Toolkit البدء بدونها.
