Componentes internos do Weblate

Nota

Este capítulo lhe dará uma visão geral básica dos componentes internos do Weblate.

Weblate deriva a maior parte da estrutura de código dele e é baseado no Django.

Estrutura de pasta

Visão geral rápida da estrutura de pasta do repositório principal de Weblate:

docs

Código fonte para esta documentação, que pode ser criada utilizando Sphinx.

dev-docker

Código de Docker para executar o servidor de desenvolvimento, consulte Executando Weblate localmente no Docker.

weblate

Código fonte de Weblate como uma aplicação Django, consulte Componentes internos do Weblate.

weblate/static

Ficheiro de cliente (CSS, Javascript e imagens), veja Frontend do Weblate.

Módulos

O Weblate consiste em vários aplicações Django (alguns opcionais, veja Módulos opcionais do Weblate):

accounts

Conta do utilizador, perfis e notificações.

addons

Extensões para ajustar o comportamento do Weblate, veja Extensões.

api

API baseada no framework Django REST.

auth

Autenticação e permissões.

billing

O módulo opcional de Faturação.

checks

Módulo de Verificações de qualidade de cadeia de tradução.

fonts

Módulo de verificações de renderização de fonte.

formats

Camada de abstração de formato de ficheiro baseada no translate-toolkit.

gitexport

O módulo opcional Exportador git.

lang

Módulo que define idioma e modelos plurais.

legal

O módulo opcional Módulo legal.

machinery

Integração de serviços de tradução de máquina.

memory

Memória de tradução integrada, ver Memória de Tradução.

screenshots

Gestão de capturas de ecrã e módulo OCR.

trans

Módulo principal que trata das traduções.

utils

Várias utilidades de ajuda.

vcs

Abstração do sistema de controle de versão.

wladmin

Personalização da interface administrativa do Django.

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.

Internos das tarefas de fundo do Celery

Dica

Esta secção descreve tarefas internas do Celery. Tarefas de fundo a usar o Celery descreve como configurar o Celery para executar as tarefas.

O Weblate utiliza o Celery para executar tarefas no plano de fundo. Algumas tarefas são ativadas por um evento, e outras tarefas são ativadas por agendamentos.

O Celery Beat é usado para agendar tarefas, e django-celery-beat é usado para armazenar a tarefa de agendamento periódica na base de dados. O agendamento de tarefas é configurado em tasks.py em cada uma das aplicações Django.

As tarefas são consumidas usando várias filas; o encaminhamento é configurado em settings.py. As filas foram concebidas para separar diferentes tipos de carga de trabalho:

celery

A fila predefinida onde tarefas de plano de fundo são processadas.

notify

Entrega emails de notificação, tanto quanto para eventos do Weblate como autenticação ou registo. Isto é uma fila separada para tornar o envio de email suave mesmo que haja um acumular de outras tarefas.

memory

Atualiza entradas de memória de tradução. A fila de atualização pode ser comprida ao importar novas cadeias de carateres, e processamento demorado não significa muito aqui, por isso haver uma fila separada evita o bloqueio de outras tarefas.

backup

As tarefas de cópia de segurança não podem ser executadas em paralelo, e um trabalhador individual dedicado torna isto mais fácil.

translate

Sabe-se que tarefas de tradução automática demoram muito tempo porque recorrem a serviços externos.