Installation unter Debian und Ubuntu¶

Hardwareanforderungen¶

Weblate should run on any contemporary hardware without problems, the following is the minimal configuration required to run Weblate on a single host (Weblate, database and web server):

3 GB Arbeitsspeicher
2 CPU-Kerne
1 GB Speicherplatz

Bemerkung

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

Memory usage¶

The more memory the better - it is used for caching on all levels (file system, database and Weblate). For hundreds of translation components, at least 4 GB of RAM is recommended.

Hinweis

Für Systeme mit weniger Speicher als empfohlen, wird Celery-Einzelprozess einrichten empfohlen.

CPU usage¶

Many concurrent users increase the amount of needed CPU cores.

Storage usage¶

The typical database storage usage is around 300 MB per 1 million hosted words.

Storage space needed for cloned repositories varies, but Weblate tries to keep their size minimal by doing shallow clones.

Nodes¶

For small and medium-sized sites (millions of hosted words), all Weblate components (see Architekturübersicht) can be run on a single node.

When you grow to hundreds of millions of hosted words, it is recommended to have a dedicated node for database (see Datenbankeinrichtung für Weblate).

Installation¶

Systemvoraussetzungen¶

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

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 gir1.2-rsvg-2.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 möchten (siehe Python-Abhängigkeiten):

apt install -y \
   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 dedizierten 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

# Gettext for the msgmerge add-on
apt install -y gettext

Python-Module¶

Hinweis

Wir verwenden virtualenv, um Ihre Weblate-Installation in einer von Ihrem System getrennten Einsatzumgebung zu installieren. Wenn Sie damit nicht vertraut sind, lesen Sie den User Guide von virtualenv.

virtualenv für Weblate erstellen:
```
virtualenv ~/weblate-env
```
virtualenv für Weblate aktivieren:
```
. ~/weblate-env/bin/activate
```
Weblate einschließlich aller optionalen Abhängigkeiten installieren:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
Bitte die Python-Abhängigkeiten für die Feinabstimmung der optionalen Abhängigkeiten überprüfen.
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.

Die Datei ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py nach ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py kopieren.
Die Werte in der neuen Datei settings.py nach eigenen Wünschen anpassen. Es müssen zumindest die Datenbank-Zugangsdaten und der geheime Django-Schlüssel angeben werden, es werden jedoch mehr Änderungen für die Produktionseinrichtung benötigt, siehe Anpassen der Konfiguration.
Die Datenbank und ihre Struktur für Weblate erstellen (die Beispieleinstellungen verwenden PostgreSQL, siehe Datenbankeinrichtung für Weblate für eine produktionsreife Einrichtung):
```
weblate migrate
```
Siehe auch

migrate
Ein Administrator-Benutzerkonto admin erstellen, dessen Passwort generieren und es in die Zwischenablage kopieren; denken Sie daran, es zur späteren Verwendung zu speichern:
```
weblate createadmin
```
Hinweis

Wenn Sie das Administratorpasswort vergessen oder verloren haben, können Sie mit dem folgenden Befehl ein neues Passwort erstellen:
```
weblate createadmin --update
```
Siehe auch

createadmin
Die statischen Dateien für den Webserver sammeln (siehe Laufender Server und Bereitstellung statischer Dateien):
```
weblate collectstatic
```
Die JavaScript- und CSS-Dateien komprimieren (optional, siehe Client-Assets komprimieren):
```
weblate compress
```
Die Celery-Worker starten. 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
```
Den Entwicklungsserver starten (Laufender Server beschreibt eine Produktionseinrichtung):
```
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 Leistungsbericht) oder mit weblate check --deploy, siehe Produktionseinrichtung.

Hinzufügen einer Übersetzung¶

Die Adminoberfläche öffnen (http://localhost:8000/create/project/) und ein Projekt erstellen, das übersetzt werden soll. Siehe Projektkonfiguration für weitere Details.

Es muss hier nur der Name des Projekts und dessen Website angegeben werden.
Eine Komponente erstellen, 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: Komponentenname, Quellcode-Repository und Dateimaske. Weblate unterstützt eine Vielzahl von Formaten, darunter GNU gettext PO (Portable Object), Android-Zeichenketten-Ressourcen, Apple-iOS-Zeichenketten, Java-Properties, Stringsdict-Format oder Fluent-Format, siehe Unterstützte Dateiformate für weitere Details.
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), kann mit dem Übersetzen begonnen werden.