Installation unter Debian und Ubuntu

Hardwareanforderungen

Weblate sollte auf jeder zeitgemäßen Hardware problemlos laufen. Nachfolgend finden Sie die minimale Konfiguration, die erforderlich ist, um Weblate auf einem einzelnen Host zu betreiben (Weblate, Datenbank und Webserver):

  • 3 GB Arbeitsspeicher

  • 2 CPU-Kerne

  • 1 GB Speicherplatz

Je mehr Speicher, desto besser – er wird für das Caching auf allen Ebenen (Dateisystem, Datenbank und Weblate) verwendet.

Viele gleichzeitige Benutzer erhöhen die Anzahl der benötigten CPU-Kerne. Für Hunderte von Übersetzungskomponenten werden mindestens 4 GB RAM empfohlen.

Dies hat schwerwiegende Auswirkungen auf die Leistung der Weboberfläche und beeinträchtigt Funktionen, die von regelmäßigen Auslösern abhängen (z. B. das Übertragen ausstehender Änderungen, Digest-Benachrichtigungen oder Sicherungen).

Bemerkung

Die tatsächlichen Anforderungen an Ihre Weblate-Installation hängen stark von der Größe der darin verwalteten Übersetzungen ab.

Installation

Systemvoraussetzungen

Installieren Sie die Abhängigkeiten, die für die Erstellung der Python-Module erforderlich sind (siehe Software-Anforderungen):

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 libgirepository1.0-dev \
   libacl1-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev python3-pip python3-virtualenv virtualenv git

Installieren Sie die gewünschten optionalen Abhängigkeiten abhängig von den Funktionen, die Sie verwenden wollen (siehe Optionale Abhängigkeiten):

apt install -y \
   tesseract-ocr libtesseract-dev libleptonica-dev \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

Installieren Sie optional Software für den Betrieb des Produktionsservers, siehe Laufender Server, Datenbankeinrichtung für Weblate, Hintergrundaufgaben mit Celery. Je nach Größe Ihrer Installation sollten Sie diese Komponenten auf getrennten Servern laufen lassen.

Lokale Installationsanweisungen:

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Redis
apt install -y redis-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

Python-Module

Hinweis

Sie können Einstellungen vor oder nach der obigen Importanweisung definieren, um festzulegen, welche Einstellungen Vorrang haben. Vor der Importanweisung definierte Einstellungen können durch Umgebungsvariablen und im Daten-Volume definierte Einstellungsüberschreibungen außer Kraft gesetzt werden. Einstellungen, die nach der Importanweisung definiert werden, können nicht überschrieben werden.

  1. Erstellen Sie die Virtualenv für Weblate:

    virtualenv ~/weblate-env

  2. Aktivieren Sie die Virtualenv für Weblate:

    . ~/weblate-env/bin/activate

  3. Installieren Sie Weblate einschließlich aller optionalen Abhängigkeiten:

    # Install Weblate with all optional dependencies
pip install "Weblate[all]"

    Bitte prüfen Sie Optionale Abhängigkeiten für die Feinabstimmung der optionalen Abhängigkeiten.

    Bemerkung

    Auf einigen Linux-Distributionen schlägt die Ausführung von Weblate mit einem libffi-Fehler fehl:

    ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)

    Dies wird durch die Inkompatibilität von Binärpaketen verursacht, die über PyPI mit der Distribution verteilt werden. Um dies zu beheben, müssen Sie das Paket auf Ihrem System neu erstellen:

    pip install --force-reinstall --no-binary :all: cffi

Weblate konfigurieren

Bemerkung

Im Folgenden wird davon ausgegangen, dass die von Weblate verwendete Virtualenv aktiviert ist (durch Ausführung von . ~/weblate-env/bin/activate). Falls nicht, geben Sie den vollständigen Pfad zum Befehl weblate als ~/weblate-env/bin/weblate an.

  1. Kopieren Sie die Datei ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py nach ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.

  2. Passen Sie die Werte in der neuen Datei settings.py nach Ihren Wünschen an. Sie müssen zumindest die Datenbank-Zugangsdaten und den geheimen Django-Schlüssel angeben, aber Sie werden mehr Änderungen für die Produktionseinrichtung benötigen, siehe Anpassen der Konfiguration.

  3. Erstellen Sie die Datenbank und ihre Struktur für Weblate (die Beispieleinstellungen verwenden PostgreSQL, sehen Sie sich Datenbankeinrichtung für Weblate für ein produktionsreifes Setup an):

    weblate migrate

  4. Erstellen Sie ein Benutzerkonto für den Administrator und kopieren Sie dessen Passwort in die Zwischenablage, und speichern Sie es zur späteren Verwendung:

    weblate createadmin

  5. Sammeln Sie die statischen Dateien für Ihren Webserver (siehe Laufender Server und Bereitstellung statischer Dateien):

    weblate collectstatic

  6. Komprimieren Sie die JavaScript- und CSS-Dateien (optional, siehe Client-Assets komprimieren):

    weblate compress

  7. Starten Sie die Celery-Arbeiter. Dies ist für Entwicklungszwecke nicht notwendig, wird aber ansonsten dringend empfohlen. Hintergrundaufgaben mit Celery hat mehr Informationen:

    ~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start

  8. Starten Sie den Entwicklungsserver (:ref:‘server‘ beschreibt ein Produktionssetup):

    weblate runserver

Nach der Installation

Herzlichen Glückwunsch, Ihr Weblate-Server läuft jetzt und Sie können ihn nutzen.

  • Sie können jetzt auf Weblate unter http://localhost:8000/ zugreifen.

  • Melden Sie sich mit den bei der Installation erhaltenen Administrator-Zugangsdaten an oder registrieren Sie sich mit neuen Benutzern.

  • Sie können jetzt Weblate-Befehle mit dem Befehl weblate ausführen, wenn Weblate virtualenv aktiv ist, siehe Verwaltungsbefehle.

  • Sie können den Testserver mit Strg+C anhalten.

  • Überprüfen Sie mögliche Probleme mit Ihrer Installation entweder unter der URL /manage/performance/ (siehe Verwaltungsoberfläche) oder mit weblate check --deploy, siehe Produktionseinrichtung.

Hinzufügen einer Übersetzung

  1. Öffnen Sie die Verwaltungsoberfläche (http://localhost:8000/create/project/) und erstellen Sie das Projekt, das Sie übersetzen möchten. Siehe Projektkonfiguration für weitere Details.

    Sie müssen hier nur den Namen des Projekts und dessen Website angeben.

  2. Erstellen Sie eine Komponente, die das eigentliche Objekt für die Übersetzung ist – sie verweist auf das VCS-Repository und wählt die zu übersetzenden Dateien aus. Siehe Komponentenkonfiguration für weitere Details.

    Die wichtigen Felder hier, um übersetzbare Dateien zu finden, sind: Name der Komponente, Quellcode-Repository und Dateimaske. Weblate unterstützt eine Vielzahl von Formaten, darunter GNU gettext, Android String-Ressourcen, Apple iOS-Zeichenketten, Java properties, Stringsdict-Format oder Fluent-Format, siehe Unterstützte Dateiformate für weitere Details.

  3. Sobald die Schritte oben abgeschlossen sind (je nach Größe Ihres VCS-Repositorys und der Anzahl der zu übersetzenden Nachrichten kann dies ein langwieriger Prozess sein), können Sie mit dem Übersetzen beginnen.