A Weblate belső működése¶

Megjegyzés

Ez a fejezet áttekintést ad a Weblate belső felépítéséről.

A Weblate felépítése nagyrészt a Django keretrendszerre épül, annak kódszerkezetét követi.

Könyvtárstruktúra¶

Gyors áttekintés a Weblate fő tárolójának könyvtárfelépítéséről:

docs: A dokumentáció forráskódja, amely Sphinx segítségével építhető.
dev-docker: Docker-kód a fejlesztői szerver futtatásához – lásd: Weblate futtatása helyileg Dockerben.
weblate: A Weblate forráskódja mint Django alkalmazás – lásd: A Weblate belső működése.
weblate/static: Kliensfájlok (CSS, JavaScript és képek) – lásd: Weblate felhasználói felület.

Modulok¶

A Weblate több Django-alkalmazásból áll (egyesek opcionálisak – lásd: Opcionális Weblate modulok):

accounts

Felhasználói fiókok, profilok és értesítések kezelése.

addons

Kiegészítők a Weblate működésének testreszabásához – lásd: Kiegészítők.

api

API a Django REST framework alapján.

auth

Hitelesítés és jogosultságkezelés.

billing

Az opcionális Számlázás modul.

checks

Fordítási szöveg ellenőrzések modul.

fonts

Betűkészlet-megjelenítési ellenőrző modul.

formats

Fájlformátum absztrakciós réteg a translate-toolkit alapján.

gitexport

Az opcionális Git exportáló modul.

lang

A nyelvi és többes számú formák modelljeit definiáló modul.

legal

Az opcionális Jogi modul modul.

machinery

Gépi fordítási szolgáltatások integrációja.

memory

Beépített fordítási memória – lásd: Fordítási memória.

screenshots

Képernyőképek kezelése és OCR modul.

trans

A fordításokat kezelő főmodul.

utils

Különféle segédprogramok.

vcs

Verziókezelő rendszer absztrakció (réteg).

wladmin

A Django admin felület testreszabása.

Background tasks internals¶

Tipp

This section describes Celery task internals. Háttérfeladatok Celery használatával describes how to configure Celery to run the tasks.

Weblate uses Celery to execute tasks in the background. Some tasks are event-triggered, and some tasks are schedule-triggered.

The Celery Beat is used for scheduling tasks, and django-celery-beat is used to store the periodic task schedule in the database. The tasks schedule is configured in tasks.py in each of the Django apps.

The tasks are consumed using several queues; the routing is configured in settings.py. The queues were designed to separate different types of workload:

celery: The default queue where background tasks are processed.
notify: Delivers notification e-mails, both for events within Weblate and for authentication or registration. This is a separate queue to make e-mail delivery smooth even if there is a backlog of other tasks.
memory: Updates translation memory entries. The updating queue can be long when importing new strings, and long processing does not matter much here, so having a separate queue avoids blocking other tasks.
backup: The backup tasks cannot be executed in parallel, and a single dedicated worker makes this easier.
translate: Automatic translation tasks are known to take long because they hit external services.