Weblate internt

Observera

I det här kapitlet får du en grundläggande översikt över Weblates interna funktioner.

Weblate hämtar större delen av sin kodstruktur från och baseras på Django.

Katalogstruktur

Snabb översikt över katalogstrukturen i Weblates huvudarkiv:

docs

Källkoden för denna dokumentation, som kan byggas med hjälp av Sphinx.

dev-docker

Docker-kod för att köra utvecklingsservern, se Kör Weblate lokalt i Docker.

weblate

Källkoden för Weblate som en Django applikation, se Weblate internt.

weblate/static

Klientfiler (CSS, Javascript och bilder), se Weblate-frontend.

Moduler

Weblate består av flera Django-applikationer (vissa är valfria, se Valfria Weblate-moduler):

accounts

Användarkonto, profiler och aviseringar.

addons

Tillägg för att justera Weblates beteende, se Tillägg.

api

API baserat på Django REST framework.

auth

Autentisering och behörigheter.

billing

Den valfria modulen Fakturering.

checks

Översättningssträng Kvalitetskontroller-modul.

fonts

Modul för kontroll av teckensnittsrendering.

formats

Filformatabstraktionslager baserat på translate-toolkit.

gitexport

Det valfria modulen Git-exportör.

lang

Modul som definierar språk och pluralmodeller.

legal

Det valfria modulen Juridisk modul.

machinery

Integration av maskinöversättningstjänster.

memory

Inbyggt översättningsminne, se Översättningsminne.

screenshots

Skärmdumpshantering och OCR-modul.

trans

Huvudmodul som hanterar översättningar.

utils

Olika hjälpprogram.

vcs

Abstraktion av versionshanteringssystem.

wladmin

Anpassning av Djangos administratörsgränssnitt.

Translation sources

A unit has a canonical file source and may have a translation from another language as its effective source. Keep Unit.source and Unit.source_unit canonical: repository synchronization and file formats depend on this. Use effective_source and its language and plural accessors for content shown to translators. Do not replace source on a copied unit to simulate an effective source; other fields and related objects still describe the canonical source.

Use Unit.source_snapshot when an operation needs to preserve the source text, language, plural rules, and terminology metadata together. Its identity defines source changes for dependency reconciliation, editor conflict detection, and AI diagnostics. For historical rendering and reports, read the snapshot recorded on the change, rather than reconstructing it from the current unit.

A missing configured parent remains a custom source: its text is empty, its language is retained, and its child is blocked. effective_source_unit is then None. Only removing the workflow or selecting the canonical language restores the canonical source.

Text-only accessors do not load language or plural metadata. For batch consumers that need the complete effective source, use UnitQuerySet.prefetch_translation_parent() alongside their existing unit prefetches. prefetch_source() already includes this. Ordinary searches keep the canonical query path and ordinary units retain their existing content hashes.

Source-dependent writes enter source_operation() before locking unit rows. The outer operation takes a shared project gate and reads its workflow mapping in one database round trip, including for projects without custom workflows. Workflow changes take source_project_gate(..., exclusive=True) before validation or persistence. Configuration changes affecting several projects acquire their gates in ascending project ID order. Never upgrade a shared gate to an exclusive one inside an operation.

The database gate function locks first and reads workflows in a separate statement, so a waiter sees configuration committed while it waited. Write paths use this transaction-scoped view rather than cached model settings. Nested operations reuse it; rolled-back savepoints discard their dependency work. Queued dependencies are reconciled before commit and external memory updates are scheduled after commit. Source-change history is written in bulk, preserving individual records while batching their notification dispatch.

Acquire any required repository locks before project gates, then component and unit row locks. Reconciliation itself only changes database state and does not acquire repository locks. Apply this boundary to bulk imports, automatic translation, file-save failures, deletion, and restoration as well as editor writes. Language and plural-rule changes require exclusive gates before their updates. Historical migrations use historical models without these runtime helpers.

Machinery source selection happens before mapping language codes to a provider. Use get_unit_source_language() for translation and uses_custom_source() for workflow-specific glossary handling. Provider codes can merge distinct language variants, so code equality cannot determine whether a workflow source was selected. Explicit component or secondary source selection takes precedence over the workflow source.

Bakgrundsuppgifter internt

Råd

Detta avsnitt beskriver Celery-uppgiftens interna funktioner. Bakgrundsuppgifter med Celery beskriver hur man konfigurerar Celery för att köra uppgifterna.

Weblate använder Celery för att utföra uppgifter i bakgrunden. Vissa uppgifter utlöses av händelser, medan andra utlöses av scheman.

Celery Beat används för att schemalägga uppgifter, och django-celery-beat används för att lagra det periodiska uppgiftsschemat i databasen. Uppgiftsschemat konfigureras i tasks.py i var och en av Django-apparna.

Uppgifterna hanteras med hjälp av flera köer; routningen konfigureras i settings.py. Köerna har utformats för att separera olika typer av arbetsbelastning:

celery

Standardkön där bakgrundsuppgifter behandlas.

notify

Levererar e-postmeddelanden, både för händelser inom Weblate och för autentisering eller registrering. Detta är en separat kö för att göra e-postleveransen smidig även om det finns en eftersläpning av andra uppgifter.

memory

Uppdaterar översättningsminnets poster. Uppdateringskön kan bli lång när nya strängar importeras, och lång bearbetningstid spelar ingen större roll här, så en separat kö förhindrar att andra uppgifter blockeras.

backup

Säkerhetskopieringsuppgifterna kan inte utföras parallellt, och en enda dedikerad arbetare underlättar detta.

translate

Automatiska översättningsuppgifter är kända för att ta lång tid eftersom de använder externa tjänster.