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.
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:
serviceServiço de avaliação
Escolhas disponíveis:¶ anthropicAnthropic
openaiOpenAI
mistralMistral
ollamaOllama
azure-openaiAzure OpenAI
qConsulta
intervalFrequência de avaliação
Escolhas disponíveis:¶ disabledDesativado
dailyDiário
weeklySemanalmente
monthlyMensal
on_changeAvaliar alterações de tradução
on_updateAvaliar 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:
workflowFluxo 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
Workflow definition for the script definition and reference.
Cookbook for complete examples.
Apply translation memory before machine translation for translation memory before machine translation.
Tradução automática¶
- ID do complemento:
weblate.autotranslate.autotranslate- Configuração:
modeModo de tradução automática
Escolhas disponíveis:¶ suggestAdicionar como sugestão
translateAdicionar como tradução
fuzzyAdicionar como “Necessita de edição”
approvedAdicionar como tradução aprovada
qConsulta
Observe que a tradução de todos os textos descartará todas as traduções existentes.
auto_sourceFonte das traduções automáticas
Escolhas disponíveis:¶ othersOutros componentes da tradução
mtTradução automática
componentComponente
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.
enginesServiços de tradução
thresholdLimite 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:
thresholdLimiar de tradução
A porcentagem de textos traduzidos que devem estar presentes para que a tradução seja incluída.
css_selectorSeletor CSS
Seletor CSS para detectar elementos localizáveis.
cookie_nameNome do cookie de idioma
Nome do cookie que armazena preferência de idioma.
filesExtrair 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_ageMaximum build age (days)
Retires builds this many days after their first registration. Re-registering a build does not extend its age.
maximum_versionsVersõ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
matchExpressã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_formatFormato de arquivo
language_regexFiltro 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_templatePersonalizar nome do componente
Use a sintaxe de modelo do Django. Esse modelo deve incluir {{ component }}.
base_file_templateDefina 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_templateDefinir 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_templateArquivo 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_templateDefina 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_addonsClonar complementos do componente principal para as recém-criadas
removeRemova componentes para arquivos inexistentes
- Gatilhos:
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
componentnamed group. Matching translation files also requires alanguagenamed 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_templateand at least one translation file matchingmatch, 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
languagegroup. Keep full control over thecomponentcapture, for examplelocale/(?P<component>[^/]+)\.potordocs/(?P<component>[^/_]+)\.md.Fill Define the file mask with a path that includes both a language wildcard and
{{ component }}, for examplelocale/*/{{ component }}.poordocs/{{ 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.mddocs/news_cs.mddocs/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_*.mddocs/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
componentmatch 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:
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.pocs/website.pode/application.pode/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.polocale/cs/LC_MESSAGES/website.polocale/de/LC_MESSAGES/application.polocale/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.posrc/locale/website.cs.posrc/locale/application.de.posrc/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.polocale/cs/website/cs.polocale/de/application/de.polocale/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.xmlres/values-cs/strings-help.xmlres/values-de/strings-about.xmlres/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.propertiesparent/module1/submodule/src/main/resources/ApplicationResource_es.propertiesparent/module2/src/main/resources/ApplicationResource_de.propertiesparent/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.
Ver também
Mensagens do Fedora¶
Adicionado na versão 5.15.
- ID do complemento:
weblate.fedora_messaging.publish- Configuração:
Broker connection
amqp_urlURL do broker AMQP
A URL do broker AMQP para se conectar.
topic_prefixPrefixo do tema
Prefixo opcional para adicionar aos temas das mensagens geradas.
Timeouts and retries
publish_timeoutTempo limite de publicação
Por quantos segundos aguardar o reconhecimento de entrega do agente.
connection_attemptsTentativas de conexão
Número de tentativas de conexão com o agente.
retry_delayTempo mínimo para uma nova tentativa
Quantos segundos aguardar entre tentativas de conexão.
TLS credentials
ca_certPacote de certificados CA (PEM)
Cole apenas blocos de certificado PEM, cada um começando com “—–BEGIN CERTIFICATE—–” e terminando com “—–END CERTIFICATE—–“.
client_keyChave privada do cliente (PEM)
Cole um único bloco de chave privada PEM não criptografado. Chaves privadas criptografadas não são suportadas.
client_certCertificado 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_filterEventos de alteração para acionar
Choose which change events should trigger this add-on. Eventos de alteração para acionar
eventsEventos de alteração selecionados
- Gatilhos:
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_idID numérico da alteração
actionVerbose name of the change.
timestampRegistro de data/hora em formato ISO
targetNovo valor da alteração (por exemplo, nova tradução do texto)
oldValor antigo da alteração (por exemplo, tradução anterior do texto)
sourceSource string.
urlAbsolute URL to view the related object.
authorNome de usuário do autor (pode ser diferente do usuário, por exemplo, ao aceitar sugestões)
userActing username
projectSlug da URL do projeto
componentSlug do componente
translationCódigo de idioma de tradução
Message headers¶
There are additional headers which you might utilize for routing as well:
actionVerbose name of the change.
projectSlug da URL do projeto
componentSlug 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"]
}
Ver também
Editor em massa¶
- ID do complemento:
weblate.flags.bulk- Configuração:
qConsulta
search_typeTipo de pesquisa
Escolhas disponíveis:¶ textTexto
regexExpressão regular
searchBuscar texto
Case-sensitive text or regular expression to replace in matching strings. Leave empty to disable replacement.
replacementSubstituiçã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.
stateStatus a definir
Escolhas disponíveis:¶ -1Não alterar
0Vazio
10Necessita de edição
11Necessita de edição (Precisa ser editado)
12Necessita de edição (Precisa ser verificado)
20Traduzido
30Aprovado
Source flags
Flags are set on the source strings corresponding to your filter results and apply to their translations in every language.
add_flagsAdd flags
remove_flagsRemove flags
Translation flags
Flags apply only to translations matching your filter. Source strings are excluded.
add_translation_flagsAdd flags
remove_translation_flagsRemove 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_labelsAdd labels
remove_labelsRemove labels
- Gatilhos:
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:
Solicitação de busca |
|
|---|---|
Labels: Add labels |
recente |
Solicitação de busca |
|
|---|---|
Translation flags: Add flags |
|
Solicitação de busca |
|
|---|---|
Translation flags: Add flags |
|
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:
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
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:
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
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:
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
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:
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
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:
scopeEscopo de saída
Escolhas disponíveis:¶ translationUm arquivo por tradução
componentUm arquivo por componente
filenameNome do arquivo gerado
templateConteú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:ltrorrtl.filenameandurl: 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
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
sourceTextos fonte
include_readonlyIncluir textos somente leitura
targetTradução alvo
Todos os textos nesta tradução serão substituídos
Prepended text
prefixTexto estático anexado
var_prefixTexto da variável anexado
Appended text
suffixTexto estático acrescentado
var_suffixTexto da variável acrescentado
Text expansion
var_multiplierMultiplicador 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:
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiário
weeklySemanalmente
monthlyMensal
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocal 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:¶ fileUsar configurações de formato de arquivo
keepExtrair locais para o arquivo POT
omitNã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
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiário
weeklySemanalmente
monthlyMensal
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocal 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:¶ fileUsar configurações de formato de arquivo
keepExtrair locais para o arquivo POT
omitNão extrair locais
Meson preset
presetPredefiniçã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:¶ glibGLib
Comment extraction
comment_modeComentá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:¶ offNão extrair comentários
allExtrair todos os comentários
taggedExtrair comentários com tag
comment_tagTag do comentário
Tag passada para o xgettext para extração de comentários ao usar o modo de comentário taggeado.
Keywords
keywordPalavras-chave adicionais
Palavras-chave extras separadas por nova linha passadas para xgettext usando –keyword.
keyword_exclusiveUsar palavras-chave exclusivamente
When enabled, passes
--keywordwithout 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
checksVerificações do xgettext
Validação adicional do xgettext a habilitar para mensagens extraídas.
Escolhas disponíveis:¶ ellipsis-unicodeellipsis-unicode
space-ellipsisspace-ellipsis
quote-unicodequote-unicode
bullet-unicodebullet-unicode
data_dirsDiretó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:
pathCaminho do arquivo MO gerado
Se não for especificado, o local do arquivo PO será usado.
fuzzyIncluir 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:
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:
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:
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiário
weeklySemanalmente
monthlyMensal
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocal 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:¶ fileUsar configurações de formato de arquivo
keepExtrair locais para o arquivo POT
omitNão extrair locais
filter_modeFiltragem
Opcionalmente, remove textos que não são úteis para traduzir após a extração de Sphinx.
Escolhas disponíveis:¶ noneNada
weblate_docsDocumentaçã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
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o arquivo POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiário
weeklySemanalmente
monthlyMensal
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocal 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:¶ fileUsar configurações de formato de arquivo
keepExtrair locais para o arquivo POT
omitNão extrair locais
Input files
input_modeFonte 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:¶ patternsPadrões de arquivo-fonte
potfilesManifesto POTFILES
languageLinguagem 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_patternsPadrões de arquivo-fonte
Padrões glob relativos ao repositório, separados por nova linha, para arquivos a serem extraídos com xgettext.
potfiles_pathCaminho 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_modeComentá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:¶ offNão extrair comentários
allExtrair todos os comentários
taggedExtrair comentários com tag
comment_tagTag do comentário
Tag passada para o xgettext para extração de comentários ao usar o modo de comentário taggeado.
Keywords
keywordPalavras-chave adicionais
Palavras-chave extras separadas por nova linha passadas para xgettext usando –keyword.
keyword_exclusiveUsar palavras-chave exclusivamente
When enabled, passes
--keywordwithout 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
checksVerificações do xgettext
Validação adicional do xgettext a habilitar para mensagens extraídas.
Escolhas disponíveis:¶ ellipsis-unicodeellipsis-unicode
space-ellipsisspace-ellipsis
quote-unicodequote-unicode
bullet-unicodebullet-unicode
data_dirsDiretó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.
Ver também
Squash de commits git¶
- ID do complemento:
weblate.git.squash- Configuração:
squashSquash de commits
Escolhas disponíveis:¶ allTodos os commits em um só
languagePor idioma
filePor arquivo
authorPor autor
author-languagePor autor e idioma
append_trailersAnexar 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_messageMensagem de commit
Esta mensagem de commit será usada em vez das mensagens de commit combinadas a partir de commits após squash.
- Gatilhos:
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:
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_sensitiveHabilitar a ordenação de chaves sensível a maiúsculas e minúsculas
- Gatilhos:
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:
ageDias a serem mantidos
- Gatilhos:
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:
ageDias a serem mantidos
votesLimite 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:
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:
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_urlURL do Webhook
event_filterEventos de alteração para acionar
Choose which change events should trigger this add-on. Eventos de alteração para acionar
eventsEventos de alteração selecionados
- Gatilhos:
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_urlURL do Webhook
secretSegredo do webhook
O segredo do Webhooks padrão é uma string codificada em base64.
event_filterEventos de alteração para acionar
Choose which change events should trigger this add-on. Eventos de alteração para acionar
eventsEventos de alteração selecionados
- Gatilhos:
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¶
|
Alibaba |
|
Amazon Translate |
|
Anthropic |
|
Apertium APy |
|
Tradutor IA da Azure |
|
Azure OpenAI |
|
Baidu |
|
CyrTranslit |
|
DeepL |
|
Glosbe |
|
Tradução avançada do Google Cloud |
|
Tradução básica do Google Cloud |
|
LTEngine |
|
LibreTranslate |
|
Mistral |
|
ModernMT |
|
MyMemory |
|
Netease Sight |
|
Ollama |
|
OpenAI |
|
SAP Translation Hub |
|
Systran |
|
Weblate |
|
Weblate Translation Memory |
|
Yandex |
|
Yandex v2 |
|
Youdao Zhiyun |
|
eTranslation |
|
tmserver |
Formato de arquivo¶
|
XLIFF 1.2 com extensões Apple |
|
Arquivos de metadados da App Store |
|
Arquivo ARB |
|
Recurso de textos de Android |
|
Arquivo AsciiDoc |
|
Arquivo de legenda Advanced SubStation Alpha |
|
catkeys do Haiku |
|
Recurso do Compose Multiplatform |
|
Arquivo CSV |
|
Arquivo CSV com vários valores |
|
Arquivo CSV simples |
|
Arquivo texto DokuWiki |
|
Arquivo DTD |
|
Arquivo XML simples |
|
Arquivo Fluent |
|
Arquivo Format.JS JSON |
|
Arquivo JSON go-i18n v1 |
|
Arquivo JSON go-i18n v2 |
|
Arquivo TOML go-i18n |
|
arquivo JSON gotext |
|
Propriedades GWT |
|
Arquivo HTML |
|
Arquivo JSON i18next v3 |
|
Arquivo JSON i18next v4 |
|
Arquivo IDML |
|
Arquivo INI |
|
Arquivo Inno Setup INI |
|
Arquivo de linguagem Joomla |
|
Arquivo JSON |
|
Arquivo de estrutura JSON aninhada |
|
Textos de Laravel PHP |
|
Arquivo Markdown |
|
Arquivo MDX |
|
Arquivo texto MediaWiki |
|
Arquivo @draggable/i18n lang |
|
Recurso Kotlin para dispositivos móveis |
|
Arquivo JSON do Nextcloud |
|
Arquivo OpenDocument |
|
Textos de PHP |
|
arquivo PO gettext |
|
Arquivo PO gettext (monolíngue) |
|
XLIFF 1.2 com complementos gettext |
|
Propriedades Java |
|
Arquivo RC |
|
Arquivo RESJSON |
|
Arquivo ResourceDictionary |
|
Arquivo de recurso .NET |
|
Arquivo Ruby YAML |
|
Arquivo de legenda SubRip |
|
Arquivo de legenda SubStation Alpha |
|
Textos do iOS |
|
Arquivo stringsdict |
|
Arquivo de legenda MicroDVD |
|
Arquivo TermBase eXchange |
|
Arquivo TOML |
|
Arquivo de tradução do Qt Linguist (versão 2) |
|
Arquivo de tradução do Qt Linguist (versão 1) |
|
Arquivo texto simples |
|
Arquivo JSON WebExtension |
|
Arquivo WixLocalization |
|
Arquivo 1.2 de tradução XLIFF |
|
Arquivo de tradução XLIFF 2.0 |
|
Excel Open XML |
|
XWiki Full Page |
|
XWiki Java Properties |
|
XWiki Page Properties |
|
Arquivo YAML |
Eventos de alteração para acionar¶
|
Eventos de conteúdo de tradução |
|
Todos os eventos de alteração |
|
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.
ID |
Identifier |
Nome |
Descrição |
|---|---|---|---|
|
|
Recurso atualizado |
A translation file was synchronized with its repository. |
|
|
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. |
|
|
Tradução alterada |
An existing translation was edited by a user. |
|
|
Comentário adicionado |
A comment was added to a string. |
|
|
Sugestão adicionada |
A translation suggestion was added. |
|
|
Tradução adicionada |
A previously untranslated string was translated by a user. |
|
|
Traduzido automaticamente |
A translation was added or changed by automatic translation. This is emitted instead of Translation added or Translation changed. |
|
|
Sugestão aceita |
A translation suggestion was accepted as the translation. |
|
|
Tradução revertida |
A translation was restored to an earlier value. |
|
|
Tradução enviada |
A translation was added or changed by a translation file upload. This is emitted instead of Translation added or Translation changed. |
|
|
Texto fonte adicionado |
A source string was added outside repository or upload updates. |
|
|
Componente bloqueado |
A component was locked for translation. |
|
|
Componente desbloqueado |
A component was unlocked for translation. |
|
|
Commit das alterações feito |
Pending component changes were committed. |
|
|
Alterações enviadas |
Repository changes were pushed upstream. |
|
|
Redefinição do repositório |
A repository was reset to its upstream state. |
|
|
Repositório mesclado |
Upstream repository changes were merged. |
|
|
Repositório rebaseado |
Repository changes were rebased on upstream. |
|
|
Falha na mesclagem do repositório |
Merging upstream repository changes failed. |
|
|
Falha na rebase do repositório |
Rebasing repository changes failed. |
|
|
Falha na análise |
Weblate could not parse a translation file. |
|
|
Tradução removida |
A language translation was removed. |
|
|
Sugestão removida |
A translation suggestion was removed. |
|
|
Tradução substituída |
A translation was changed by a search-and-replace operation. This is emitted instead of Translation changed. |
|
|
Falha ao enviar para o repositório |
Pushing repository changes upstream failed. |
|
|
Sugestão removida durante a limpeza |
An obsolete translation suggestion was removed during cleanup. |
|
|
Texto fonte alterado |
A source string was edited in Weblate. |
|
|
Texto adicionado |
A new string was added in Weblate. |
|
|
Status em massa alterado |
The translation state of one or more strings was changed in bulk. |
|
|
Visibilidade alterada |
Project or component visibility was changed. |
|
|
Usuário adicionado |
A user was granted access. |
|
|
Usuário removido |
A user’s access was removed. |
|
|
Tradução aprovada |
A translation was approved during review. |
|
|
Marcada para edição |
A translation was marked as needing editing. |
|
|
Componente removido |
A translation component was removed. |
|
|
Projeto removido |
A translation project was removed. |
|
|
Projeto renomeado |
A translation project was renamed. |
|
|
Componente renomeado |
A translation component was renamed. |
|
|
Componente movido |
A component was moved within a project. |
|
|
Colaborador entrou |
A user made their first contribution to a translation. |
|
|
Novidade publicada |
An announcement was posted. |
|
|
Alerta acionado |
A component alert was triggered. |
|
|
Idioma adicionado |
A language translation was added. |
|
|
Idioma solicitado |
A user requested a new language. |
|
|
Projeto publicado |
A translation project was created. |
|
|
Componente adicionado |
A translation component was created. |
|
|
Usuário convidado |
A user was invited to a project. |
|
|
Notificação de repositório recebida |
Weblate received a repository notification from a code host. |
|
|
Arquivo de tradução substituído via upload |
A translation file was replaced by an uploaded file. |
|
|
Licença alterada |
Project or component license information changed. |
|
|
Contrato de licença do colaborador alterado |
The contributor license agreement was changed. |
|
|
Captura de tela adicionada |
A screenshot was associated with a string. |
|
|
Captura de tela enviada |
A screenshot image was uploaded. |
|
|
Texto atualizado no repositório |
A string was changed while synchronizing from the repository. |
|
|
Complemento instalado |
An add-on was installed. |
|
|
Configuração do complemento alterada |
An add-on’s configuration was changed. |
|
|
Complemento desinstalado |
An add-on was uninstalled. |
|
|
Texto removido |
A string was removed from a translation. |
|
|
Comentário removido |
A string comment was removed. |
|
|
Comentário resolvido |
A string comment was marked as resolved. |
|
|
Explicação atualizada |
The explanation for a source string was updated. |
|
|
Categoria removida |
A component category was removed. |
|
|
Categoria renomeada |
A component category was renamed. |
|
|
Categoria movida |
A component category was moved. |
|
|
Falha ao salvar o texto |
Weblate could not save a changed string. |
|
|
Texto adicionado no repositório |
A new string was found while synchronizing from the repository. |
|
|
Texto atualizado via upload |
A string was changed while processing an uploaded file. |
|
|
Texto adicionado via upload |
A new string was found while processing an uploaded file. |
|
|
Tradução atualizada via upload da fonte |
A translation was synchronized after uploading a source file. |
|
|
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. |
|
|
Verificação forçada aplicada |
A translation was marked as needing editing by an enforced check. |
|
|
Alteração propagada |
A translation edit was propagated to another matching string. |
|
|
Arquivo enviado |
A file was uploaded to a translation. |
|
|
Marcadores extras atualizados |
Additional source-string flags were updated. |
|
|
Fonte enviada |
A font was uploaded. |
|
|
Fonte alterada |
An uploaded font was changed. |
|
|
Fonte removida |
An uploaded font was removed. |
|
|
Sincronização forçada de traduções |
Translation files were forcibly synchronized with the repository. |
|
|
Verificação forçada de traduções |
Translation files were forcibly rescanned for changes. |
|
|
Captura de tela removida |
A screenshot was removed. |
|
|
Etiqueta adicionada |
A label was added to a string. |
|
|
Etiqueta removida |
A label was removed from a string. |
|
|
Limpeza do repositório |
The repository working tree was cleaned up. |
|
|
Texto fonte adicionado no envio |
A source string was added while processing an uploaded file. |
|
|
Texto fonte adicionado no repositório |
A source string was added while synchronizing from the repository. |
|
|
Project backed up |
A project backup was created. |
|
|
Project restored |
A project was restored from a backup. |
|
|
Component restored |
A component was restored from a backup. |
|
|
User edit reverted |
All selected edits by a user were reverted. |
|
|
Project setting changed |
A project setting was changed. |
|
|
Component setting changed |
A component setting was changed. |
|
|
User access changed |
A user’s access permissions were changed. |
|
|
Workspace created |
A workspace was created. |
|
|
Workspace setting changed |
A workspace setting was changed. |
|
|
Project moved |
A project was moved into or out of a workspace. |
|
|
Remote repository updated |
A remote repository update was completed. |
|
|
Remote repository update failed |
Updating a remote repository failed. |
|
|
Alert dismissed |
A component alert was dismissed. |
|
|
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.
Ver também
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.
Ver também
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.