Complementos

Add-ons provide ways to customize and automate the translation workflow. Admins can add and manage add-ons from the Operations ↓ Add-ons menu of each respective translation project or component. Add-ons can be also installed site-wide in Interface de gerenciamento.

Dica

Você também pode configurar complementos usando API, DEFAULT_ADDONS ou install_addon.

Add-ons that opt in to manual triggering can be run from add-on management or using the API. Results are recorded in the add-on activity log.

Add-ons that expose a component API show its base URL on the add-on’s API tab, alongside a link to the API root.

Add-ons can show Integration instructions above their settings. These explain how to connect your application or service to the add-on. Add-ons without configurable settings, such as CDN de arquivos de tradução, show instructions without a settings form. Generated URLs and integration snippets are available after installation.

Add-ons are persistent administrative configuration. They run with their service identity in the scope where they are installed, rather than repeatedly using the permissions of the administrator who configured them. This ensures that equally authorized administrators see and save the same configuration, and that saving an unrelated change does not silently alter the add-on’s input scope. Removing or disabling the configuring administrator does not disable the add-on.

Project and category add-ons therefore include compatible restricted components in that scope. A component add-on can use inputs outside its destination component when documented by that add-on. Automatic translation determines its source components as follows:

  • Direct automatic-translation actions use the acting user’s component access.

  • A saved automatic-translation add-on uses its persistent administrative scope. Compatible components in the target project are eligible, including restricted components.

  • Components in another project are eligible when that project contributes to shared translation memory. This includes restricted components even though they do not create shared translation-memory entries; the add-on reads the explicitly selected component as an administrative input instead.

Restricted components remain filtered from ordinary listings and direct access for users without an explicit grant or Edit project settings permission. Grant add-on management permissions only to users trusted with the add-on’s complete input and effect scope. See Âmbito das equipes and Acesso restrito.

Repository add-ons, including Descoberta de componente, can be installed only on the component that owns the repository. Linked components show installed repository add-ons as inherited. Their available add-on list links to the owning component’s add-ons when you can manage it; otherwise the entry is unavailable.

../_images/addons.webp

Eventos que acionam complementos

Instalação de complemento

Acionado quando um complemento está sendo instalado.

Atualização do componente

Acionado sempre que ocorre uma alteração em um componente, por exemplo:

  • Textos são adicionados no repositório.

  • Um texto é adicionado.

  • Uma nova tradução é adicionada.

Diário

Acionado diariamente, mas os complementos geralmente dividem a carga diária entre os componentes, dependendo de BACKGROUND_TASKS.

Alteração de evento

Acionado depois que um evento de alteração é criado.

Manual trigger

Triggered when an add-on is run manually from add-on management or the API.

Pós-adição do repositório

Acionado logo após a nova tradução ser adicionada e o commit ser feito.

Pós-commit do repositório

Acionado logo após as alterações terem seu commit feito.

Pós-push do repositório

Acionado logo após o repositório ter o push feito para o upstream.

Repository post-remove

Triggered just after a translation is removed.

Pós-atualização do repositório

Acionado sempre que novas alterações forem trazidas do repositório upstream.

Pré-commit do repositório

Acionado imediatamente antes de as alterações terem seu commit feito.

Pré-push do repositório

Acionado imediatamente antes do repositório ter seu push feito para o upstream.

Pré-atualização do repositório

Acionado imediatamente antes da tentativa de atualização do repositório.

Pós-salvamento da unidade

Acionado logo após o texto ser salvo.

Unit post-sync

Triggered after the string is synchronized with the VCS.

Pré-criação da unidade

Acionado logo após o texto recém-criado ser salvo.

Complementos integrados

Avaliação da qualidade da IA

ID do complemento:

weblate.ai.quality

Configuração:

service

Serviço de avaliação

Escolhas disponíveis:

anthropic

Anthropic

openai

OpenAI

mistral

Mistral

ollama

Ollama

azure-openai

Azure OpenAI

q

Consulta

interval

Frequência de avaliação

Escolhas disponíveis:

disabled

Desativado

daily

Diário

weekly

Semanalmente

monthly

Mensal

on_change

Avaliar alterações de tradução

on_update

Avaliar atualizações do repositório

Gatilhos:

Instalação de complemento, Atualização do componente, Diário, Alteração de evento, Manual trigger

Avalia traduções existentes utilizando uma LLM e registra verificações de qualidade.

This add-on evaluates existing translations using an LLM service configured under Sugestões automáticas. It does not generate suggestions or change translations. Choose an Evaluation service from the configured LLM services; credentials and project overrides are reused.

The Query selects strings using the normal search syntax. By default, translated strings are selected. Source strings, read-only strings, and glossary entries are excluded. Each request includes all translation plural forms, source text, language information, string context, glossary terms, placeholders, and configured translation instructions. This data is sent to the selected provider.

Requests group strings from the same translation in file order, using the service’s automatic translation batch size (currently 20 strings for built-in LLM services). All plural forms of a string stay together. Related strings share context, allowing the evaluator to check meaning and terminology across the batch. Batching reduces the number of provider requests for scheduled, manual, and change-triggered runs; it does not skip unchanged strings.

Evaluation frequency defaults to weekly. Daily and monthly schedules are also available; disabled turns off scheduled evaluation. Background processing must be enabled. A successful full run starts the next interval. Manual runs bypass the interval. Enable Evaluate translation changes or Evaluate repository updates to additionally evaluate after those events. Installation does not immediately contact the provider. Each run can incur provider costs, including reevaluation of unchanged translations.

Evaluation runs in background tasks, with results and failure counts recorded in the existing add-on activity log. Failed requests retain existing valid findings and are tried again only by a subsequent run. Evaluation shares the service’s automatic translation cooldown: rate-limit responses activate it, and batches are skipped while it is active. More specific installations take precedence: component, nearest category, project, then site-wide.

Findings appear as standard checks for accuracy, fluency, terminology, style, and formatting. Each finding includes a minor, major, or critical severity and an explanation. Multiple findings in one category share a check, so ignoring that check ignores the whole category for the string. Existing search filters and API search work, for example check:ai_accuracy. Translation flags such as ignore-ai-accuracy disable a category; ignore-all-checks disables all checks.

Changing the source or translation removes outdated findings. Results received after any source or translation in their batch changes are discarded for the whole batch. A failed or malformed response also leaves existing findings for the whole batch unchanged; other batches can still complete. Incomplete runs do not advance the scheduled evaluation date. Reevaluation of unchanged content preserves ignored categories, and a successful evaluation removes categories that no longer have findings. Removing or reconfiguring the add-on clears its findings. Evaluator metadata is internal and cannot be edited through the API; the add-on configuration uses the existing Complementos permissions and validation.

Automação

Adicionado na versão 2026.10.

ID do complemento:

weblate.automation.automation

Configuração:

workflow

Fluxo de trabalho

Insira uma definição de automação em YAML ou JSON.

Gatilhos:

Atualização do componente, Diário, Alteração de evento, Manual trigger, Pós-commit do repositório, Pós-push do repositório, Pós-atualização do repositório

Executa operações de tradução ordenadas com condições e ramificações.

Install this add-on on a component, category, project, or site. Inherited instances run separately for each component. Multiple instances can be installed. Configuring, previewing, and running an automation requires the usual add-on management permission. Saving its configuration does not execute it.

Enter YAML or JSON in Workflow. Use Preview without changes to validate it and inspect planned actions, then Run now for real execution. Results appear in the add-on activity log.

Ver também

Tradução automática

ID do complemento:

weblate.autotranslate.autotranslate

Configuração:

mode

Modo de tradução automática

Escolhas disponíveis:

suggest

Adicionar como sugestão

translate

Adicionar como tradução

fuzzy

Adicionar como “Necessita de edição”

approved

Adicionar como tradução aprovada

q

Consulta

Observe que a tradução de todos os textos descartará todas as traduções existentes.

auto_source

Fonte das traduções automáticas

Escolhas disponíveis:

others

Outros componentes da tradução

mt

Tradução automática

component

Componente

Enter a source component ID. With 30 or more eligible source components, a project/component path is also accepted. In that case, component and project operations also accept a component slug from the target project. Leave blank to use eligible components from each target component’s project.

engines

Serviços de tradução

Serviços de tradução

threshold

Limite de pontuação

Gatilhos:

Instalação de complemento, Atualização do componente, Diário, Alteração de evento

Traduz automaticamente os textos usando a tradução automática ou outros componentes.

To control translation order, use the Automação add-on with a separate action for each pass. Follow the Apply translation memory before machine translation cookbook example to apply local translation memory first and send only the remaining strings to a machine translation service. Selecting multiple engines here uses Prioridade dos serviços de tradução automática e memória de tradução; installation order of separate add-ons does not define an execution sequence.

CDN de localização do JavaScript

Adicionado na versão 4.2.

ID do complemento:

weblate.cdn.cdnjs

Configuração:

threshold

Limiar de tradução

A porcentagem de textos traduzidos que devem estar presentes para que a tradução seja incluída.

css_selector

Seletor CSS

Seletor CSS para detectar elementos localizáveis.

cookie_name

Nome do cookie de idioma

Nome do cookie que armazena preferência de idioma.

files

Extrair textos de arquivos HTML

Lista de nomes de arquivos em URLs atuais ou remotos para analisar para textos traduzíveis.

Gatilhos:

Instalação de complemento, Diário, Pós-commit do repositório, Repository post-remove, Pós-atualização do repositório

Publica traduções na rede de entrega de conteúdo para uso em localização de JavaScript ou de HTML.

Pode ser usado para localizar páginas HTML estáticas ou para carregar a localização no código JavaScript.

Generates a unique URL for your component you can include in HTML pages to localize them. See Traduzindo HTML e JavaScript usando CDN do Weblate for more details. Available languages and translation files are listed in the CDN manifest.

Nota

Esse complemento requer configuração adicional no servidor Weblate. LOCALIZE_CDN_PATH configura onde os arquivos gerados serão gravados (em um sistema de arquivos) e LOCALIZE_CDN_URL define onde eles serão servidos (URL). O serviço dos arquivos não é feito pelo Weblate e deve ser configurado externamente (normalmente usando um serviço CDN).

Esse complemento é configurado em Hosted Weblate e disponibiliza os arquivos via https://weblate-cdn.com/.

CDN de arquivos de tradução

Adicionado na versão 2026.5.

ID do complemento:

weblate.cdn.files

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Atualização do componente, Pós-commit do repositório, Repository post-remove, Pós-atualização do repositório

Publica arquivos de tradução em uma rede de entrega.

Publishes translation files without converting them to another format. Files are written below the add-on specific CDN directory and served from LOCALIZE_CDN_URL/<add-on UUID>/. Single-file translations use the language code and original file extension, for example cs.json or de.po. Multi-file translations are served below the language code using paths relative to the translation directory. Monolingual components include the source language file, while bilingual components publish only target-language files. See CDN de localização for secure serving guidance. Available languages and translation files are listed in the CDN manifest.

CDN do SDK Kotlin

Adicionado na versão 2026.10.

ID do complemento:

weblate.cdn.kotlin

Configuração:

maximum_age

Maximum build age (days)

Retires builds this many days after their first registration. Re-registering a build does not extend its age.

maximum_versions

Versões máximas retidas

Limits retained builds across all package names. A build is retired when either this limit or the maximum age is reached.

Gatilhos:

Instalação de complemento, Atualização do componente, Diário, Pós-commit do repositório, Repository post-remove, Pós-atualização do repositório

Publica recursos de texto e plural do Android para builds do SDK Kotlin registrados.

Aviso

The Kotlin SDK is available as an alpha release. No compatibility is guaranteed until the final Kotlin SDK is released. Endpoints, build metadata, CDN manifests, and generated resource formats may change without backward compatibility.

Install Kotlin SDK CDN on an Android string-resource component to publish translations for builds registered by the Kotlin SDK. Configure LOCALIZE_CDN_URL and LOCALIZE_CDN_PATH first. CDN output is public, including translations from private components. Manifests expose the application package name and version code. ARSC files expose published resource names and their submitted IDs alongside translated text. Do not treat the uploaded resource mapping as confidential; enable publication only when this disclosure is intended. Registration and status API access remains permission-controlled.

Installation offers to install CDN de arquivos de tradução by default so the SDK can also consume the original Android XML files. Existing Translation files CDN installations are reused. For existing Kotlin SDK installations, use Install Translation files CDN on the configuration page, then return to copy the updated Gradle configuration. Original files are also published publicly, including those from private components.

Copy the Gradle plugin configuration from the add-on configuration page. It includes the Weblate server URL, separate translationFiles and kotlinSdk public CDN URLs, project slug, and component path (with any category path URL-encoded). Replace the placeholder with a project-scoped API token whose permissions allow editing the component. Project administrators can create one in the project’s API access tab; see Tokens de acesso por projeto. Keep that token in the build environment, not in the application. The add-on’s API tab shows the API base URL; submit build metadata to its builds/ endpoint. See Kotlin SDK builds for the request and response format.

For Gradle plugin and library setup, see Kotlin SDK for Android.

The add-on matches resource names and types from registered builds to current component translations. Strings, plurals, and Android styled text are supported. String arrays and resource references are not generated. Untranslated entries, read-only entries, and incomplete plural resources are omitted; applications retain their bundled values. Unsupported styling fails publication; the previous successful publication remains available.

Resource IDs must describe the final installed build. Uploading an identical mapping again is harmless; a different mapping for the same package and version is rejected. Old builds receive current translations by name, including after source text or formatting arguments change. Maintainers are responsible for compatibility with older application code.

Lifecycle settings

  • Maximum build age (days) defaults to 365 and accepts 1 through 730, measured from the first registration. Repeated uploads do not extend it.

  • Maximum retained versions defaults to 20 and accepts 1 through 100, counted across all package names. One additional unpublished replacement is allowed. New registrations can retire older unpublished replacements. Published builds are retired for this limit only after a replacement is published. Failed replacements preserve existing publications; maximum-age expiry still applies independently.

Either limit retires a build and immediately clears its metadata. Lightweight retired records are deleted on cleanup after 24 hours and successful manifest removal; their package/version identifiers can then be registered again. Failed or interrupted manifest removals are retried hourly. Until removal succeeds, the registration and its referenced artifacts are retained, and the files may remain publicly accessible. Resource mappings are immutable only while their registration records remain.

Each add-on permits at most 1000 registration records, including retired records. New registrations exceeding this limit return HTTP 409 until cleanup frees capacity; identical retries remain accepted. Metadata is bounded by the 5 MiB upload limit and maximum retained version count plus one replacement, without a separate byte quota. Limits are enforced during registration and scheduled cleanup.

Superseded artifacts are deleted on cleanup after a fixed 24-hour window. All artifact files, including superseded files and incomplete publication output, count towards hard limits of 5 GiB and 10000 files per add-on. The larger artifact allowance accommodates translated text and multiple locales; it does not guarantee capacity for every locale or build combination. Shared artifacts count only once. Publications exceeding either limit fail before writing new artifacts and preserve the previous manifest. Neither the window nor these limits are configurable. Limit manifest caching as described below.

Compilation stages one locale at a time on disk. A per-locale conservative encoded text and styling estimate exceeding 64 MiB fails publication.

Preparation additionally requires up to 5 GiB of temporary disk space per publication job, separate from the published artifact allowance. Temporary files contain staged ARSC output, shared by versions with identical resource mappings. They are stored below LOCALIZE_CDN_PATH. Configure the server to deny access to .kotlin-sdk-staging as described in CDN de localização before enabling this add-on.

Manifest replacement follows the database commit. Failed or interrupted writes are retried by subsequent publication jobs, with artifacts for both the old and pending manifest protected until replacement succeeds.

Uninstalling the add-on attempts to remove its published files from the CDN origin immediately. Failed or interrupted removals are retried hourly; files may remain publicly accessible until cleanup succeeds. Removal does not revoke copies already cached or downloaded by clients.

Publication and cleanup run asynchronously after build registration, component updates, translation commits and removals, and during daily add-on processing. Failures appear in the add-on activity log and registration status. Previous successful publications remain available when replacement generation fails. If the component stops using the Android resource format, hourly maintenance retires its publications. The normal artifact retention window still applies.

CDN client contract

Each build has a stable manifest at <CDN base>/<packageName>/<versionCode>/manifest.json. The version 1 manifest contains schemaVersion, packageName, versionCode, and locales. Locale keys are Weblate language codes. Each locale contains a relative url, sha256, and byte size for its ARSC artifact. Resolve relative URLs against the manifest URL. Artifact contents do not change after publication. The manifest has a JSON Schema.

Configure the CDN origin to cache manifests for at most one hour (for example, Cache-Control: public, max-age=3600), and artifact files with Cache-Control: public, max-age=31536000, immutable. Artifact files may use application/octet-stream. Configure these headers on the CDN server. Translation updates and retirements can take up to one hour to reach clients. Use Cache-Control: no-cache when immediate revalidation is preferred. The fixed 24-hour artifact retention window exceeds the manifest cache lifetime.

The Kotlin SDK should validate artifact length and hash, cache successful downloads locally, and load them with Android’s resources-loader API on API 30 or newer. A missing manifest, missing locale, or download failure must preserve bundled resources. Retired manifests return 404 at the origin; cached copies can remain usable until they expire. Hashes detect corrupted or mismatched content; authentication relies on HTTPS and the configured CDN.

Remover textos vazios

Adicionado na versão 4.4.

ID do complemento:

weblate.cleanup.blank

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Pós-commit do repositório, Pós-atualização do repositório

Remove textos não traduzidos dos arquivos de tradução.

Use isso para não ter textos vazios em arquivos de tradução (por exemplo, se sua biblioteca de localização os exibe como em falta em vez de recorrer ao texto fonte).

Limpar arquivos de tradução

ID do complemento:

weblate.cleanup.generic

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Pós-atualização do repositório, Pré-commit do repositório

Atualiza todos os arquivos de tradução para corresponder ao arquivo base monolíngue. Para a maioria dos formatos isto significa remover chaves de tradução obsoletas que não estão mais presentes no arquivo base.

Para formatos que contêm conteúdo adicional além dos textos de tradução (como Arquivos HTML, Arquivos RC do Windows ou Formato OpenDocument), isso também sincroniza o arquivo de tradução com o arquivo base.

For a one-time cleanup of a single translation file, use Cleanup unused in Manutenção do repositório on that translation instead of installing the add-on.

Adicionar idiomas em falta

ID do complemento:

weblate.consistency.languages

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Diário, Pós-adição do repositório

Garante que um conjunto consistente de idiomas seja usado para todos os componentes de um projeto.

Nota

The components shared from other projects are not considered in this.

Os idiomas ausentes são verificados uma vez a cada 24 horas e quando novos idiomas são adicionados no Weblate.

Ao contrário da maioria dos outros, esse complemento afeta todo o projeto.

Dica

Traduza automaticamente os textos recém-adicionados com Tradução automática.

Descoberta de componente

ID do complemento:

weblate.discovery.discovery

Configuração:

File matching

match

Expressão regular para corresponder aos arquivos de tradução

A expressão regular deve definir um grupo nomeado para o componente. Defina também um grupo nomeado para o idioma ao corresponder a arquivos de tradução. Quando a máscara de arquivo estiver definida, omita o idioma e corresponda ao arquivo base monolíngue ou ao novo arquivo base.

file_format

Formato de arquivo

Formato de arquivo

language_regex

Filtro de idioma

Expressão regular para filtrar arquivos de tradução ao examinar por uma máscara de arquivo.

Component naming and file templates

name_template

Personalizar nome do componente

Use a sintaxe de modelo do Django. Esse modelo deve incluir {{ component }}.

base_file_template

Defina o nome do arquivo base monolíngue

Deixe vazio para arquivos de tradução bilíngues. Quando definido, este modelo deve incluir {{ component }}.

new_base_template

Definir o arquivo base para novas traduções

Nome do arquivo usado para criar novas traduções. Para gettext escolha o arquivo .pot. Este modelo deve incluir {{ component }}.

intermediate_template

Arquivo de idioma intermediário

Nome do arquivo de tradução intermediária. Na maioria dos casos, este é um arquivo de tradução fornecido por desenvolvedores e é usado ao criar textos fontes reais. Este modelo deve incluir {{ component }}.

filemask_template

Defina a máscara de arquivos

Deixe em branco para que a tradução corresponda diretamente aos arquivos de tradução. Quando configurado, o recurso de descoberta corresponde ao arquivo base monolíngue ou ao novo arquivo base e usa este modelo como máscara de arquivo. Inclua um caractere curinga de idioma e {{ componente }}, por exemplo, localidade//{{ componente }}.po ou docs/{{ componente }}_.md.

Component lifecycle

copy_addons

Clonar complementos do componente principal para as recém-criadas

remove

Remova componentes para arquivos inexistentes

Gatilhos:

Instalação de complemento, Pós-atualização do repositório

Adiciona ou remove automaticamente componentes do projeto com base nas alterações de arquivo no sistema de controle de versão.

The matching is done using regular expressions enabling complex configuration, but some knowledge is required to do so. Usually the regular expression to match translation files has to contain two named groups to match component and language. When creating components from a monolingual base or new base file, omit the language group and match that source file instead. All named groups in the regular expression can be used as variables in the template fields.

Discovery requirements

To discover a component successfully, the configuration has to do all of the following:

  • The regular expression must define a component named group. Matching translation files also requires a language named group.

  • Template fields used to name or locate per-component files must include {{ component }}, so the rendered value actually changes for each discovered component.

  • For monolingual formats, the component must contain a file matching base_file_template and at least one translation file matching match, unless you set the file mask (see below).

Discovering components without translation files

Set Define the file mask to discover components from a monolingual base or new base file alone, even when no translation files exist yet. In that mode:

  • Configure Regular expression to match translation files against to match the monolingual base or new base file, and omit the language group. Keep full control over the component capture, for example locale/(?P<component>[^/]+)\.pot or docs/(?P<component>[^/_]+)\.md.

  • Fill Define the file mask with a path that includes both a language wildcard and {{ component }}, for example locale/*/{{ component }}.po or docs/{{ component }}_*.md.

  • Keep using the other filename templates with any named groups from the match expression.

Worked example: news_<lang>.md

This is a common filename-based language variant layout:

  • docs/news_en.md

  • docs/news_cs.md

  • docs/guide_en.md

Use the Filename-based language variants preset for a starting point, then choose the matching file format and review the populated values.

Expressão regular:

(?:(?P<path>.*/))?(?P<component>.+?)_(?P<language>[A-Za-z]{2,3}(?:[_-][A-Za-z0-9]+)*)\.(?P<extension>[^/.]+)

Nome do componente:

{{ component }}

Discovered file masks:
  • docs/news_*.md

  • docs/guide_*.md

In this example, {{ component }} resolves to the basename before the language suffix, so docs/news_en.md, docs/news_pt_BR.md, and docs/news_pt-BR.md all become the news component.

Você pode usar a marcação do template Django em todos os campos de nome de arquivo, por exemplo:

{{ component }}

Component name parsed from the component match group

{{ component|title }}

Nome do arquivo do componente com a primeira letra em maiúscula

{{ path }}: {{ component }}

Grupo de correspondência personalizado da expressão regular

Uma vez que você acertar Salvar, uma prévia dos componentes correspondentes será apresentada, de onde você pode verificar se a configuração realmente corresponde às suas necessidades:

../_images/addon-discovery.webp

Exemplos de descoberta de componentes

The worked example above covers the most common filename-based variant layout. The following examples show other repository structures you can match.

Uma pasta por idioma

Uma pasta por idioma contendo arquivos de traduções para componentes.

Expressão regular:

(?P<language>[^/.]*)/(?P<component>[^/]*)\.po

Arquivos correspondentes:
  • cs/application.po

  • cs/website.po

  • de/application.po

  • de/website.po

Layout de localidades gettext

Estrutura usual para armazenar arquivos PO.

Expressão regular:

locale/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

Arquivos correspondentes:
  • locale/cs/LC_MESSAGES/application.po

  • locale/cs/LC_MESSAGES/website.po

  • locale/de/LC_MESSAGES/application.po

  • locale/de/LC_MESSAGES/website.po

Nomes de arquivos complexos

Usando ambos componente e nome do idioma no nome do arquivo.

Expressão regular:

src/locale/(?P<component>[^/]*)\.(?P<language>[^/.]*)\.po

Arquivos correspondentes:
  • src/locale/application.cs.po

  • src/locale/website.cs.po

  • src/locale/application.de.po

  • src/locale/website.de.po

Código de idioma repetido

Usando idioma em ambos caminho e nome do arquivo.

Expressão regular:

locale/(?P<language>[^/.]*)/(?P<component>[^/]*)/(?P=language)\.po

Arquivos correspondentes:
  • locale/cs/application/cs.po

  • locale/cs/website/cs.po

  • locale/de/application/de.po

  • locale/de/website/de.po

Dividir textos do Android

Textos de recurso do Android, divididos em vários arquivos.

Expressão regular:

res/values-(?P<language>[^/.]*)/strings-(?P<component>[^/]*)\.xml

Arquivos correspondentes:
  • res/values-cs/strings-about.xml

  • res/values-cs/strings-help.xml

  • res/values-de/strings-about.xml

  • res/values-de/strings-help.xml

Combinando vários caminhos

Projeto Maven multimódulo com traduções de propriedades Java.

Expressão regular:

(?P<originalHierarchy>.+/)(?P<component>[^/]*)/src/main/resources/ApplicationResources_(?P<language>[^/.]*)\.properties

Nome do componente:

{{ originalHierarchy }}: {{ component }}

Arquivos correspondentes:
  • parent/module1/submodule/src/main/resources/ApplicationResources_fr.properties

  • parent/module1/submodule/src/main/resources/ApplicationResource_es.properties

  • parent/module2/src/main/resources/ApplicationResource_de.properties

  • parent/module2/src/main/resources/ApplicationResource_ro.properties

Dica

Component discovery add-on uses URLs internas do Weblate. It’s a convenient way to share VCS setup between multiple components. Linked components use the local repository of the main component set up by filling weblate://project/main-component into the Repositório do código-fonte field (in Operations ↓ Settings ↓ Version control system) of each respective component. This saves time with configuration and system resources too.

Dica

Certifique-se de que o novo componente contenha o conjunto completo de idiomas traduzíveis com Adicionar idiomas em falta.

Mensagens do Fedora

Adicionado na versão 5.15.

ID do complemento:

weblate.fedora_messaging.publish

Configuração:

Broker connection

amqp_url

URL do broker AMQP

A URL do broker AMQP para se conectar.

topic_prefix

Prefixo do tema

Prefixo opcional para adicionar aos temas das mensagens geradas.

Timeouts and retries

publish_timeout

Tempo limite de publicação

Por quantos segundos aguardar o reconhecimento de entrega do agente.

connection_attempts

Tentativas de conexão

Número de tentativas de conexão com o agente.

retry_delay

Tempo mínimo para uma nova tentativa

Quantos segundos aguardar entre tentativas de conexão.

TLS credentials

ca_cert

Pacote de certificados CA (PEM)

Cole apenas blocos de certificado PEM, cada um começando com “—–BEGIN CERTIFICATE—–” e terminando com “—–END CERTIFICATE—–“.

client_key

Chave privada do cliente (PEM)

Cole um único bloco de chave privada PEM não criptografado. Chaves privadas criptografadas não são suportadas.

client_cert

Certificado do cliente (PEM)

Cole apenas o bloco do certificado PEM que começa com “—–BEGIN CERTIFICATE—–”; não cole a saída de “openssl x509 -text”.

Event selection

event_filter

Eventos de alteração para acionar

Choose which change events should trigger this add-on. Eventos de alteração para acionar

events

Eventos de alteração selecionados

Eventos de alteração selecionados

Gatilhos:

Alteração de evento

Envia notificações para um servidor AMQP compatível com o Mensagens do Fedora.

Fedora Messaging é um editor baseado em AMQP para todas as mudanças que acontecem no Weblate. Você pode conectar serviços adicionais nas mudanças que acontecem no Weblate usando isso.

Configure the broker with a plain amqp:// or amqps:// URL, including its virtual host. URL query strings and fragments are not supported. Use the add-on’s connection attempts, retry delay, and publish timeout fields instead. The publish timeout covers connection attempts, retry delays, and broker confirmation. Publishing resolves DNS when opening a connection and reuses the existing connection without further DNS lookups. Resolved addresses and the connected peer are checked against the configured private-network restrictions. Synchronous DNS resolution cannot be interrupted by the publish timeout and can exceed it when the system resolver is slow or unavailable. Rejected messages are not retried.

Weblate reuses a publisher connection in each worker process, with AMQP heartbeats disabled. Failed connections are discarded and recreated on the next attempt. A lost broker confirmation can cause duplicate delivery; consumers can identify retries by their unchanged message ID.

Message topic

All messages have topic weblate.<action>.<project>.<category...>.<component>.<translation>. When configured, topic_prefix is prepended to this topic using a single dot separator, for example org.fedoraproject.weblate.project_backed_up.website. The action is lowercase textual representation of action with underscores instead of space, for example resource_updated; see Eventos de alteração selecionados for all action identifiers. The remaining parts match Weblate object path segments.

For example, a project backup event for the website project uses weblate.project_backed_up.website. A translation change in the website project, frontend component, and Czech translation uses weblate.translation_changed.website.frontend.cs. The same change in the frontend component inside the parent and child categories uses weblate.translation_changed.website.parent.child.frontend.cs.

Message body

The body consists of following fields (given that they are available for the event):

change_id

ID numérico da alteração

action

Verbose name of the change.

timestamp

Registro de data/hora em formato ISO

target

Novo valor da alteração (por exemplo, nova tradução do texto)

old

Valor antigo da alteração (por exemplo, tradução anterior do texto)

source

Source string.

url

Absolute URL to view the related object.

author

Nome de usuário do autor (pode ser diferente do usuário, por exemplo, ao aceitar sugestões)

user

Acting username

project

Slug da URL do projeto

component

Slug do componente

translation

Código de idioma de tradução

Message headers

There are additional headers which you might utilize for routing as well:

action

Verbose name of the change.

project

Slug da URL do projeto

component

Slug do componente

Example messages

Repository merge event:

{
  "id": 1,
  "action": "Merged repository",
  "timestamp": "2017-06-15T11:30:47.325000+00:00",
  "url": "http://example.com/projects/test/test/",
  "component": "test"
}

New source string event:

{
  "id": 2,
  "action": "New source string",
  "timestamp": "2017-06-15T11:30:47.372000+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Resource update event:

{
  "id": 6,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.410000+00:00",
  "url": "http://example.com/projects/test/test/cs/",
  "project": "test",
  "component": "test",
  "translation": "cs"
}
{
  "id": 7,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.510000+00:00",
  "url": "http://example.com/projects/test/test/de/",
  "project": "test",
  "component": "test",
  "translation": "de"
}
{
  "id": 8,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.595000+00:00",
  "url": "http://example.com/projects/test/test/it/",
  "project": "test",
  "component": "test",
  "translation": "it"
}

Project removal event:

{
  "id": 9,
  "action": "Removed project",
  "timestamp": "2019-10-17T15:57:08.559420+00:00",
  "target": "test",
  "user": "testuser"
}

New contributor event:

{
  "id": 11,
  "action": "New contributor",
  "timestamp": "2019-10-17T15:57:08.759960+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

New translation event:

{
  "id": 12,
  "action": "New translation",
  "timestamp": "2019-10-17T15:57:08.772591+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "target": ["Ahoj svete!\n"],
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Editor em massa

ID do complemento:

weblate.flags.bulk

Configuração:

q

Consulta

search_type

Tipo de pesquisa

Escolhas disponíveis:

text

Texto

regex

Expressão regular

search

Buscar texto

Case-sensitive text or regular expression to replace in matching strings. Leave empty to disable replacement.

replacement

Substituição do texto

Leave empty to remove matching text. In regular expression mode, use 1 for the first captured group. Named group references are also supported.

state

Status a definir

Escolhas disponíveis:

-1

Não alterar

0

Vazio

10

Necessita de edição

11

Necessita de edição (Precisa ser editado)

12

Necessita de edição (Precisa ser verificado)

20

Traduzido

30

Aprovado

Source flags

Flags are set on the source strings corresponding to your filter results and apply to their translations in every language.

add_flags

Add flags

remove_flags

Remove flags

Translation flags

Flags apply only to translations matching your filter. Source strings are excluded.

add_translation_flags

Add flags

remove_translation_flags

Remove flags

Only flags set directly on these translations are removed. Inherited flags remain in effect.

Labels

Labels apply to the source strings corresponding to your filter results and are shared across all languages.

add_labels

Add labels

remove_labels

Remove labels

Gatilhos:

Instalação de complemento, Atualização do componente

Edite textos, sinalizadores, rótulos ou status de textos em massa.

Uses the operations described in Editor em massa, including literal or regular expression replacement and clearing translations. Runs process all eligible matching strings without interactive preview. See Edição em massa for replacement syntax and string state values.

Exemplos:

Rotula novos textos automaticamente

Solicitação de busca

NOT has:label

Labels: Add labels

recente

Marcar como somente leitura todos os textos do changelog de Arquivos de metadados da App Store

Solicitação de busca

language:en AND key:changelogs/

Translation flags: Add flags

read-only

Marcar como somente leitura determinados textos

Solicitação de busca

source:r"^\`\`[.a-zA-Z0-9_-]*\`\`$" AND language:en

Translation flags: Add flags

read-only

Marcar traduções não alteradas como “Precisa ser editado”

ID do complemento:

weblate.flags.same_edit

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Pré-criação da unidade

Sempre que um novo texto traduzível é importado do VCS e corresponde a um texto fonte, é marcado como “Precisa ser editado” no Weblate. Especialmente útil para formatos de arquivo que incluem textos fonte para textos não traduzidas.

Dica

Você também pode querer reforçar a verificação Tradução não alterada adicionando o marcador strict-same aos Marcadores de tradução.

Ver também

Status de tradução

Marcar novos textos fonte como “Necessita de edição”

ID do complemento:

weblate.flags.source_edit

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Pré-criação da unidade

Sempre que um novo texto fonte for importado do VCS, ele é marcado como “Precisa ser verificado” no Weblate. Desta forma você pode filtrar facilmente e editar os textos fontes escritos pelos desenvolvedores.

Ver também

Status de tradução

Marcar novas traduções como “Precisa ser editado”

ID do complemento:

weblate.flags.target_edit

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Pré-criação da unidade

Sempre que um novo texto traduzível for importado do VCS, ele é marcado como “Precisa ser editado” no Weblate. Desta forma você pode filtrar facilmente e editar as traduções criadas pelos desenvolvedores.

Ver também

Status de tradução

Marcar traduções alteradas do repositório como “Precisa ser editado”

ID do complemento:

weblate.flags.target_repo_update

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Unit post-sync

Sempre que a tradução de um texto for modificada do VCS, ela é marcada como “Precisa ser editado” no Weblate. Especialmente útil se os arquivos de traduções são atualizados manualmente ou por um serviço externo.

Ver também

Status de tradução

Preencher textos somente leitura com a fonte

Adicionado na versão 4.18.

ID do complemento:

weblate.generate.fill_read_only

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Atualização do componente, Diário

Preenche a tradução de textos somente leitura com o texto fonte.

Gerador de estatísticas

ID do complemento:

weblate.generate.generate

Configuração:

scope

Escopo de saída

Escolhas disponíveis:

translation

Um arquivo por tradução

component

Um arquivo por componente

filename

Nome do arquivo gerado

template

Conteúdo do arquivo gerado

Gatilhos:

Instalação de complemento, Atualização do componente, Pós-adição do repositório, Repository post-remove, Pré-commit do repositório

Gera um arquivo contendo as informações detalhadas sobre o status da tradução.

Você pode usar um modelo do Django, tanto de nome de arquivo e conteúdo, consulte Marcação de modelo para uma descrição detalhada de marcação.

Por exemplo, a geração de um arquivo de resumo para cada tradução:

Nome do arquivo gerado

locale/{{ language_code }}.json

Conteúdo
{
   "language": "{{ language_code }}",
   "strings": "{{ stats.all }}",
   "translated": "{{ stats.translated }}",
   "last_changed": "{{ stats.last_changed }}",
   "last_author": "{{ stats.last_author }}",
}

Component-wide output

Set Output scope to One file per component to maintain one locale list or statistics file for the entire component. The default, One file per translation, preserves existing configurations.

Component output is generated on installation and configuration changes. It is updated when translations are committed, languages are added or removed, and component files are reloaded. Language metadata changes are included on the next such update or when the add-on is reconfigured. Unchanged output does not create a new commit.

Both modes support component and project variables in filenames and content. In component mode, the content additionally receives translations, ordered by repository language code. Each item provides:

  • language_code: the language code used in the repository.

  • language_name: the English language name.

  • language_native_name: the name translated into its own language using Weblate’s catalogs, with an English fallback when unavailable.

  • language_direction: ltr or rtl.

  • filename and url: the translation filename and Weblate URL.

  • is_source: whether this is the component’s source translation.

  • stats: the same statistics available in translation mode.

The source translation is included. Templates can exclude it using {% if not item.is_source %}. Statistics use Weblate’s completion semantics. Custom language names are retained; there is no external locale-data lookup.

For example, generate locales.json for a website:

[
{% for item in translations %}
  {
    "code": {{ item.language_code|json }},
    "file": {{ item.filename|json }},
    "name": {{ item.language_native_name|json }},
    "dir": {{ item.language_direction|json }}
  }{% if not forloop.last %},{% endif %}
{% endfor %}
]

Or generate languages.py for an application:

names = {
{% for item in translations %}
    {{ item.language_code|python }}: {{ item.language_native_name|python }},
{% endfor %}
}
completeness = {
{% for item in translations %}
    {{ item.language_code|python }}: {{ item.stats.translated_percent|python }},
{% endfor %}
}

The json and python filters serialize complete values, including string quotes and escaping. Do not add quotes around their output. They also support lists and dictionaries; {{ translations|json }} exports all available data. Dates and times are serialized as ISO-formatted strings.

Ver também

Marcação de modelo

Preencher tradução com fonte

Adicionado na versão 4.11.

ID do complemento:

weblate.generate.prefill

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Atualização do componente, Diário

Preenche textos de tradução com texto fonte.

All untranslated strings in the component will be filled with the source string, and marked as needing edit. Use this when you can not have empty strings in the translation files. .. AUTOGENERATED START: weblate.generate.pseudolocale .. This section is automatically generated by ./manage.py list_addons. Do not edit manually.

Geração de pseudolocalidade

Adicionado na versão 4.5.

ID do complemento:

weblate.generate.pseudolocale

Configuração:

Source and target

source

Textos fonte

include_readonly

Incluir textos somente leitura

target

Tradução alvo

Todos os textos nesta tradução serão substituídos

Prepended text

prefix

Texto estático anexado

var_prefix

Texto da variável anexado

Appended text

suffix

Texto estático acrescentado

var_suffix

Texto da variável acrescentado

Text expansion

var_multiplier

Multiplicador de texto variável

Quantas vezes repetir o texto da variável, dependendo do comprimento do texto fonte.

Gatilhos:

Instalação de complemento, Atualização do componente, Diário

Gera uma tradução adicionando prefixo e sufixo de textos fonte automaticamente.

Pseudolocalidades são úteis para encontrar textos que não estão preparados para localização. Isso é feito alterando todos os textos fonte traduzíveis para facilitar a descoberta de textos inalterados ao executar o aplicativo no idioma da pseudolocalidade.

Também é possível encontrar textos cujas contrapartes localizadas podem não se ajustar ao layout.

O uso das partes variáveis torna possível buscar por textos que podem não caber na interface do usuário após a localização - elas estendem o texto com base no comprimento do texto fonte. Os textos variáveis são repetidos pelo comprimento do texto multiplicado pelo multiplicador. Por exemplo Hello world com texto variável _ e multiplicador variável de 1 se torna Hello world___________ - o texto é repetido uma vez para cada caractere no texto fonte.

Os textos serão gerados usando o seguinte padrão:

Texto estático prefixado Texto variável prefixado Texto fonte Texto variável pós-fixado Texto estático como pós-fixado

Dica

Você pode usar idiomas reais para teste, mas existem pseudolocalidades disponíveis no Weblate - en_XA e ar_XB.

Dica

Você pode usar esse complemento para iniciar a tradução para uma nova localidade de um idioma existente ou idioma semelhante. Depois de adicionar a tradução ao componente, siga para o complemento. Exemplo: Se você tem fr e deseja iniciar a tradução fr_CA, simplesmente defina fr como fonte,` fr_CA` como o destino e deixe o prefixo e o sufixo em branco.

Desinstale o complemento depois de preencher a nova tradução para evitar que o Weblate altere as traduções feitas após a cópia.

Atualizar variável ALL_LINGUAS no arquivo “configure”

ID do complemento:

weblate.gettext.configure

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Diário, Pós-adição do repositório, Repository post-remove

Atualiza a variável ALL_LINGUAS nos arquivos “configure”, “configure.in” ou “configure.ac” quando uma tradução for adicionada ou removida.

Updates the ALL_LINGUAS variable in configure, configure.in or any configure.ac files, when a translation is added or removed.

Personalizar saída do gettext

Removido na versão 5.13: Replaced by Parâmetros de formato de arquivo.

Atualizar modelo de gettext (Django)

Adicionado na versão 5.17.

ID do complemento:

weblate.gettext.django

Configuração:

interval

Atualizar frequência

Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.

Escolhas disponíveis:

daily

Diário

weekly

Semanalmente

monthly

Mensal

normalize_header

Normalizar cabeçalho POT

Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.

location_mode

Local da fonte

Escolha como a extração grava os locais de origem no arquivo POT. Use esta opção para manter os locais no modelo, omitindo-os dos arquivos PO traduzidos.

Escolhas disponíveis:

file

Usar configurações de formato de arquivo

keep

Extrair locais para o arquivo POT

omit

Não extrair locais

Gatilhos:

Instalação de complemento, Manual trigger, Pós-atualização do repositório

Atualiza o modelo gettext usando o comando makemessages integrado do Django.

This add-on updates the template configured in Modelo para novas traduções. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Atualizar arquivos PO para corresponder ao POT (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Django requirements

This add-on requires xgettext and msguniq. It runs Weblate’s internal extraction wrapper for Django messages instead of invoking a project’s manage.py makemessages, so it does not load project Django settings or applications.

The template for new translations must use the django or djangojs domain. Supported template names are django.pot, djangojs.pot, django.po, and djangojs.po. Weblate infers the source directory from the template path and skips repository locale directories while extracting.

Atualizar arquivo LINGUAS

ID do complemento:

weblate.gettext.linguas

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Diário, Pós-adição do repositório, Repository post-remove

Atualiza o arquivo LINGUAS quando uma tradução for adicionada ou removida.

Atualizar arquivo POT (Meson)

Adicionado na versão 5.17.

ID do complemento:

weblate.gettext.meson

Configuração:

Update behavior

interval

Atualizar frequência

Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.

Escolhas disponíveis:

daily

Diário

weekly

Semanalmente

monthly

Mensal

normalize_header

Normalizar cabeçalho POT

Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.

location_mode

Local da fonte

Escolha como a extração grava os locais de origem no arquivo POT. Use esta opção para manter os locais no modelo, omitindo-os dos arquivos PO traduzidos.

Escolhas disponíveis:

file

Usar configurações de formato de arquivo

keep

Extrair locais para o arquivo POT

omit

Não extrair locais

Meson preset

preset

Predefinição do Meson

Predefinição de argumento xgettext nativo que corresponde à integração com o gettext do Meson. A predefinição GLib adiciona as opções de palavra-chave e sinalizador de formato usadas pelo auxiliar gettext do Meson.

Escolhas disponíveis:

glib

GLib

Comment extraction

comment_mode

Comentários do código

Selecione se o xgettext deve extrair nenhum, todos ou apenas os comentários marcados com uma tag específica.

Escolhas disponíveis:

off

Não extrair comentários

all

Extrair todos os comentários

tagged

Extrair comentários com tag

comment_tag

Tag do comentário

Tag passada para o xgettext para extração de comentários ao usar o modo de comentário taggeado.

Keywords

keyword

Palavras-chave adicionais

Palavras-chave extras separadas por nova linha passadas para xgettext usando –keyword.

keyword_exclusive

Usar palavras-chave exclusivamente

When enabled, passes --keyword without a value to xgettext before the additional keyword, disabling all default keywords so that only the keyword specified above is recognized.

Checks and ITS data

checks

Verificações do xgettext

Validação adicional do xgettext a habilitar para mensagens extraídas.

Escolhas disponíveis:

ellipsis-unicode

ellipsis-unicode

space-ellipsis

space-ellipsis

quote-unicode

quote-unicode

bullet-unicode

bullet-unicode

data_dirs

Diretórios de dados ITS

Diretórios relativos ao repositório, separados por nova linha, que contêm um subdiretório “its”, por exemplo, “po” para “po/its”. Os diretórios anteriores têm precedência sobre os diretórios posteriores e as regras agrupadas.

Gatilhos:

Instalação de complemento, Manual trigger, Pós-atualização do repositório

Atualiza o modelo gettext usando as convenções xgettext do Meson.

This add-on updates the template configured in Modelo para novas traduções. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Atualizar arquivos PO para corresponder ao POT (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Meson requirements

This add-on requires xgettext; it does not invoke Meson. It follows Meson gettext conventions by reading POTFILES or POTFILES.in from the gettext directory and passing the GLib keyword and format-flag preset to xgettext.

The gettext directory is the directory containing the template configured in Modelo para novas traduções. It must contain meson.build and POTFILES or POTFILES.in. A Meson project meson.build must be present in that directory or one of its parent directories. If both POTFILES and POTFILES.in exist, POTFILES is used. An adjacent POTFILES.skip excludes listed source files from extraction.

Configure this add-on from the existing Meson gettext setup. In most Meson projects, the gettext directory is po/, the template is named after the gettext domain, and po/meson.build calls Meson’s gettext helper. Use the same template path in Modelo para novas traduções, for example po/example.pot, and keep POTFILES or POTFILES.in next to that meson.build file.

Weblate does not read the source file list from meson.build. It uses POTFILES or POTFILES.in, matching Meson’s gettext convention. When the Meson project uses a non-default gettext directory or domain, mirror that layout in the component template path.

Gerar arquivos MO

ID do complemento:

weblate.gettext.mo

Configuração:

path

Caminho do arquivo MO gerado

Se não for especificado, o local do arquivo PO será usado.

fuzzy

Incluir textos que necessitam de edição

Textos que necessitam de edição (fuzzy) normalmente não estão prontos para serem usados como traduções.

Gatilhos:

Pré-commit do repositório

Gera automaticamente um arquivo MO para cada arquivo PO alterado.

O local do arquivo MO gerado pode ser personalizada e o campo para ele usa Marcação de modelo.

Nota

Se uma tradução for removida, seu arquivo PO será excluído do repositório, mas o arquivo MO gerado por esse complemento não será. O arquivo MO deve ser removido manualmente do upstream.

Atualizar arquivos PO para corresponder ao POT (msgmerge)

Alterado na versão 5.13: Settings configuration has been moved to Parâmetros de formato de arquivo.

ID do complemento:

weblate.gettext.msgmerge

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Pós-atualização do repositório

Atualiza todos os arquivos PO (conforme configurado por “File mask”) para corresponder ao arquivo POT (conforme configurado por “Modelo para novas traduções”) usando msgmerge.

This add-on is essential when working with gettext PO files where the POT (template) file is updated with new strings or changes to existing strings. When the POT file is updated in the repository, this add-on automatically merges those changes into all language PO files, ensuring that:

  • New translatable strings appear in all languages

  • Textos removidos são marcados como obsoletos

  • Modified strings are marked as needing review (fuzzy)

Most msgmerge command-line options can be set up through file format parameters configuration. Enable the po_remove_obsolete parameter to remove obsolete #~ entries when PO files are saved.

Atualizar arquivo POT (Sphinx)

Adicionado na versão 5.17.

ID do complemento:

weblate.gettext.sphinx

Configuração:

interval

Atualizar frequência

Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.

Escolhas disponíveis:

daily

Diário

weekly

Semanalmente

monthly

Mensal

normalize_header

Normalizar cabeçalho POT

Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.

location_mode

Local da fonte

Escolha como a extração grava os locais de origem no arquivo POT. Use esta opção para manter os locais no modelo, omitindo-os dos arquivos PO traduzidos.

Escolhas disponíveis:

file

Usar configurações de formato de arquivo

keep

Extrair locais para o arquivo POT

omit

Não extrair locais

filter_mode

Filtragem

Opcionalmente, remove textos que não são úteis para traduzir após a extração de Sphinx.

Escolhas disponíveis:

none

Nada

weblate_docs

Documentação do Weblate

Gatilhos:

Instalação de complemento, Manual trigger, Pós-atualização do repositório

Atualiza o modelo gettext usando o construtor gettext do Sphinx sem carregar a configuração do projeto.

This add-on updates the template configured in Modelo para novas traduções. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Atualizar arquivos PO para corresponder ao POT (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Sphinx requirements

This add-on requires sphinx-build, provided by the sphinx installation extra. The template for new translations must be a .pot file below a locales directory. The directory before locales is used as the Sphinx source directory and must contain conf.py.

Extraction uses Weblate’s bundled Sphinx configuration and does not load the project configuration. Weblate runs the Sphinx gettext builder, normalizes source references to paths relative to the source directory, and copies the generated template back to the configured template path.

Atualizar arquivo POT (xgettext)

Adicionado na versão 5.17.

ID do complemento:

weblate.gettext.xgettext

Configuração:

Update behavior

interval

Atualizar frequência

Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.

Escolhas disponíveis:

daily

Diário

weekly

Semanalmente

monthly

Mensal

normalize_header

Normalizar cabeçalho POT

Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.

location_mode

Local da fonte

Escolha como a extração grava os locais de origem no arquivo POT. Use esta opção para manter os locais no modelo, omitindo-os dos arquivos PO traduzidos.

Escolhas disponíveis:

file

Usar configurações de formato de arquivo

keep

Extrair locais para o arquivo POT

omit

Não extrair locais

Input files

input_mode

Fonte de entrada

Escolha se o xgettext deve ler os arquivos-fonte a partir de padrões glob ou de um manifesto POTFILES/POTFILES.in.

Escolhas disponíveis:

patterns

Padrões de arquivo-fonte

potfiles

Manifesto POTFILES

language

Linguagem de xgettext

Linguagem de programação passada para o xgettext, por exemplo Python ou C. Deixe em branco para deixar o xgettext adivinhar a linguagem com base nas extensões de arquivos.

source_patterns

Padrões de arquivo-fonte

Padrões glob relativos ao repositório, separados por nova linha, para arquivos a serem extraídos com xgettext.

potfiles_path

Caminho de POTFILES

Caminho relativo ao repositório para POTFILES ou POTFILES.in. As entradas são resolvidas em relação à raiz do repositório. Se presente junto ao manifesto, POTFILES.skip exclui os arquivos listados da extração.

Comment extraction

comment_mode

Comentários do código

Selecione se o xgettext deve extrair nenhum, todos ou apenas os comentários marcados com uma tag específica.

Escolhas disponíveis:

off

Não extrair comentários

all

Extrair todos os comentários

tagged

Extrair comentários com tag

comment_tag

Tag do comentário

Tag passada para o xgettext para extração de comentários ao usar o modo de comentário taggeado.

Keywords

keyword

Palavras-chave adicionais

Palavras-chave extras separadas por nova linha passadas para xgettext usando –keyword.

keyword_exclusive

Usar palavras-chave exclusivamente

When enabled, passes --keyword without a value to xgettext before the additional keyword, disabling all default keywords so that only the keyword specified above is recognized.

Checks and ITS data

checks

Verificações do xgettext

Validação adicional do xgettext a habilitar para mensagens extraídas.

Escolhas disponíveis:

ellipsis-unicode

ellipsis-unicode

space-ellipsis

space-ellipsis

quote-unicode

quote-unicode

bullet-unicode

bullet-unicode

data_dirs

Diretórios de dados ITS

Diretórios relativos ao repositório, separados por nova linha, que contêm um subdiretório “its”, por exemplo, “po” para “po/its”. Os diretórios anteriores têm precedência sobre os diretórios posteriores e as regras agrupadas.

Gatilhos:

Instalação de complemento, Manual trigger, Pós-atualização do repositório

Atualiza o modelo gettext usando xgettext nos arquivos-fonte selecionados.

This add-on updates the template configured in Modelo para novas traduções. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Atualizar arquivos PO para corresponder ao POT (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

xgettext requirements

This add-on requires xgettext. Configure either source file patterns or a POTFILES / POTFILES.in manifest. Source file patterns are repository-relative glob patterns and only matching repository files are passed to xgettext.

Entries in POTFILES or POTFILES.in are resolved relative to the repository root. They must be relative paths, stay inside the repository, and point to existing files. Blank lines and lines starting with # are ignored. If a POTFILES.skip file exists next to the manifest, its entries are excluded from extraction.

Automatic repository refresh runs are skipped unless the changed files match the configured source patterns, match files listed in the manifest, change a watched manifest, or change the add-on configuration.

Start from the build-system extraction setup when configuring this add-on. Autotools projects usually keep gettext inputs in po/POTFILES.in and options such as the gettext domain and xgettext flags in po/Makevars or related Makefile.am files. Use manifest mode with the same POTFILES.in when its entries are plain repository-relative source paths, and copy relevant extraction behavior into the add-on settings, for example the language, comment extraction, checks, and additional keyword.

For other build systems, use the source list or extraction command they already run as the source of truth. CMake, custom Makefiles, npm scripts, or project specific extraction scripts often call xgettext directly or generate an intermediate file list. Configure source patterns for simple layouts, or use manifest mode when the project maintains a plain file list. If a build-system manifest contains transformations or prefixes that are not file paths, convert it to plain repository-relative paths before using it as POTFILES.

Mixed source formats and ITS rules

Leave xgettext language blank to extract messages from different formats into the same POT. Include all inputs in the source patterns or POTFILES, for example:

common/messages.py
qt/application.desktop
qt/application.policy
data/application.metainfo.xml

Desktop entries use the native xgettext parser. Weblate bundles ITS rules for Polkit policies, AppStream/MetaInfo, GSettings, GTK Builder, and Shared MIME Info. These rules are included in the Weblate package, including Docker installations; no additional system packages are required for these formats. The Atualizar arquivo POT (Meson) add-on uses the same rules.

Extraction follows upstream gettext and ITS behavior. In particular, desktop extraction includes keys such as Name, GenericName, and Comment; Polkit rules select description and message elements without filtering by gettext-domain. Use untranslated policy sources: upstream Polkit rules also select elements carrying xml:lang.

For custom XML formats or overrides, configure ITS data directories. Enter one repository-relative directory per line, in priority order. Each must contain an its/ subdirectory with .loc locating rules and .its extraction rules. For example, enter po for po/its/example.loc and po/its/example.its, or . for its/ at the repository root. In API add-on configuration, use a list: "data_dirs": ["po", "data"].

Earlier directories take precedence over later ones, followed by Weblate’s bundled rules and gettext’s system rules. The directories are passed through GETTEXTDATADIRS. Configure them explicitly even when using Meson; Weblate does not read data_dirs from meson.build or inherit an administrator’s GETTEXTDATADIRS environment variable.

Rule directories and files must stay inside the repository and must not be symbolic links. A locating rule’s target must name an existing .its file in the same directory. DTDs, entity declarations, and external rule references are not supported. Weblate validates project-local rules before extraction and reports invalid rules as add-on errors. Changes, additions, or deletions in the configured its/ directories trigger extraction even when source files have not changed.

Squash de commits git

ID do complemento:

weblate.git.squash

Configuração:

squash

Squash de commits

Escolhas disponíveis:

all

Todos os commits em um só

language

Por idioma

file

Por arquivo

author

Por autor

author-language

Por autor e idioma

append_trailers

Anexar linhas finalizadoras à mensagem do commit resultado de squash

As linhas finalizadoras são linhas semelhantes aos cabeçalhos de e-mail RFC 822, no final da parte livre de uma mensagem de commit, como “Co-authored-by: …’.

commit_message

Mensagem de commit

Esta mensagem de commit será usada em vez das mensagens de commit combinadas a partir de commits após squash.

Gatilhos:

Instalação de complemento, Pós-commit do repositório

Faz squash de commits Git antes de enviar alterações.

Dica

To avoid unnecessary conflicts, it is recommended to configure automatic receiving of upstream changes by webhooks or API, see Atualizando repositórios.

Commits Git podem ter squash feito antes de fazer o push das alterações em um dos seguintes modos:

  • Todos os commits em um só

  • Por idioma

  • Por arquivo

  • Por autor

  • Por autor e idioma

As mensagens de commit originais são mantidas, mas a autoria é perdida a menos que Por autor seja selecionada ou a mensagem de commit seja personalizada para incluí-la.

As mensagens de commit originais podem opcionalmente ser substituídas por uma mensagem de commit personalizada.

Linhas finalizadoras (linhas de commits como Co-authored-by: …) podem opcionalmente ser removidas das mensagens de commit originais e anexadas ao final da mensagem de compromisso após um fazer squash. Isso também gera crédito com Co-authored-by: apropriado para cada tradutor.

Personalizar saída JSON

Alterado na versão 5.12: Evite espaços após separadores opção adicionada.

Removido na versão 5.13: Replaced by Parâmetros de formato de arquivo.

Redefinir repositório para o upstream

Adicionado na versão 5.17.

ID do complemento:

weblate.hosted.reset

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Diário

Todas as noites, as alterações feitas no repositório Weblate serão descartadas.

Formatar o arquivo de propriedades Java

ID do complemento:

weblate.properties.sort

Configuração:

case_sensitive

Habilitar a ordenação de chaves sensível a maiúsculas e minúsculas

Gatilhos:

Pré-commit do repositório

Formata e ordena o arquivo de propriedades Java.

  • Consolida quebras de linhas para Unix.

  • Formatação em maiúsculas de sequências de escape Unicode (caso estejam presentes).

  • Tira linhas em branco e comentários.

  • Ordena os textos pelas chaves.

  • Descarta textos duplicados.

Remoção de comentário obsoleto

ID do complemento:

weblate.removal.comments

Configuração:

age

Dias a serem mantidos

Gatilhos:

Instalação de complemento, Diário

Define um período de tempo até a remoção dos comentários.

Isso pode ser útil para remover comentários antigos que podem ter se tornado desatualizados. Use com cuidado, pois o fato de os comentários ficarem velhos não significa que tenham perdido sua importância.

Remoção de sugestão obsoleta

ID do complemento:

weblate.removal.suggestions

Configuração:

age

Dias a serem mantidos

votes

Limite de votação

Limite para remoção. Deixe em branco para remover sugestões independentemente de votos. Este campo não tem efeito com a votação desativada.

Gatilhos:

Instalação de complemento, Diário

Define um período de tempo até a remoção de sugestões.

Pode ser muito útil em relação à votação em sugestão (vej Revisão por pares) para remover sugestões que não recebem votos positivos suficientes em um determinado período de tempo.

Atualizar arquivos RESX

ID do complemento:

weblate.resx.update

Configuração:

Esse complemento não tem configuração.

Gatilhos:

Instalação de complemento, Pós-atualização do repositório

Atualiza todos os arquivos de tradução para corresponder ao arquivo base monolíngue do upstream. Textos não usados são removidos e novos são adicionados como cópias do texto fonte.

Dica

Use Limpar arquivos de tradução se você só quiser remover chaves de tradução obsoletas.

Webhooks do Slack

Adicionado na versão 5.12.

ID do complemento:

weblate.webhook.slack

Configuração:

webhook_url

URL do Webhook

event_filter

Eventos de alteração para acionar

Choose which change events should trigger this add-on. Eventos de alteração para acionar

events

Eventos de alteração selecionados

Eventos de alteração selecionados

Gatilhos:

Alteração de evento

Envia notificação a um canal do Slack com base nos eventos selecionados.

Aviso

O conteúdo da notificação pode exibir tags HTML. Este é um problema conhecido que será resolvido em breve; ver https://github.com/WeblateOrg/weblate/issues/15056.

Dica

Para obter uma URL de webhook, siga as instruções na Documentação de Incoming Webhooks do Slack

Webhook

Adicionado na versão 5.11.

Alterado na versão 5.15: Compliance of the secret length with the specification is now validated.

ID do complemento:

weblate.webhook.webhook

Configuração:

webhook_url

URL do Webhook

secret

Segredo do webhook

O segredo do Webhooks padrão é uma string codificada em base64.

event_filter

Eventos de alteração para acionar

Choose which change events should trigger this add-on. Eventos de alteração para acionar

events

Eventos de alteração selecionados

Eventos de alteração selecionados

Gatilhos:

Alteração de evento

Envia notificações para serviços externos com base nos eventos selecionados, seguindo a especificação Standard Webhooks.

The request payload complies with the Weblate Messaging schema. The action field uses the action name listed in Eventos de alteração selecionados. The OpenAPI description can also be found at /api/docs/. Sample request body:

{
   "change_id": 99,
   "action": "Translation changed",
   "timestamp": "2019-08-24T14:15:22Z",
   "target": "Nazdar svete!",
   "old": "Nazdar!",
   "source": "Hello, world",
   "url": "/translate/project-slug/component-slug/cs/?checksum=46add148a53cab6f",
   "author": "author-username",
   "user": "user-username",
   "project": "project-slug",
   "component": "component-slug",
   "translation": "cs"
}

Exemplo de corpo de requisição com categorias:

{
   "change_id": 8910,
   "action": "Component renamed",
   "timestamp": "2025-06-11T07:15:09Z",
   "target": ["new-name"],
   "old": ["component-slug"],
   "url": "/projects/project-slug/parent-category/child-category/sub-category/component-slug/",
   "user": "testuser",
   "project": "project-slug",
   "component": "component-slug",
   "category": [
      "sub-category",
      "child-category",
      "parent-category"
   ]
}

Exemplo de cabeçalhos de requisição:

{
   "webhook-id": "7f1c5477f6275a69af7b83236c20cb1a",
   "webhook-timestamp": "1748505623.044281",
   "webhook-signature": "v1,Ceo5qEr07ixe2NLpvHk3FH9bwy/WavXrAFQ/9tdO6mc="
}

A webhook-signature é uma lista separada por espaços de assinaturas HMAC geradas usando o texto secret, o payload da solicitação, o webhook-timestamp e o webhook-id. Isso garante a autenticidade e a integridade da solicitação do webhook.

The provided secret is a base64 encoded string between 24 bytes (192 bits) and 64 bytes (512 bits). It can be prefixed with whsec_ for easy identification.

Para verificar uma solicitação, você pode usar o método Webhook.verify da biblioteca standardwebhooks ou uma implementação da Standard Webhooks Specification (em português, “Especificação Padrão de Webhooks”).

The Tradução automática mode Add as approved translation creates approved strings when reviews are enabled for the target language. If the project settings or a language workflow override disable reviews, it creates translated strings instead. The configured mode is preserved, including for project-wide and site-wide add-ons whose targets have different review settings. Configuring this mode requires the usual add-on management permission; it does not require the configuring user to be a reviewer.

The CDN de arquivos de tradução and CDN de localização do JavaScript add-ons publish manifest.json at their CDN base URL. Clients can download it without an API token to discover available languages and translation files:

{
  "schemaVersion": 1,
  "locales": {
    "cs": [
      {
        "url": "cs.json",
        "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
        "size": 123
      }
    ]
  }
}

The locales keys are Weblate language codes. Each value lists the published files for that language, sorted by URL. The url is relative to the manifest URL, sha256 is the SHA-256 checksum of the published bytes, and size is the file size in bytes. Multi-file translations have several entries per language. The JavaScript add-on includes only languages meeting its translation threshold. Source-language inclusion follows each add-on’s existing publication rules. The JavaScript loader and the manifest itself are not listed. When no translation files are published, locales is an empty object. The root filename manifest.json is reserved for this manifest. Weblate validates each manifest against the CDN manifest before publishing it.

Translation files are written before the manifest is replaced, and stale files are removed afterwards. File URLs remain mutable, and CDN caches can refresh the manifest and translation files at different times. If a download fails or its checksum does not match, refresh the manifest and retry the download. The manifest does not provide an immutable snapshot or revoke cached copies of removed files. Existing add-on installations publish a manifest on their next successful publication.

The CDN do SDK Kotlin add-on uses a separate build-specific manifest format.

The Descoberta de componente add-on stops with an error if the repository scan exceeds 100,000 paths or matching translation files would require more than 1,000,000 path-to-mask comparisons. The comparison limit is checked using the number of repository paths multiplied by the number of file masks. These fixed limits bound resource consumption when repository content determines the masks. When either limit is exceeded, discovery does not create or remove components.

When configuring the add-on, Weblate also suggests presets detected from the repository. Preset detection analyzes at most 4,096 distinct results with file masks no longer than 512 characters or 16 path segments. It samples groups of more than 128 compatible results and limits itself to 8,192 comparisons, 50 presets, and eight examples per preset. If a limit omits results or comparisons, Weblate warns that suggestions might be incomplete. You can enter the configuration manually.

The Webhook and Webhooks do Slack add-ons request uncompressed responses and reject responses with a Content-Encoding other than identity before reading their bodies. They limit each response body to 1 MiB and response headers to 64 KiB, including duplicate headers and separators. If a response is encoded or either fixed limit is exceeded, Weblate closes the response and records an add-on error without storing the response body or headers. The remote service might already have accepted the notification even when Weblate records this error.

Obsolete add-ons

Colaboradores nos comentários

Removido na versão 2026.10: Replaced by Contributor comments.

Existing installations of weblate.gettext.authors are migrated to the gettext value of the po_contributor_comments file format parameter for each affected PO component. This includes components covered by category-, project-, and site-wide installations. New components default to disabled unless their file format parameters are copied from another component.

Remove weblate.addons.gettext.GettextAuthorComments from custom WEBLATE_ADDONS lists and weblate.gettext.authors entries from DEFAULT_ADDONS. Configure Contributor comments instead.

Personalizar saída XML

Adicionado na versão 4.15.

Removido na versão 5.13: Replaced by Parâmetros de formato de arquivo.

Personalizar saída YAML

Removido na versão 5.13: Replaced by Parâmetros de formato de arquivo.

Parâmetros comuns de complementos

Serviços de tradução

Escolhas disponíveis:

alibaba

Alibaba

aws

Amazon Translate

anthropic

Anthropic

apertium-apy

Apertium APy

microsoft-translator

Tradutor IA da Azure

azure-openai

Azure OpenAI

baidu

Baidu

cyrtranslit

CyrTranslit

deepl

DeepL

glosbe

Glosbe

google-translate-api-v3

Tradução avançada do Google Cloud

google-translate

Tradução básica do Google Cloud

ltengine

LTEngine

libretranslate

LibreTranslate

mistral

Mistral

modernmt

ModernMT

mymemory

MyMemory

netease-sight

Netease Sight

ollama

Ollama

openai

OpenAI

sap-translation-hub

SAP Translation Hub

systran

Systran

weblate

Weblate

weblate-translation-memory

Weblate Translation Memory

yandex

Yandex

yandex-v2

Yandex v2

youdao-zhiyun

Youdao Zhiyun

etranslation

eTranslation

tmserver

tmserver

Formato de arquivo

Escolhas disponíveis:

apple-xliff

XLIFF 1.2 com extensões Apple

appstore

Arquivos de metadados da App Store

arb

Arquivo ARB

aresource

Recurso de textos de Android

asciidoc

Arquivo AsciiDoc

ass

Arquivo de legenda Advanced SubStation Alpha

catkeys

catkeys do Haiku

cmp-resource

Recurso do Compose Multiplatform

csv

Arquivo CSV

csv-multi

Arquivo CSV com vários valores

csv-simple

Arquivo CSV simples

dokuwiki

Arquivo texto DokuWiki

dtd

Arquivo DTD

flatxml

Arquivo XML simples

fluent

Arquivo Fluent

formatjs

Arquivo Format.JS JSON

go-i18n-json

Arquivo JSON go-i18n v1

go-i18n-json-v2

Arquivo JSON go-i18n v2

go-i18n-toml

Arquivo TOML go-i18n

gotext

arquivo JSON gotext

gwt

Propriedades GWT

html

Arquivo HTML

i18next

Arquivo JSON i18next v3

i18nextv4

Arquivo JSON i18next v4

idml

Arquivo IDML

ini

Arquivo INI

islu

Arquivo Inno Setup INI

joomla

Arquivo de linguagem Joomla

json

Arquivo JSON

json-nested

Arquivo de estrutura JSON aninhada

laravel

Textos de Laravel PHP

markdown

Arquivo Markdown

mdx

Arquivo MDX

mediawiki

Arquivo texto MediaWiki

mi18n-lang

Arquivo @draggable/i18n lang

moko-resource

Recurso Kotlin para dispositivos móveis

nextcloud-json

Arquivo JSON do Nextcloud

odf

Arquivo OpenDocument

php

Textos de PHP

po

arquivo PO gettext

po-mono

Arquivo PO gettext (monolíngue)

poxliff

XLIFF 1.2 com complementos gettext

properties

Propriedades Java

rc

Arquivo RC

resjson

Arquivo RESJSON

resourcedictionary

Arquivo ResourceDictionary

resx

Arquivo de recurso .NET

ruby-yaml

Arquivo Ruby YAML

srt

Arquivo de legenda SubRip

ssa

Arquivo de legenda SubStation Alpha

strings

Textos do iOS

stringsdict

Arquivo stringsdict

sub

Arquivo de legenda MicroDVD

tbx

Arquivo TermBase eXchange

toml

Arquivo TOML

ts

Arquivo de tradução do Qt Linguist (versão 2)

ts1

Arquivo de tradução do Qt Linguist (versão 1)

txt

Arquivo texto simples

webextension

Arquivo JSON WebExtension

wxl

Arquivo WixLocalization

xliff

Arquivo 1.2 de tradução XLIFF

xliff2

Arquivo de tradução XLIFF 2.0

xlsx

Excel Open XML

xwiki-fullpage

XWiki Full Page

xwiki-java-properties

XWiki Java Properties

xwiki-page-properties

XWiki Page Properties

yaml

Arquivo YAML

Eventos de alteração para acionar

Escolhas disponíveis:

content

Eventos de conteúdo de tradução

all

Todos os eventos de alteração

custom

Eventos de alteração selecionados

Eventos de alteração selecionados

The following change actions can appear in notification payloads. Fedora Messaging uses the identifier column in message topics, while webhook payloads use the name column in the action field.

Escolhas disponíveis:

ID

Identifier

Nome

Descrição

0

resource_updated

Recurso atualizado

A translation file was synchronized with its repository.

1

translation_completed

Tradução concluída

A language translation became fully translated after an individual edit. Automatic translation, uploads, and bulk edits do not emit this event.

2

translation_changed

Tradução alterada

An existing translation was edited by a user.

3

comment_added

Comentário adicionado

A comment was added to a string.

4

suggestion_added

Sugestão adicionada

A translation suggestion was added.

5

translation_added

Tradução adicionada

A previously untranslated string was translated by a user.

6

automatically_translated

Traduzido automaticamente

A translation was added or changed by automatic translation. This is emitted instead of Translation added or Translation changed.

7

suggestion_accepted

Sugestão aceita

A translation suggestion was accepted as the translation.

8

translation_reverted

Tradução revertida

A translation was restored to an earlier value.

9

translation_uploaded

Tradução enviada

A translation was added or changed by a translation file upload. This is emitted instead of Translation added or Translation changed.

13

source_string_added

Texto fonte adicionado

A source string was added outside repository or upload updates.

14

component_locked

Componente bloqueado

A component was locked for translation.

15

component_unlocked

Componente desbloqueado

A component was unlocked for translation.

17

changes_committed

Commit das alterações feito

Pending component changes were committed.

18

changes_pushed

Alterações enviadas

Repository changes were pushed upstream.

19

repository_reset

Redefinição do repositório

A repository was reset to its upstream state.

20

repository_merged

Repositório mesclado

Upstream repository changes were merged.

21

repository_rebased

Repositório rebaseado

Repository changes were rebased on upstream.

22

repository_merge_failed

Falha na mesclagem do repositório

Merging upstream repository changes failed.

23

repository_rebase_failed

Falha na rebase do repositório

Rebasing repository changes failed.

24

parsing_failed

Falha na análise

Weblate could not parse a translation file.

25

translation_removed

Tradução removida

A language translation was removed.

26

suggestion_removed

Sugestão removida

A translation suggestion was removed.

27

translation_replaced

Tradução substituída

A translation was changed by a search-and-replace operation. This is emitted instead of Translation changed.

28

repository_push_failed

Falha ao enviar para o repositório

Pushing repository changes upstream failed.

29

suggestion_removed_during_cleanup

Sugestão removida durante a limpeza

An obsolete translation suggestion was removed during cleanup.

30

source_string_changed

Texto fonte alterado

A source string was edited in Weblate.

31

string_added

Texto adicionado

A new string was added in Weblate.

32

bulk_status_changed

Status em massa alterado

The translation state of one or more strings was changed in bulk.

33

visibility_changed

Visibilidade alterada

Project or component visibility was changed.

34

user_added

Usuário adicionado

A user was granted access.

35

user_removed

Usuário removido

A user’s access was removed.

36

translation_approved

Tradução aprovada

A translation was approved during review.

37

marked_for_edit

Marcada para edição

A translation was marked as needing editing.

38

component_removed

Componente removido

A translation component was removed.

39

project_removed

Projeto removido

A translation project was removed.

41

project_renamed

Projeto renomeado

A translation project was renamed.

42

component_renamed

Componente renomeado

A translation component was renamed.

43

moved_component

Componente movido

A component was moved within a project.

45

contributor_joined

Colaborador entrou

A user made their first contribution to a translation.

46

announcement_posted

Novidade publicada

An announcement was posted.

47

alert_triggered

Alerta acionado

A component alert was triggered.

48

language_added

Idioma adicionado

A language translation was added.

49

language_requested

Idioma solicitado

A user requested a new language.

50

project_created

Projeto publicado

A translation project was created.

51

component_created

Componente adicionado

A translation component was created.

52

user_invited

Usuário convidado

A user was invited to a project.

53

repository_notification_received

Notificação de repositório recebida

Weblate received a repository notification from a code host.

54

translation_replaced_file_by_upload

Arquivo de tradução substituído via upload

A translation file was replaced by an uploaded file.

55

license_changed

Licença alterada

Project or component license information changed.

56

contributor_license_agreement_changed

Contrato de licença do colaborador alterado

The contributor license agreement was changed.

57

screenshot_added

Captura de tela adicionada

A screenshot was associated with a string.

58

screenshot_uploaded

Captura de tela enviada

A screenshot image was uploaded.

59

string_updated_in_the_repository

Texto atualizado no repositório

A string was changed while synchronizing from the repository.

60

add-on_installed

Complemento instalado

An add-on was installed.

61

add-on_configuration_changed

Configuração do complemento alterada

An add-on’s configuration was changed.

62

add-on_uninstalled

Complemento desinstalado

An add-on was uninstalled.

63

string_removed

Texto removido

A string was removed from a translation.

64

comment_removed

Comentário removido

A string comment was removed.

65

comment_resolved

Comentário resolvido

A string comment was marked as resolved.

66

explanation_updated

Explicação atualizada

The explanation for a source string was updated.

67

category_removed

Categoria removida

A component category was removed.

68

category_renamed

Categoria renomeada

A component category was renamed.

69

category_moved

Categoria movida

A component category was moved.

70

saving_string_failed

Falha ao salvar o texto

Weblate could not save a changed string.

71

string_added_in_the_repository

Texto adicionado no repositório

A new string was found while synchronizing from the repository.

72

string_updated_in_the_upload

Texto atualizado via upload

A string was changed while processing an uploaded file.

73

string_added_in_the_upload

Texto adicionado via upload

A new string was found while processing an uploaded file.

74

translation_updated_by_source_upload

Tradução atualizada via upload da fonte

A translation was synchronized after uploading a source file.

75

component_translation_completed

Tradução de componentes concluída

All language translations in a component became fully translated after an individual edit. Automatic translation, uploads, and bulk edits do not emit this event.

76

applied_enforced_check

Verificação forçada aplicada

A translation was marked as needing editing by an enforced check.

77

propagated_change

Alteração propagada

A translation edit was propagated to another matching string.

78

file_uploaded

Arquivo enviado

A file was uploaded to a translation.

79

extra_flags_updated

Marcadores extras atualizados

Additional source-string flags were updated.

80

font_uploaded

Fonte enviada

A font was uploaded.

81

font_changed

Fonte alterada

An uploaded font was changed.

82

font_removed

Fonte removida

An uploaded font was removed.

83

forced_synchronization_of_translations

Sincronização forçada de traduções

Translation files were forcibly synchronized with the repository.

84

forced_rescan_of_translations

Verificação forçada de traduções

Translation files were forcibly rescanned for changes.

85

screenshot_removed

Captura de tela removida

A screenshot was removed.

86

label_added

Etiqueta adicionada

A label was added to a string.

87

label_removed

Etiqueta removida

A label was removed from a string.

88

repository_cleanup

Limpeza do repositório

The repository working tree was cleaned up.

89

source_string_added_in_the_upload

Texto fonte adicionado no envio

A source string was added while processing an uploaded file.

90

source_string_added_in_the_repository

Texto fonte adicionado no repositório

A source string was added while synchronizing from the repository.

91

project_backed_up

Project backed up

A project backup was created.

92

project_restored

Project restored

A project was restored from a backup.

93

component_restored

Component restored

A component was restored from a backup.

94

user_edit_reverted

User edit reverted

All selected edits by a user were reverted.

95

project_setting_changed

Project setting changed

A project setting was changed.

96

component_setting_changed

Component setting changed

A component setting was changed.

97

user_access_changed

User access changed

A user’s access permissions were changed.

98

workspace_created

Workspace created

A workspace was created.

99

workspace_setting_changed

Workspace setting changed

A workspace setting was changed.

100

project_moved

Project moved

A project was moved into or out of a workspace.

101

remote_repository_updated

Remote repository updated

A remote repository update was completed.

102

remote_repository_update_failed

Remote repository update failed

Updating a remote repository failed.

103

alert_dismissed

Alert dismissed

A component alert was dismissed.

104

alert_reopened

Alert reopened

A component alert was reopened after its context changed.

Personalizando a lista de complementos

A lista de complementos é configurada por WEBLATE_ADDONS. Para adicionar outro complemento, basta incluir o nome absoluto da classe nesta configuração.

Escrevendo complementos

Você também pode escrever seus próprios complementos, criar uma subclasse de weblate.addons.base.BaseAddon para definir os metadados do complemento e, então, implementar um retorno de chamada para fazer o processamento.

Escrevendo scripts para complementos

Complementos também podem ser usados para executar scripts externos. Isso costumava ser integrado ao Weblate, mas agora você precisa escrever algum código para envolver seu script com um complemento.

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Example pre commit script."""

from __future__ import annotations

from typing import ClassVar

from django.utils.translation import gettext_lazy

from weblate.addons.events import AddonEvent
from weblate.addons.scripts import BaseScriptAddon


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events: ClassVar[set[AddonEvent]] = {
        AddonEvent.EVENT_PRE_COMMIT,
    }
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long description
    verbose = gettext_lazy("Execute script before commit")
    description = gettext_lazy("This add-on executes a script.")

    # Script to execute
    script = "/bin/true"
    # File to add in commit (for pre commit event)
    # does not have to be set
    add_file = "po/{{ language_code }}.po"

Para instruções de instalação, consulte Custom quality checks, add-ons, translation services and auto-fixes.

O script é executado com o diretório atual definido para a raiz do repositório VCS para qualquer componente.

Além disso, estão disponíveis as seguintes variáveis de ambiente:

WL_VCS

Sistema de controle de versão usado.

WL_REPO

URL do repositório upstream.

WL_PATH

Caminho absoluto para o repositório VCS.

WL_BRANCH

Ramo do repositório configurado no componente atual.

WL_FILEMASK

Máscara de arquivo para componente atual.

WL_TEMPLATE

Nome de arquivo de modelo para traduções monolíngues (pode estar vazio).

WL_NEW_BASE

Nome de arquivo do arquivo usado para criar novas traduções (pode estar vazio).

WL_FILE_FORMAT

Formato de arquivo usado no componente atual.

WL_LANGUAGE

Idioma da tradução processada atualmente (não disponível para ganchos de nível de componente).

WL_PREVIOUS_HEAD

HEAD anterior após atualização (disponível apenas ao executar o gancho de pós-atualização).

WL_COMPONENT_SLUG

Slug do componente usado para construir a URL.

WL_PROJECT_SLUG

Slug do projeto usado para construir a URL.

WL_COMPONENT_NAME

Nome de componente.

WL_PROJECT_NAME

Nome do projeto.

WL_COMPONENT_URL

URL do componente.

WL_ENGAGE_URL

URL de engajamento do projeto.

Processamento de repositório pós-atualização

Pode ser usado para atualizar arquivos de tradução quando a fonte VCS do upstream alterar. Para conseguir isso, lembre-se que o Weblate só vê arquivos dos quais se fez commit com o VCS, então você precisa fazer commit das alterações como parte do script.

Por exemplo, com Gulp, você pode fazê-lo usando o seguinte código:

#! /bin/sh
gulp --gulpfile gulp-i18n-extract.js
git commit -m 'Update source strings' src/languages/en.lang.json

Processamento pré-commit de traduções

Use o script de commit para alterar automaticamente uma tradução antes de fazer commit dela para o repositório.

Ele é passado como um parâmetro único que consiste o nome de uma tradução atual.

Registro de atividades complementares

O registro de atividades do complemento mantém o controle da execução do complemento e pode ser usado para acompanhar a atividade do complemento.

Each entry records whether processing is pending, successful, failed, or skipped. Skipped entries include the reason the add-on did not run, such as an incompatible component, no relevant changes, or a configured schedule that is not due yet. A successful entry can still mean that the add-on checked its inputs but found nothing to change.

For scope-wide add-ons that process components independently, the activity log contains a separate entry for each component.

Os registros podem ser podados após um certo intervalo de tempo configurando o ADDON_ACTIVITY_LOG_EXPIRY.