الحصول على المساعدة

​

الطبيب (Doctor)

يأتي Overleaf Toolkit مع سكربت doctor مفيد للمساعدة في تصحيح الأخطاء. شغّل bin/doctor وسيطبع السكربت معلومات حول بيئة الجهاز المضيف، وإعداداتك، والتبعيات التي يحتاجها Toolkit. ويمكن لهذه المخرجات أيضًا أن تساعدنا في تشخيص مشكلات تثبيتات Ayakaleaf Pro الخاصة بك.

يمكن لمستخدمي Overleaf Pro فتح مشكلة (issue) على GitHub.

من الجيد تضمين مخرجات السكربت bin/doctor في رسالتك.

​

استشارة الطبيب

شغّل سكربت doctor:

Run doctor

bin/doctor

سترى مخرجات مشابهة للمثال أدناه.

مثال على المخرجات الكاملة

====== Overleaf Doctor ======
- Host Information
    - Linux
    - Output of 'lsb_release -a':
            No LSB modules are available.
            Distributor ID:	Ubuntu
            Description:	Ubuntu 22.04.5 LTS
            Release:	22.04
            Codename:	jammy
- Dependencies
    - bash
        - status: present
        - version info: 5.1.16(1)-release
    - docker
        - status: present
        - version info: Docker version 28.0.4, build b8034c0
    - docker compose
        - status: present
        - version info: Docker Compose version v2.34.0
    - realpath
        - status: present
        - version info: realpath (GNU coreutils) 8.32
    - perl
        - status: present
        - version info: 5.034000
    - awk
        - status: present
        - version info: mawk 1.3.4 20200120
- Docker Daemon
    - status: up
====== Configuration ======
- config/version
    - status: present
    - version: 5.4.0
- config/overleaf.rc
    - status: present
    - values
        - OVERLEAF_DATA_PATH: data/overleaf
        - OVERLEAF_LOG_PATH: data/overleaf/logs
        - SERVER_PRO: true
        - SIBLING_CONTAINERS_ENABLED: true
            - logged in to quay.io: true
        - MONGO_ENABLED: true
        - REDIS_ENABLED: true
- config/variables.env
    - status: present
    - values
        - OVERLEAF_FILESTORE_BACKEND: fs
        - OVERLEAF_HISTORY_BACKEND: fs

====== Warnings ======
- None, all good
====== End ======

​

معلومات الجهاز المضيف

يحتوي القسم Host Information على معلومات حول الجهاز الذي يشغّل Toolkit (على سبيل المثال، توزيعة Linux وإصدارها).

مثال على مخرجات معلومات الجهاز المضيف

- Host Information
    - Linux
    - Output of 'lsb_release -a':
            No LSB modules are available.
            Distributor ID:	Ubuntu
            Description:	Ubuntu 22.04.5 LTS
            Release:	22.04
            Codename:	jammy

​

التبعيات

يسرد القسم Dependencies الأدوات اللازمة لعمل Toolkit. إذا كانت الأداة موجودة فستُدرج بالحالة status: present مع معلومات الإصدار. وإذا كانت مفقودة فستُدرج بالحالة status: MISSING! وسيُضاف تحذير في أسفل مخرجات doctor.

مثال على مخرجات التبعيات (موجودة)

- docker
    - status: present
    - version info: Docker version 28.0.4, build b8034c0

مثال على مخرجات التبعيات (مفقودة)

- docker
    - status: MISSING!

إذا كانت أي من التبعيات مفقودة، فمن شبه المؤكد أن Toolkit لن يعمل.

​

الإعدادات

يحتوي القسم Configuration على معلومات حول الملفات الموجودة في المجلد config/. بالنسبة للملف config/overleaf.rc، يطبع doctor بعض القيم الأساسية. وستُدرج الملفات المفقودة بالحالة status: MISSING! وسيُضاف تحذير في أسفل مخرجات doctor.

مثال على مخرجات الإعدادات

====== Configuration ======
- config/version
    - status: present
    - version: 5.4.0
- config/overleaf.rc
    - status: present
    - values
        - OVERLEAF_DATA_PATH: /tmp/overleaf
        - SERVER_PRO: false
        - MONGO_ENABLED: false
        - REDIS_ENABLED: true
- config/variables.env
    - status: MISSING!

ملاحظات حول المثال أعلاه:

• قد لا يكون تعيين OVERLEAF_DATA_PATH إلى /tmp/overleaf موقعًا آمنًا للبيانات المهمة.
• تعني MONGO_ENABLED: false أن Toolkit لن يوفّر MongoDB خاصًا به؛ تأكد من أن MONGO_URL يشير إلى MongoDB مُدار خارجيًا إذا لزم الأمر.
• الملف config/variables.env مفقود في المثال.

​

التحذيرات

يلخّص القسم Warnings المشكلات التي اكتشفها سكربت doctor. وإذا لم تكن هناك مشكلات، فسيشير هذا القسم إلى ذلك.

مثال على مخرجات التحذيرات

====== Warnings ======
- configuration file variables.env not found
- rc file, OVERLEAF_DATA_PATH not set
====== End =======