Weblate-Interna

Bemerkung

Dieses Kapitel gibt Ihnen einen grundlegenden Überblick über die Interna von Weblate.

Weblate leitet den größten Teil seiner Codestruktur von Django ab und basiert auf diesem.

Verzeichnissstruktur

Schneller Überblick über die Verzeichnisstruktur des Weblate-Hauptrepositorys:

docs

Quellcode für diese Dokumentation, die mit Sphinx erstellt werden kann.

dev-docker

Docker-Code zum Betrieb des Entwicklungsservers, siehe Weblate lokal in Docker ausführen.

weblate

Quellcode von Weblate als Django-Anwendung, siehe Weblate-Interna.

weblate/static

Client-Dateien (CSS, Javascript und Bilder), siehe Weblate-Frontend.

Module

Weblate besteht aus mehreren Django-Anwendungen (einige sind optional, siehe Optionale Weblate-Module):

accounts

Benutzerkonto, Profile und Benachrichtigungen.

addons

Erweiterungen um das Verhalten von Weblate zu verändern, siehe Erweiterungen.

api

API basierend auf Django REST framework.

auth

Authentifizierung und Berechtigungen.

billing

Das optionale Modul Abrechnung.

checks

Übersetzungszeichenketten-Modul Qualitätsprüfungen.

fonts

Schriftrendering-Überprüfungsmodul.

formats

Dateiformat-Abstraktionsschicht basierend auf translate-toolkit.

gitexport

Das optionale Modul Git-Exporter.

lang

Modul zur Definition von Sprach- und Pluralmodellen.

legal

Das optionale Modul Rechtsmodul.

machinery

Integration von maschinellen Übersetzungsdiensten.

memory

Integrierter Übersetzungsspeicher, siehe Übersetzungsspeicher.

screenshots

Verwalten von Bildschirmfotos und OCR-Modul.

trans

Hauptmodul für Übersetzungen.

utils

Verschiedene Hilfsprogramme.

vcs

Abstraktion der Versionsverwaltung.

wladmin

Anpassen der Django-Adminoberfläche.

Interne Hintergrundaufgaben

Hinweis

Dieser Abschnitt beschreibt die internen Vorgänge von Celery-Aufgaben. Hintergrundaufgaben mit Celery beschreibt, wie Celery für das Ausführen der Aufgaben konfiguriert wird.

Weblate verwendet Celery, um Aufgaben im Hintergrund auszuführen. Einige Aufgaben sind ereignisgesteuert, andere zeitgesteuert.

Der Celery Beat wird für die Planung von Aufgaben verwendet, und django-celery-beat wird verwendet, um den periodischen Aufgabenplan in der Datenbank zu speichern. Der Aufgabenplan wird unter tasks.py in jeder der Django-Apps konfiguriert.

Die Aufgaben werden über mehrere Warteschlangen abgearbeitet; das Routing wird in settings.py konfiguriert. Die Warteschlangen wurden entwickelt, um verschiedene Arten von Arbeitslasten zu trennen:

celery

Die Standardwarteschlange, in der Hintergrundaufgaben verarbeitet werden.

notify

Liefert E-Mail-Benachrichtigungen, sowohl für Ereignisse innerhalb von Weblate als auch für die Authentifizierung oder Registrierung. Dies ist eine separate Warteschlange, damit die E-Mail-Zustellung auch dann reibungslos verläuft, wenn es einen Rückstau bei anderen Aufgaben gibt.

memory

Aktualisiert Übersetzungsspeichereintrage. Die Aktualisierungswarteschlange kann beim Importieren neuer Zeichenketten sehr lang sein, und eine lange Verarbeitungszeit spielt hier keine große Rolle, so dass eine separate Warteschlange das Blockieren anderer Aufgaben verhindert.

backup

Die Sicherungsaufgaben können nicht parallel ausgeführt werden, und ein einzelner dedizierter Worker erleichtert dies.

translate

Automatische Übersetzungsaufgaben dauern bekanntermaßen lange, da sie auf externe Dienste angewiesen sind.