Yardım alma

​

Doctor

Overleaf Toolkit, hata ayıklamaya yardımcı olan kullanışlı bir doctor betiğiyle birlikte gelir. bin/doctor komutunu çalıştırdığınızda betik, ana makine ortamınız, yapılandırmanız ve Toolkit’in ihtiyaç duyduğu bağımlılıklar hakkında bilgi yazdırır. Bu çıktı, Ayakaleaf Pro kurulumlarınızdaki sorunları teşhis etmemize de yardımcı olabilir.

Overleaf Pro kullanıcıları GitHub’da bir issue açabilir.

Mesajınıza bin/doctor betiğinin çıktısını eklemeniz iyi bir fikirdir.

​

Doctor’a danışma

Doctor betiğini çalıştırın:

Run doctor

bin/doctor

Aşağıdaki örneğe benzer bir çıktı göreceksiniz.

Tam çıktı örneği

====== 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 ======

​

Ana Makine Bilgileri

Host Information bölümü, Toolkit’i çalıştıran makine hakkında bilgi içerir (örneğin Linux dağıtımı ve sürümü).

Ana Makine Bilgileri çıktısı örneği

- 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

​

Bağımlılıklar

Dependencies bölümü, Toolkit’in çalışması için gereken araçları listeler. Bir araç mevcutsa sürüm bilgisiyle birlikte status: present olarak listelenir. Eksikse status: MISSING! olarak listelenir ve doctor çıktısının sonuna bir uyarı eklenir.

Bağımlılık çıktısı örneği (mevcut)

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

Bağımlılık çıktısı örneği (eksik)

- docker
    - status: MISSING!

Herhangi bir bağımlılık eksikse Toolkit neredeyse kesinlikle çalışmayacaktır.

​

Yapılandırma

Configuration bölümü, config/ dizinindeki dosyalar hakkında bilgi içerir. config/overleaf.rc için doctor bazı önemli değerleri yazdırır. Eksik dosyalar status: MISSING! olarak listelenir ve doctor çıktısının sonuna bir uyarı eklenir.

Yapılandırma çıktısı örneği

====== 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!

Yukarıdaki örnekten notlar:

• /tmp/overleaf olarak ayarlanan OVERLEAF_DATA_PATH, önemli veriler için güvenli bir konum olmayabilir.
• MONGO_ENABLED: false, Toolkit’in kendi MongoDB’sini sağlamayacağı anlamına gelir; gerekirse MONGO_URL değerinin harici olarak yönetilen bir MongoDB’yi gösterdiğinden emin olun.
• Örnekte config/variables.env eksiktir.

​

Uyarılar

Warnings bölümü, doctor betiğinin tespit ettiği sorunları özetler. Sorun yoksa bu bölüm bunu belirtir.

Uyarılar çıktısı örneği

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