Extensões

Os extras fornecem modos para personalizar e automatizar o fluxo de trabalho da tradução. Os administradores podem adicionar e gerir os extras no menu OperaçõesExtras de cada projeto ou componente de tradução respetivo. Os extras também podem ser instalados em todo o “”site”” em Interface de gestão.

Dica

Também pode configurar extensões utilizando API, DEFAULT_ADDONS ou install_addon.

Extras que optem por ativação manual podem ser executados a partir de gestão de extras ou usando a API. Resultados são gravados no registo de atividade de extras.

../_images/addons.webp

Eventos que acionam a extensão

Instalação de extensões

Acionado quando uma extensão estiver a ser instalada.

Atualização de componente

Acionado sempre que ocorra uma alteração num componente, como por exemplo:

  • Cadeias de carateres alteradas no repositório.

  • Cadeia adicionada.

  • Uma nova tradução é adicionada.

Diariamente

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.

Acionamento manual

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

Repositório depois de adicionar

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

Repositório depois de submeter

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

Repositório depois de enviar

Acionado logo após o repositório ter sido enviado para a fonte.

Repositório após remoção

Triggered just after a translation is removed.

Repositório depois da atualização

Acionado sempre que as novas alterações forem submetidas para o repositório principal.

Pré-commit do repositório

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

Pré-push do repositório

Acionado imediatamente antes do repositório ser enviado para a fonte.

Pré-atualização do repositório

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

Pós-gravação da unidade

Acionado logo após a cadeia ser gravada.

Pós-sincronização da unidade

Triggered after the string is synchronized with the VCS.

Pré-criação da unidade

Acionado logo após a cadeia recém-criado ser gravada.

Extras integrados

Tradução Automática

ID da extensão:

weblate.autotranslate.autotranslate

Configuração:

mode

Modo de tradução automático

Escolhas disponíveis:

suggest

Adicionar como sugestão

translate

Adicionar como tradução

fuzzy

Adicionar como «Precisa de edição»

q

Consulta

Por favor, note que a tradução de todas as cadeias de carateres irá rejeitar todas as traduções existentes.

auto_source

Fonte das traduções automáticas

Escolhas disponíveis:

others

Outros componentes da tradução

mt

Tradução automática

component

Componente

Introduza a lesma de um componente para utilizar como fonte, deixe em branco para utilizar todos os componentes no projeto atual.

engines

Motores de tradução automática

Motores de tradução automática

threshold

Limite de pontuação

Gatilhos:

Instalação de extensões, Atualização de componente, Diariamente, Alteração de evento

Traduz automaticamente as cadeias utilizando a tradução automática ou outros componentes.

CDN de localização JavaScript

Added in version 4.2.

ID da extensão:

weblate.cdn.cdnjs

Configuração:

threshold

Limiar de tradução

A percentagem de cadeias de carateres traduzidas que devem estar presentes para que a tradução seja incluída.

css_selector

Seletor de CSS

Seletor CSS para detetar elementos localizáveis.

cookie_name

Nome do cookie do idioma

Nome do cookie que armazena a preferência de idioma.

files

Extrair cadeias de ficheiros de HTML

Lista de nomes de ficheiros no repositório atual ou URLs remotos para serem analisados para obter as cadeias de carateres traduzíveis.

Gatilhos:

Instalação de extensões, Diariamente, Repositório depois de submeter, Repositório após remoção, Repositório depois da atualização

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

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

Gera um URL exclusivo para o seu componente, que pode ser incluído em páginas HTML para localizá-los. Veja Traduzir HTML e JavaScript utilizando Weblate CDN para mais detalhes.

Nota

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

Esta extensão é configurado em Hosted Weblate e disponibiliza os ficheiros via https://weblate-cdn.com/.

Ficheiros de tradução CDN

Added in version 2026.5.

ID da extensão:

weblate.cdn.files

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Atualização de componente, Repositório depois de submeter, Repositório após remoção, Repositório depois da atualização

Publica os ficheiros de tradução numa rede de distribuição de conteúdo.

Publica ficheiros de tradução sem convertê-los para outro formato. Ficheiros são escritos abaixo do extra específico do diretório CDN e servidos a partir de LOCALIZE_CDN_URL/<add-on UUID>/. Traduções de ficheiro único usam o código do idioma e a extensão original do ficheiro, por exemplo cs.json ou de.po. Traduções multi ficheiro são servidas abaixo do código de idioma usando caminhos relativos para o diretório de tradução. Componentes monolingues incluem o ficheiro de tradução fonte, enquanto que componentes bilingues publicam apenas ficheiros do idioma alvo. Vejam CDN de localização para orientações sobre a prestação segura de serviço.

Remover cadeias em branco

Added in version 4.4.

ID da extensão:

weblate.cleanup.blank

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Repositório depois de submeter, Repositório depois da atualização

Remove cadeias não traduzidas dos ficheiros de tradução.

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

Limpeza de ficheiros de tradução

ID da extensão:

weblate.cleanup.generic

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Repositório depois da atualização, Pré-commit do repositório

Atualize todos os ficheiros de tradução para coincidirem com o ficheiro monolingue base. Para a maioria dos formatos de ficheiro, significa remover as chaves de tradução obsoletas que já não existem no ficheiro base.

Para formatos que contêm conteúdo adicional além das cadeias de tradução (como Ficheiro HTML, Ficheiros RC do Windows ou Formato OpenDocument), isto também sincroniza o ficheiro de tradução com o ficheiro 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.

Adiciona idiomas em falta

ID da extensão:

weblate.consistency.languages

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Diariamente, Repositório depois de adicionar

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, esta extensão afeta todo o projeto.

Dica

Traduza as cadeias recém-adicionadas automaticamente com Tradução Automática.

Descoberta de componentes

ID da extensão:

weblate.discovery.discovery

Configuração:

match

Expressão regular para corresponder ficheiros de tradução

A expressão regular deve definir os grupos nomeados para o componente e idioma.

file_format

Formato de ficheiro

Formato de ficheiro

name_template

Personalizar nome do componente

Utiliza a sintaxe de modelo do Django. Este modelo deve incluir {{ component }}.

base_file_template

Definir nome do ficheiro base monolingue

Deixe em branco para os ficheiros de tradução bilingue. Quando definido, este modelo deve incluir {{ component }}.

new_base_template

Defina o ficheiro base para as novas traduções

O nome de ficheiro do ficheiro utilizado para criar as novas traduções. Para gettext, escolha o ficheiro «.pot». Este modelo deve incluir {{ component }}.

intermediate_template

Ficheiro de idioma intermédio

O nome de ficheiro do ficheiro de tradução intermediário. Geralmente este é um ficheiro de tradução fornecido pelos programadores e é utilizado na criação das cadeias de carateres fonte atuais. Este modelo deve incluir {{ component }}.

language_regex

Filtro de idioma

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

copy_addons

Clonar extensões do componente principal para os recém-criados

remove

Remover componentes para os ficheiros inexistentes

Gatilhos:

Instalação de extensões, Repositório depois da atualização

Adiciona ou remove automaticamente componentes do projeto com base em alterações de ficheiros no sistema de controlo de versão.

A correspondência é feita usando expressões regulares ao ativar configuração complexa, mas algum conhecimento é necessário para tal. A expressão regular para corresponder aos ficheiros de tradução deve conter dois grupos nomeados para corresponder ao componente e ao idioma. Todos os grupos nomeados na expressão regular podem ser usados como variáveis nos campos do modelo.

Requisitos de descoberta

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

  • The regular expression must define component and language named groups.

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

  • For monolingual formats, the component must contain a file matching base_file_template and at least one translation file matching match.

Worked example: news_<lang>.md

This is a common filename-based language variant layout:

  • docs/news_en.md

  • docs/news_cs.md

  • docs/guide_en.md

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

Expressão regular:

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

Nome do componente:

{{ component }}

Discovered file masks:
  • docs/news_*.md

  • docs/guide_*.md

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

Pode usar a marcação do template Django em todos os campos de nome de ficheiro, por exemplo:

{{ component }}

Nome de componente analisado a partir da correspondência de grupo de componente

{{ component|title }}

Nome do componente com a 1ª letra maiúscula

{{ path }}: {{ component }}

Grupo de correspondência personalizado da expressão regular

Assim que clicar em Gravar, será apresentada uma pré-visualização dos componentes correspondentes, de onde pode verificar se a configuração realmente corresponde às suas necessidades:

../_images/addon-discovery.webp

Exemplos de descoberta de componentes

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

Uma pasta por língua

Uma pasta por idioma contendo os ficheiros de tradução para os componentes.

Expressão regular:

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

Ficheiros correspondentes:
  • cs/application.po

  • cs/website.po

  • de/application.po

  • de/website.po

Disposição dos idiomas de gettext

Estrutura usual para guardar os ficheiros PO gettext.

Expressão regular:

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

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

  • locale/cs/LC_MESSAGES/website.po

  • locale/de/LC_MESSAGES/application.po

  • locale/de/LC_MESSAGES/website.po

Nomes complexos de ficheiros

Utilização dos nomes de componente e idioma no nome de ficheiro.

Expressão regular:

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

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

  • src/locale/website.cs.po

  • src/locale/application.de.po

  • src/locale/website.de.po

Código de idioma repetido

Utilização do idioma no caminho e no nome de ficheiro.

Expressão regular:

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

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

  • locale/cs/website/cs.po

  • locale/de/application/de.po

  • locale/de/website/de.po

Dividir cadeias do Android

Cadeias de carateres de recursos Android, divididos em vários ficheiros.

Expressão regular:

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

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

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

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

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

A combinar vários caminhos

Projeto multi-módulo do Maven com traduções de propriedades de Java.

Expressão regular:

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

Nome do componente:

{{ originalHierarchy }}: {{ component }}

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

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

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

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

Dica

O extra de descobrir componentes utiliza URLs internas do Weblate. É uma maneira conveniente de partilhar a configuração do VCS entre vários componentes. Os componentes associados utilizam o repositório local do componente principal configurado, preenchendo weblate://project/main-component no campo Repositório do código-fonte (em OperaçõesDefiniçõesSistema do controle de versão) de cada componente. Isto poupa tempo com a configuração e também com os recursos do sistema.

Dica

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

Fedora Messaging

Added in version 5.15.

ID da extensão:

weblate.fedora_messaging.publish

Configuração:

amqp_url

URL do intermediário AMQP

O URL do intermediário do AMQP para se ligar.

topic_prefix

Prefixo de tópico

Prefixo opcional a adicionar à frente de tópicos de mensagens gerados.

publish_timeout

Tempo de limite da publicação

Quantos segundos a esperar pela confirmação da entrega do intermediário.

connection_attempts

Tentativas de conexão

Quantas vezes tentar estabelecer ligação ao intermedário.

retry_delay

Atraso da repetição

Quantos segundos a esperar entre tentativas de conexão.

ca_cert

Conjunto de certificados CA (PEM)

Cole apenas blocos de certificados, cada um começado por «—–BEGIN CERTIFICATE—–» e terminado por «—–END CERTIFICATE—–«.

client_key

Chave de cliente privada (PEM)

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

client_cert

Certificado de cliente (PEM)

Cole apenas blocos de certificado PEM começados por «—–BEGIN CERTIFICATE—–»; não cole o resultado de «openssl x509 -text».

event_filter

Eventos de alteração a ativar

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

events

Eventos de alteração selecionados

Eventos de alteração selecionados

Gatilhos:

Alteração de evento

Envia notificações para uma troca AMQP compatível com Fedora Messaging.

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

Tópico de mensagem

Todas as mensagem têm um tópico weblate.<action>.<project>.<category...>.<component>.<translation>. Quando configurado, topic_prefix é antecedido a este tópico usando um único ponto como separador, por exemplo org.fedoraproject.weblate.project_backed_up.website. A ação é uma representação textual em minúsculas da ação com traços sublinhados antes do espaço, por exemplo resource_updated; veja Eventos de alteração selecionados para todos os identificadores de ação. As restantes partes correspondem a segmentos do caminho do objeto Weblate.

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.

Corpo da mensagem

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

change_id

ID numérico da alteração

action

Nome completo da alteração.

timestamp

Registo de data/hora em formato ISO

target

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

old

Valor antigo da alteração (p. ex. tradução anterior da cadeia)

source

Cadeia fonte.

url

URL absoluto para visualizar o objeto relacionado.

author

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

user

Nome de utilizador provisório

project

Abreviação do projeto

component

URL amigável do componente

translation

Código de idioma de tradução

Cabeçalhos de mensagem

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

action

Nome completo da alteração.

project

Abreviação do projeto

component

URL amigável do componente

Mensagens de exemplo

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"]
}

Edição em massa

ID da extensão:

weblate.flags.bulk

Configuração:

q

Consulta

state

Estado a definir

Escolhas disponíveis:

-1

Não alterar

10

Precisa de edição

11

Precisa de edição (Precisa de reescrita)

12

Precisa de edição (Precisa de verificação)

20

Traduzido

30

Aprovadas

add_flags

Bandeiras de tradução para adicionar

remove_flags

Bandeiras de tradução para remover

add_labels

Etiqueta a adicionar

remove_labels

Etiquetas a remover

Gatilhos:

Instalação de extensões, Atualização de componente

Edição em série de marcadores, etiquetas, ou estados das cadeias de carateres.

Exemplos::

Rotula novas cadeias automaticamente

Consulta de pesquisa

NOT has:label

Etiqueta a adicionar

recente

Marcar tudo como apenas de leitura para as cadeias de carateres do registo de eventos Ficheiros de metadados da App Store

Consulta de pesquisa

language:en AND key:changelogs/

Bandeiras de tradução para adicionar

read-only

Marcar certas cadeias como apenas para leitura

Consulta de pesquisa

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

Bandeiras de tradução para adicionar

read-only

Sinalizar as traduções inalteradas como «Precisa de reescrita»

ID da extensão:

weblate.flags.same_edit

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Pré-criação da unidade

Sempre que uma nova cadeia de carateres traduzível é importada de VCS e corresponde a uma cadeia de carateres fonte, esta é sinalizada como «Precisa de reescrita» no Weblate. Isto é especialmente útil para os formatos de ficheiro que incluem cadeias de carateres não traduzidas.

Dica

Também pode reforçar a verificação Tradução inalterada a adicionar o marcador strict-same aos Marcadores de tradução.

Veja também

Estados de tradução

Sinalizar as novas cadeias de carateres fonte como «Precisa de edição»

ID da extensão:

weblate.flags.source_edit

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Pré-criação da unidade

Sempre que uma nova cadeia de carateres é importada de VCS, esta é marcada como «Precisa de edição» no Weblate. Deste modo pode filtrar e editar facilmente as cadeias de carateres fonte escritas pelos programadores.

Veja também

Estados de tradução

Sinalizar as novas traduções como «Precisa de reescrita»

ID da extensão:

weblate.flags.target_edit

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Pré-criação da unidade

Sempre que uma nova cadeia de carateres traduzível é importada de VCS, esta é sinalizada como «Precisa de reescrita» no Weblate. Deste modo pode filtrar e editar facilmente as traduções criadas pelos programadores.

Veja também

Estados de tradução

Sinalizar as traduções atualizadas do repositório como «Precisa de reescrita»

ID da extensão:

weblate.flags.target_repo_update

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Pós-sincronização da unidade

Sempre que uma tradução da cadeia de carateres é alterada a partir de VCS, esta é sinalizada como «Precisa de reescrita» no Weblate. Especialmente útil se os ficheiros de tradução são atualizados com frequência ou por um serviço externo.

Veja também

Estados de tradução

Preencher cadeias de caracteres só de leitura com a fonte

Added in version 4.18.

ID da extensão:

weblate.generate.fill_read_only

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Atualização de componente, Diariamente

Preenche a tradução de cadeias de caracteres só de leitura com a cadeia fonte.

Gerador de estatísticas

ID da extensão:

weblate.generate.generate

Configuração:

filename

Nome do ficheiro gerado

template

Conteúdo do ficheiro gerado

Gatilhos:

Instalação de extensões, Pré-commit do repositório

Gera um ficheiro que contêm a informação detalhada sobre o estado da tradução.

Pode usar um modelo do Django, tanto de nome de ficheiro e conteúdo, veja Marcação de modelo para uma descrição detalhada de marcação.

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

Nome do ficheiro 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 }}",
}

Veja também

Marcação de modelo

Preencher a tradução com fonte

Added in version 4.11.

ID da extensão:

weblate.generate.prefill

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Atualização de componente, Diariamente

Preenche cadeias de tradução com a cadeia fonte.

Todos os textos não traduzidos no componente serão preenchidos com a cadeia fonte e marcados como necessita de edição. Use-o quando não puder ter cadeias vazias nos ficheiros de tradução. ..COMEÇO GERADO AUTOMATICAMENTE: weblate.generate.pseudolocale .. Esta secção é gerada automaticamente por ./manage.py list_addons. Não edite manualmente.

Geração da pseudolocalidade

Added in version 4.5.

ID da extensão:

weblate.generate.pseudolocale

Configuração:

source

Cadeias fonte

target

Tradução de destino

Todas as cadeias de carateres nesta tradução serão sobrescritas

prefix

Texto estático anexado

var_prefix

Texto da variável anexado

suffix

Texto estático acrescentado

var_suffix

Texto da variável acrescentado

var_multiplier

Multiplicador de texto variável

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

include_readonly

Incluir cadeias de apenas leitura

Gatilhos:

Instalação de extensões, Atualização de componente, Diariamente

Gera uma tradução ao adicionar automaticamente um prefixo e sufixo às cadeias fonte.

Pseudolocalidades são úteis para encontrar textos que não estão preparadas para localização. Isso é feito a alterar todas as cadeias fonte traduzíveis para facilitar a descoberta de textos inalterados ao executar a aplicação no idioma da pseudolocalidade.

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

A utilização das partes variáveis possibilita a procura por cadeias de carateres que podem não caber na interface do utilizador depois da tradução – isto estende o texto com base no comprimento da cadeia de carateres fonte. As partes variáveis são repetidas pelo comprimento do texto multiplicado pelo multiplicador. Por exemplo, Hello world com texto variável _ e multiplicador variável de 1 torna-se Hello world___________ – o texto é repetido uma vez para cada caráter na cadeia de carateres fonte.

As cadeias de carateres serão geradas segundo o padrão:

Prefixo de texto estático Prefixo de texto variável cadeia de carateres fonte Sufixo de texto variável Sufixo de texto estático

Dica

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

Dica

Pode usar esta extensão 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 a extensão. Exemplo: Se 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 a extensão depois de preencher a nova tradução para evitar que o Weblate altere as traduções feitas após a cópia.

Colaboradores em comentários

ID da extensão:

weblate.gettext.authors

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Pré-commit do repositório

Atualiza a parte do comentário no cabeçalho do ficheiro PO para incluir nomes de colaboradores e anos de contribuições.

O cabeçalho do ficheiro PO terá a seguinte aparência:

# Michal Čihař <michal@weblate.org>, 2012, 2018, 2019, 2020.
# Pavel Borecki <pavel@example.com>, 2018, 2019.
# Filip Hron <filip@example.com>, 2018, 2019.
# anonymous <noreply@weblate.org>, 2019.

Atualizar a variável ALL_LINGUAS no ficheiro «configure»

ID da extensão:

weblate.gettext.configure

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Diariamente, Repositório depois de adicionar, Repositório após remoção

Atualiza a variável ALL_LINGUAS nos ficheiros «configure», «configure.in» ou «configure.ac» quando é adicionada ou removida uma tradução.

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

Personalizar a saída gettext

Removed in version 5.13: Substituído por Parâmetros de formato de ficheiro.

Atualizar modelo gettext (Django)

Added in version 5.17.

ID da extensão:

weblate.gettext.django

Configuração:

interval

Atualizar frequência

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

Escolhas disponíveis:

daily

Diariamente

weekly

Semanalmente

monthly

Mensalmente

normalize_header

Normalizar cabeçalho POT

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

location_mode

Localizações de fonte

Escolha como a extração escreve localizações fonte para o ficheiro POT. Utilize isto para manter localizações no modelo enquanto que os omite dos ficheiros PO traduzidos.

Escolhas disponíveis:

file

Utilizar definições de formato de ficheiro

keep

Extrair localizações para o ficheiro POT

omit

Não extrair localizações

Gatilhos:

Instalação de extensões, Acionamento manual, Repositório depois da atualização

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.

A frequência de atualização selecionada aplica-se a execuções automáticas após atualizações de repositório. Instalar ou reconfigurar o extra executa-o imediatamente, e execuções manuais a partir da gestão de extras ou da API também ignora a frequência agendada. Após uma atualização bem sucedida, o Weblate submete o modelo alterado e recarrega as cadeias de carateres fonte.

The template update does not update translation PO files by itself. Keep Atualizar ficheiros PO para coincidir com 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 ficheiro LINGUAS

ID da extensão:

weblate.gettext.linguas

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Diariamente, Repositório depois de adicionar, Repositório após remoção

Atualiza o ficheiro LINGUAS quando é adicionada ou removida uma tradução.

Atualizar ficheiro POT (Meson)

Added in version 5.17.

ID da extensão:

weblate.gettext.meson

Configuração:

interval

Atualizar frequência

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

Escolhas disponíveis:

daily

Diariamente

weekly

Semanalmente

monthly

Mensalmente

normalize_header

Normalizar cabeçalho POT

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

location_mode

Localizações de fonte

Escolha como a extração escreve localizações fonte para o ficheiro POT. Utilize isto para manter localizações no modelo enquanto que os omite dos ficheiros PO traduzidos.

Escolhas disponíveis:

file

Utilizar definições de formato de ficheiro

keep

Extrair localizações para o ficheiro POT

omit

Não extrair localizações

comment_mode

Comentários do código

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

Escolhas disponíveis:

off

Não extrair comentários

all

Extrair todos os comentários

tagged

Extrair comentários com tag

comment_tag

Tag do comentário

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

checks

Verificações do xgettext

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

Escolhas disponíveis:

ellipsis-unicode

ellipsis-unicode

space-ellipsis

space-ellipsis

quote-unicode

quote-unicode

bullet-unicode

bullet-unicode

keyword

Palavra-chave adicional

Palavra-chave extra e opcional passada para xgettext usando –keyword.

keyword_exclusive

Use keywords exclusively

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

preset

Predefinição do Meson

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

Escolhas disponíveis:

glib

GLib

Gatilhos:

Instalação de extensões, Acionamento manual, Repositório depois da atualização

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.

A frequência de atualização selecionada aplica-se a execuções automáticas após atualizações de repositório. Instalar ou reconfigurar o extra executa-o imediatamente, e execuções manuais a partir da gestão de extras ou da API também ignora a frequência agendada. Após uma atualização bem sucedida, o Weblate submete o modelo alterado e recarrega as cadeias de carateres fonte.

The template update does not update translation PO files by itself. Keep Atualizar ficheiros PO para coincidir com 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.

Requisitos do Meson

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.

O diretório gettext é o diretório que contém o modelo configurado em Modelo para novas traduções. Tem que conter meson.build e POTFILES ou POTFILES.in. Um projeto Meson meson.build têm que estar presente nesse diretório ou em um dos seus diretórios parentes. Se ambos POTFILES e POTFILES.in existem, POTFILES é usado. Um POTFILES.skip adjacente exclui ficheiros fonte listados da extração.

Configure este extra a partir da configuração Meson gettext existente. Na maior parte dos projetos Meson, o diretório gettext é po/, o modelo deve o seu nome ao domínio gettext, e po/meson.build chama o ajudante do Meson gettext. Utilize o mesmo caminho de modelo em Modelo para novas traduções, por exemplo po/example.pot, e mantenha POTFILES ou POTFILES.in ao lado daquele ficheiro meson.build.

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 ficheiros MO

ID da extensão:

weblate.gettext.mo

Configuração:

path

Caminho do ficheiro MO gerado

Se não especificado, será utilizada a localização do ficheiro PO.

fuzzy

Incluir cadeias que necessitam edição

Entradas que necessitam edição (imprecisas) normalmente não estão prontas para uso como traduções.

Gatilhos:

Pré-commit do repositório

Gera automaticamente um ficheiro MO para cada ficheiro PO alterado.

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

Nota

Se uma tradução for removida, o seu ficheiro PO será eliminado do repositório, mas o ficheiro MO gerado por esta extensão não. O ficheiro MO deve ser removido da fonte manualmente.

Atualizar ficheiros PO para coincidir com POT (msgmerge)

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

ID da extensão:

weblate.gettext.msgmerge

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Repositório depois da atualização

Atualiza todos os ficheiros PO (conforme configurado por «Máscara de ficheiros») para coincidir com o ficheiro POT (conforme configurado por «Modelo para novas traduções») através de msgmerge.

Este extra é essencial ao trabalhar com ficheiros gettext PO onde o ficheiro POT (modelo) é enviado com novas cadeias de carateres ou mudanças para cadeias de carateres existentes. Quando o ficheiro POT é atualizado no repositório, este extra une automaticamente essas mudanças em todos os ficheiros de idioma PO, assegurando que:

  • New translatable strings appear in all languages

  • Cadeias de caracteres removidas são marcadas como obsoletas

  • 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 ficheiro POT (Sphinx)

Added in version 5.17.

ID da extensão:

weblate.gettext.sphinx

Configuração:

interval

Atualizar frequência

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

Escolhas disponíveis:

daily

Diariamente

weekly

Semanalmente

monthly

Mensalmente

normalize_header

Normalizar cabeçalho POT

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

location_mode

Localizações de fonte

Escolha como a extração escreve localizações fonte para o ficheiro POT. Utilize isto para manter localizações no modelo enquanto que os omite dos ficheiros PO traduzidos.

Escolhas disponíveis:

file

Utilizar definições de formato de ficheiro

keep

Extrair localizações para o ficheiro POT

omit

Não extrair localizações

filter_mode

Filtragem

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

Escolhas disponíveis:

none

Nenhum

weblate_docs

Documentação do Weblate

Gatilhos:

Instalação de extensões, Acionamento manual, Repositório depois da atualização

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.

A frequência de atualização selecionada aplica-se a execuções automáticas após atualizações de repositório. Instalar ou reconfigurar o extra executa-o imediatamente, e execuções manuais a partir da gestão de extras ou da API também ignora a frequência agendada. Após uma atualização bem sucedida, o Weblate submete o modelo alterado e recarrega as cadeias de carateres fonte.

The template update does not update translation PO files by itself. Keep Atualizar ficheiros PO para coincidir com 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.

Requisitos do Sphinx

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 ficheiro POT (xgettext)

Added in version 5.17.

ID da extensão:

weblate.gettext.xgettext

Configuração:

interval

Atualizar frequência

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

Escolhas disponíveis:

daily

Diariamente

weekly

Semanalmente

monthly

Mensalmente

normalize_header

Normalizar cabeçalho POT

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

location_mode

Localizações de fonte

Escolha como a extração escreve localizações fonte para o ficheiro POT. Utilize isto para manter localizações no modelo enquanto que os omite dos ficheiros PO traduzidos.

Escolhas disponíveis:

file

Utilizar definições de formato de ficheiro

keep

Extrair localizações para o ficheiro POT

omit

Não extrair localizações

comment_mode

Comentários do código

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

Escolhas disponíveis:

off

Não extrair comentários

all

Extrair todos os comentários

tagged

Extrair comentários com tag

comment_tag

Tag do comentário

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

checks

Verificações do xgettext

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

Escolhas disponíveis:

ellipsis-unicode

ellipsis-unicode

space-ellipsis

space-ellipsis

quote-unicode

quote-unicode

bullet-unicode

bullet-unicode

keyword

Palavra-chave adicional

Palavra-chave extra e opcional passada para xgettext usando –keyword.

keyword_exclusive

Use keywords exclusively

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

input_mode

Fonte de entrada

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

Escolhas disponíveis:

patterns

Padrões de ficheiro-fonte

potfiles

Manifesto POTFILES

language

Linguagem de xgettext

Linguagem de programação passado para o xgettext, por exemplo Python ou C. Deixe em branco para deixar o xgettext adivinhar a linguagem a partir das extensões dos ficheiros.

source_patterns

Padrões de ficheiro-fonte

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

potfiles_path

Caminho de POTFILES

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

Gatilhos:

Instalação de extensões, Acionamento manual, Repositório depois da atualização

Atualiza o modelo gettext usando xgettext nos ficheiros-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.

A frequência de atualização selecionada aplica-se a execuções automáticas após atualizações de repositório. Instalar ou reconfigurar o extra executa-o imediatamente, e execuções manuais a partir da gestão de extras ou da API também ignora a frequência agendada. Após uma atualização bem sucedida, o Weblate submete o modelo alterado e recarrega as cadeias de carateres fonte.

The template update does not update translation PO files by itself. Keep Atualizar ficheiros PO para coincidir com 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.

Requisitos xgettext

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.

Entradas em POTFILES ou POTFILES.in são resolvidas relativamente à raiz do repositório. Elas têm que ser caminhos relativos, permanecer dentro do repositório, e apontar para ficheiros existentes. Linhas em branco e linhas que começam com # são ignorados. Se um ficheiro POTFILES.skip existe ao lado do manifesto, as suas entradas são excluídas da extração.

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.

Comece a partir da extração da configuração do sistema de compilação neste extra. Projetos de ferramentas automáticas costumam guardar as entradas gettext em po/POTFILES.in e opções tal como o domínio gettext e xgettext marcadores em po/Makevars ou ficheiros Makefile.am relacionados. Utilize o modo de manifesto com o mesmo POTFILES.in quando as suas entradas são caminhos fonte simples relativos ao repositório, e copie o comportamento de extração relevante para as definições de extra, como por exemplo idioma, extração de comentário, verificações e palavras chave adicionais.

Para outros sistemas de compilação, use a lista de fontes ou o comando de extração que eles já executam como fonte de verdade. CMake, Makefiles personalizados, scripts npm, ou scripts de extração específicos do projeto frequentemente chamam xgettext diretamente ou geram uma lista de ficheiros intermédia. Configure padrões fonte para layouts simples, ou use modo manifesto quando o projeto mantém uma lista simples de ficheiros. Se um manifesto de compilação de sistema contém transformações ou prefixos que não são caminhos de ficheiros, converta-os para caminhos simples relativos ao repositório antes de os usar enquanto POTFILES.

Squash de commits git

ID da extensão:

weblate.git.squash

Configuração:

squash

Submeter com squash

Escolhas disponíveis:

all

Todos os commits num só

language

Por idioma

file

Por ficheiro

author

Por autor

append_trailers

Anexar linhas finalizadoras à mensagem do commit de squash

As linhas finalizadoras são linhas semelhantes aos cabeçalhos de e-mail RFC 822, no final de uma mensagem de commit de outra forma livre, como «Co-authored-by: …”.

commit_message

Mensagem de commit

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

Gatilhos:

Instalação de extensões, Repositório depois de submeter

Comprimir as submissões Git antes de enviar as alterações.

Dica

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

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

  • Todos os commits num só

  • Por idioma

  • Por ficheiro

  • Por autor

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 squash. Isso também gera crédito próprio Co-authored-by: para cada tradutor.

Personalizar a saída JSON

Alterado na versão 5.12: Adicionada a opção de Evitar espaços depois dos separadores.

Removed in version 5.13: Substituído por Parâmetros de formato de ficheiro.

Redefinir repositório para «upstream»

Added in version 5.17.

ID da extensão:

weblate.hosted.reset

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Diariamente

Limpa todas as alterações no repositório do Weblate todas as noites.

Formatar o ficheiro de propriedades Java

ID da extensão:

weblate.properties.sort

Configuração:

case_sensitive

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

Gatilhos:

Pré-commit do repositório

Formata e ordena o ficheiro de propriedades Java.

  • Consolida as novas de linhas para Unix.

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

  • Retira as linhas em branco e os comentários.

  • Ordena as cadeias de carateres pelas chaves.

  • Solta cadeias duplicadas.

Purga de comentários obsoletos

ID da extensão:

weblate.removal.comments

Configuração:

age

Dias a manter

Gatilhos:

Instalação de extensões, Diariamente

Definir um prazo para a remoção de comentários.

Isto pode ser útil para remover os comentários antigos que podem ter ficado desatualizados. Utilize com cuidado à medida que os comentários envelhecem e isso não significa que eles perderam a sua importância.

Purga de sugestões obsoletas

ID da extensão:

weblate.removal.suggestions

Configuração:

age

Dias a manter

votes

Limites de votação

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

Gatilhos:

Instalação de extensões, Diariamente

Definir um prazo para 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 num determinado período de tempo.

Atualizar ficheiros RESX

ID da extensão:

weblate.resx.update

Configuração:

Esta extensão não tem configuração.

Gatilhos:

Instalação de extensões, Repositório depois da atualização

Atualize todos os ficheiros de tradução para que correspondam ao ficheiro base monolingue original. As cadeias de carateres não utilizadas são removidas, e adicionadas novas como cópias da cadeia de carateres fonte.

Dica

Use Limpeza de ficheiros de tradução se só quiser remover chaves de tradução obsoletas.

Slack Webhooks

Added in version 5.12.

ID da extensão:

weblate.webhook.slack

Configuração:

webhook_url

URL do Webhook

event_filter

Eventos de alteração a ativar

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

events

Eventos de alteração selecionados

Eventos de alteração selecionados

Gatilhos:

Alteração de evento

Envia uma notificação para o canal Slack baseado nos eventos elecionados.

Aviso

O conteúdo da notificação poderá mostrar etiquetas HTML. Isto é um problema conhecido que será endereçado brevemente; consulte 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

Added in version 5.11.

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

ID da extensão:

weblate.webhook.webhook

Configuração:

webhook_url

URL do Webhook

secret

Segredo de Webhook

O segredo de Webhooks Padrão é uma cadeia de carateres codificada em base64.

event_filter

Eventos de alteração a ativar

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

events

Eventos de alteração selecionados

Eventos de alteração selecionados

Gatilhos:

Alteração de evento

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

O conteúdo da requisição segue o esquema Weblate Messaging. O campo de action utiliza o nome de ação listado em Eventos de alteração selecionados. A descrição OpenAPI também encontra-se em /api/docs/. Exemplo de corpo de requisição:

{
   "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 a cadeia secret, o payload da solicitação, o webhook-timestamp e o webhook-id. Isto 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 um pedido, pode utilizar o método Webhook.verify da biblioteca standardwebhooks ou uma implementação da «Standard Webhooks Specification».

Extras obsoletos

Personalizar a saída de XML

Added in version 4.15.

Removed in version 5.13: Substituído por Parâmetros de formato de ficheiro.

Personalizar a saída YAML

Removed in version 5.13: Substituído por Parâmetros de formato de ficheiro.

Parâmetros adicionais comuns

Motores de tradução automática

Escolhas disponíveis:

alibaba

Alibaba

aws

Amazon Translate

anthropic

Anthropic

apertium-apy

Apertium APy

microsoft-translator

Tradutor IA da Azure

azure-openai

Modo Zen

baidu

Baidu

cyrtranslit

CyrTranslit

deepl

DeepL

glosbe

Glosbe

google-translate-api-v3

Tradução avançada do Google Cloud

google-translate

Tradução básica do Google Cloud

ltengine

LTEngine

libretranslate

LibreTranslate

mistral

Mistral

modernmt

ModernMT

mymemory

MyMemory

netease-sight

Netease Sight

ollama

Ollama

openai

OpenAI

sap-translation-hub

SAP Translation Hub

systran

Systran

weblate

Weblate

weblate-translation-memory

Weblate Translation Memory

yandex

Yandex

yandex-v2

Yandex v2

youdao-zhiyun

Youdao Zhiyun

tmserver

tmserver

Formato de ficheiro

Escolhas disponíveis:

apple-xliff

XLIFF 1.2 com extensões Apple

appstore

Ficheiros de metadados da App Store

arb

Ficheiro ARB

aresource

Recurso de Cadeias do Android

asciidoc

Ficheiro AsciiDoc

ass

Ficheiro de legendas Advanced Substation Alpha

catkeys

Haiku catkeys

cmp-resource

Compor Recurso Multiplataforma

csv

Ficheiro CSV

csv-multi

Ficheiro CSV com vários valores

csv-simple

Ficheiro CSV simples

dokuwiki

Ficheiros de texto DokuWiki

dtd

Ficheiro DTD

flatxml

Ficheiro XML plano

fluent

Ficheiro fluente

formatjs

Ficheiro Format.JS JSON

go-i18n-json

Ficheiro JSON go-i18n v1

go-i18n-json-v2

Ficheiro JSON go-i18n v2

go-i18n-toml

Ficheiro go-i18n TMOL

gotext

Ficheiro de gotext JSON

gwt

Propriedades GWT

html

Ficheiro HTML

i18next

Ficheiro i18next JSON v3

i18nextv4

Ficheiro i18next JSON v4

idml

Ficheiro IDML

ini

Ficheiro INI

islu

Ficheiro INI de Inno Setup

joomla

Ficheiro de idioma Joomla

json

Ficheiro JSON

json-nested

Ficheiro de estrutura integrada JSON

laravel

Cadeias de carateres de PHP Laravel

markdown

Ficheiro Markdown

mdx

Ficheiro MDX

mediawiki

Ficheiro de texto MediaWiki

mi18n-lang

@draggable/i18n ficheiro de idioma

moko-resource

Recurso Mobile Kotlin

nextcloud-json

Ficheiro JSON Nextcloud

odf

Ficheiro de OpenDocument

php

Cadeias de carateres de PHP

plainxliff

Ficheiro 1.2 de tradução XLIFF

po

Ficheiro gettext PO

po-mono

Ficheiro gettext PO (monolingue)

poxliff

XLIFF 1.2 com extensões gettext

properties

Propriedades de Java

rc

Ficheiro RC

resjson

Ficheiro RESJSON

resourcedictionary

Ficheiro ResourceDictionary

resx

Ficheiro de recursos .Net

ruby-yaml

Ficheiro Ruby YAML

srt

Ficheiro de legendas SubRip

ssa

Ficheiro de legendas Substation Alpha

strings

Cadeias de iOS

stringsdict

Ficheiro de stringsdict

sub

Ficheiro de legendas MicroDVD

tbx

Ficheiro de TermBase eXchange

toml

Ficheiro TOML

ts

Ficheiro de tradução Qt Linguist

txt

Ficheiros de texto simples

webextension

Ficheiro WebExtension JSON

wxl

Ficheiro WixLocalization

xliff

XLIFF 1.2 com suporte transponível

xliff2

Ficheiro tradução 2.0 XLIFF

xliff2-placeables

Ficheiro de tradução XLIFF 2.0 com suporte de colocáveis

xlsx

Excel Open XML

xwiki-fullpage

XWiki Full Page

xwiki-java-properties

XWiki Java Properties

xwiki-page-properties

XWiki Page Properties

yaml

Ficheiro YAML

Eventos de alteração a ativar

Escolhas disponíveis:

content

Eventos de conteúdo de tradução

all

Todos os eventos de alteração

custom

Eventos de alteração selecionados

Eventos de alteração selecionados

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

Escolhas disponíveis:

Id.

Identificador

Nome

Descrição

0

resource_updated

Recurso atualizado

Um ficheiro de tradução foi sincronizado com o seu repositório.

1

translation_completed

Tradução concluída

Um idioma de tradução tornou-se completamente traduzido após uma edição individual . Tradução automática, envios, e edições em massa não emitem este evento.

2

translation_changed

Tradução alterada

Uma tradução existente foi editada por um utilizador.

3

comment_added

Comentário adicionado

Um comentário foi adicionado à cadeia de carateres.

4

suggestion_added

Sugestão adicionada

Uma sugestão de tradução foi adicionada.

5

translation_added

Tradução adicionada

Uma cadeia de carateres previamente não traduzida foi traduzida por um utilizador.

6

automatically_translated

Traduzido automaticamente

Uma tradução foi adicionada ou mudada pela tradução automática. Isto é emitido em vez de Tradução adicionada ou Tradução mudada.

7

suggestion_accepted

Sugestão aceite

Uma sugestão de tradução foi aceite como a tradução.

8

translation_reverted

Tradução revertida

Uma tradução foi restaurada para um valor anterior.

9

translation_uploaded

Tradução enviada

Uma tradução foi adicionada ou mudada por um envio de ficheiro de tradução. Isto é emitido em vez de Tradução adicionada ou Tradução mudada.

13

source_string_added

Cadeia de carateres fonte adicionada

Uma cadeia de carateres fonte foi adiciona fora do repositório ou das atualizações enviadas.

14

component_locked

Componente bloqueado

Um componentes foi bloqueado para tradução.

15

component_unlocked

Componente desbloqueado

Um componente foi desbloqueado para tradução.

17

changes_committed

Alterações submetidas

Mudanças de componente pendentes foram enviadas.

18

changes_pushed

Alterações enviadas

Mudanças de repositório foram enviadas para a fonte.

19

repository_reset

Redefinição do repositório

Um repositório foi reiniciado para o seu estado fonte.

20

repository_merged

Repositório unido

As mudanças do repositório fonte foram mescladas.

21

repository_rebased

Repositório rebaseado

As mudanças de Repositório foram rebased na fonte.

22

repository_merge_failed

A união do repositório falhou

A união de mudanças do repositório fonte falhou.

23

repository_rebase_failed

Falha na rebase do repositório

O rebase de mudanças do repositório falhou.

24

parsing_failed

A análise falhou

O Weblate não conseguiu analisar o ficheiro de tradução.

25

translation_removed

Tradução removida

O idioma de tradução foi removido.

26

suggestion_removed

Sugestão removida

A sugestão de tradução foi removida.

27

translation_replaced

Tradução substituída

A tradução foi mudada por uma operação de pesquisa e substituição. Isto é emitido em vez da Tradução mudada.

28

repository_push_failed

O envio para o repositório falhou

O envio de mudanças para o repositório fonte falhou.

29

suggestion_removed_during_cleanup

Sugestão removida durante a limpeza

Uma sugestão de tradução obsoleta foi removida durante a limpeza.

30

source_string_changed

Cadeia de carateres fonte alterada

A cadeia de carateres fonte foi editada no Weblate.

31

string_added

Cadeia de carateres adicionada

Uma cadeia de carateres nova foi adicionada no Weblate.

32

bulk_status_changed

Alterado estados em massa

O estado da tradução de uma ou mais cadeias de carateres foram mudadas em massa.

33

visibility_changed

Visibilidade alterada

A visibilidade de projeto ou componente foi mudada.

34

user_added

Utilizador adicionado

Garantido acesso a um utilizador.

35

user_removed

Utilizador removido

O acesso de um utilizador foi removido.

36

translation_approved

Tradução aprovada

Uma tradução foi aprovada durante revisão.

37

marked_for_edit

Marcada para edição

Uma tradução foi marcada como necessitando de edição.

38

component_removed

Componente removido

O componente de tradução foi removido.

39

project_removed

Projeto removido

Um projeto de tradução foi removido.

41

project_renamed

Projeto renomeado

Um projeto de tradução foi renomeado.

42

component_renamed

Componente renomeado

Um componente de tradução foi renomeado.

43

moved_component

Componente movido

Um componente foi movido para dentro de um projeto.

45

contributor_joined

Colaborador aderiu

Um utilizador fez a sua primeira contribuição para uma tradução.

46

announcement_posted

Anúncio publicado

Um anúncio foi publicado.

47

alert_triggered

Alerta acionado

Um alerta de componente foi ativado.

48

language_added

Idioma adicionado

Uma linguagem de tradução foi adicionada.

49

language_requested

Idioma solicitado

Um utilizador pediu um novo idioma.

50

project_created

Projeto criado

Um projeto de tradução foi criado.

51

component_created

Componente criado

Um componente de tradução foi criado.

52

user_invited

Utilizador convidado

Um utilizador foi convidado para um projeto.

53

repository_notification_received

Notificação de repositório recebida

O Weblate recebeu uma notificação de repositório de um alojamento de código.

54

translation_replaced_file_by_upload

Ficheiro de tradução substituído pelo envio

Um ficheiro de tradução foi substituído por um ficheiro enviado.

55

license_changed

Licença alterada

A informação de licença de projeto ou componente mudou.

56

contributor_license_agreement_changed

Acordo da licença de colaborador alterado

O acordo de licença de colaborador foi mudado.

57

screenshot_added

Captura do ecrã adicionada

Uma captura de ecrã foi associada com uma cadeia de carateres.

58

screenshot_uploaded

Captura de ecrã enviada

Uma captura de ecrã foi enviada.

59

string_updated_in_the_repository

Cadeia de carateres atualizada no repositório

Uma cadeia de carateres foi mudada ao sincronizar a partir do repositório.

60

add-on_installed

Extra instalado

Um extra foi instaldo.

61

add-on_configuration_changed

Configuração do extra alterada

Uma configuração de extra foi mudada.

62

add-on_uninstalled

Extra desinstalado

Um extra foi desinstalado.

63

string_removed

Cadeia de carateres removida

Uma cadeia de carateres foi removida de uma tradução.

64

comment_removed

Comentário removido

Um comentário de cadeia de carateres foi removida.

65

comment_resolved

Comentário resolvido

Um comentário de cadeia de carateres foi marcado como resolvido.

66

explanation_updated

Explicação atualizada

A explicação para uma cadeia de carateres fonte foi atualizada.

67

category_removed

Categoria removida

Uma categoria de componente foi removida.

68

category_renamed

Categoria renomeada

Uma categoria de componente foi renomeada.

69

category_moved

Categoria movida

Uma categoria de componente foi movida.

70

saving_string_failed

Falha ao guardar a cadeia de carateres

O Weblate não conseguiu guardar uma cadeia de carateres alterada.

71

string_added_in_the_repository

Cadeia de carateres adicionada ao repositório

Uma nova cadeia de carateres foi encontrada durante a sincronização a partir do repositório.

72

string_updated_in_the_upload

Cadeia de carateres atualizada no envio

Uma cadeia de carateres foi mudada durante o processamento de um ficheiro enviado.

73

string_added_in_the_upload

Cadeia de carateres adicionada no envio

Uma nova cadeia de carateres foi encontrada durante o processamento de um ficheiro enviado.

74

translation_updated_by_source_upload

Tradução atualizada pelo envio da fonte

Uma tradução foi sincronizada após o envio de um ficheiro fonte.

75

component_translation_completed

Tradução de componentes concluída

Todas as traduções de idioma em um componente tornam-se completamente traduzidas após uma edição individual. Tradução automática, envios, e edições em massa não emitem este evento.

76

applied_enforced_check

Verificação forçada aplicada

Uma tradução foi marcada como necessitando de edição por uma verificação obrigatória.

77

propagated_change

Alteração propagada

A edição de tradução foi propagada para outra cadeia de carateres correspondente.

78

file_uploaded

Ficheiro enviado

Um ficheiro foi enviado para uma tradução.

79

extra_flags_updated

Sinalizações extra atualizadas

Marcadores de cadeia de carateres fonte adicionais foram atualizados.

80

font_uploaded

Tipo de letra enviado

Uma fonte foi enviada.

81

font_changed

Tipo de letra alterado

Uma fonte enviada foi alterada.

82

font_removed

Tipo de letra removido

Uma fonte enviada foi removida.

83

forced_synchronization_of_translations

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

Ficheiros de tradução foram sincronizadas forçosamente com o repositório.

84

forced_rescan_of_translations

Reverificação forçada das traduções

Ficheiros de tradução foram analisados forçosamente por mudanças.

85

screenshot_removed

Captura de ecrã removida

Uma captura de ecrã foi removida.

86

label_added

Etiqueta adicionada

Uma etiqueta foi adiciona a uma cadeia de carateres.

87

label_removed

Etiqueta removida

Uma etiqueta foi removida de uma cadeia de carateres.

88

repository_cleanup

Limpeza do repositório

A árvore de trabalho do repositório foi limpa.

89

source_string_added_in_the_upload

Cadeia fonte adicionada no envio

Uma cadeia de carateres fonte foi adicionada durante o processamento de um ficheiro enviado.

90

source_string_added_in_the_repository

Cadeia fonte adicionada no repositório

Uma cadeia de carateres fonte foi adicionada durante a sincronização a partir do repositório.

91

project_backed_up

Cópia de segurança do projeto feita

Uma cópia de segurança do projeto foi criada.

92

project_restored

Projeto restaurado

Um projeto foi restaurado a partir de uma cópia de segurança.

93

component_restored

Componente restaurado

Um componentes foi restaurado a partir de uma cópia de segurança.

94

user_edit_reverted

Edição de utilizador revertida

Todas as edições selecionadas por um utilizador foram revertidas.

95

project_setting_changed

Definição de projeto alterada

Uma definição de projeto foi alterada.

96

component_setting_changed

Definição de componente alterada

Uma definição de componente foi alterada.

97

user_access_changed

O acesso do utilizador foi alterado

As permissões de acesso de utilizador foram alteradas.

98

workspace_created

Espaço de trabalho criado

Um espaço de trabalho foi criado.

99

workspace_setting_changed

Definição de espaço de trabalho mudado

Uma definição de espaço de trabalho foi alterada.

100

project_moved

Projeto movido

Um projeto foi movido para dentro ou fora de um espaço de trabalho.

101

remote_repository_updated

Repositório remoto atualizado

Uma atualização de repositório remoto foi completado.

102

remote_repository_update_failed

Falha na atualização do repositório remoto

A atualização de um repositório remoto falhou.

103

alert_dismissed

Alert dismissed

A component alert was dismissed.

104

alert_reopened

Alert reopened

A component alert was reopened after its context changed.

Personalizando a lista de extensões

A lista de extensões é configurada por WEBLATE_ADDONS. Para adicionar outra extensão, basta incluir o nome absoluto da classe nesta configuração.

Escrevendo extensões

Também pode escrever as suas próprias extensões. Crie uma subclasse de weblate.addons.base.BaseAddon para definir os metadados da extensão e, depois, implemente uma função de retorno que vai realizar o processamento.

Veja também

Desenvolver extensões

Escrevendo scripts para extensões

Extensões também podem ser usadas para executar scripts externos. Isso costumava estar integrado no Weblate, mas agora tem que escrever algum código para embrulhar o seu script com uma extensão.

# 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, veja Verificações de qualidade personalizadas, sugestões automáticas, extensões e correções automáticas.

repositório VCS para qualquer componente.

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

WL_VCS

Sistema de controlo de versão usado.

WL_REPO

URL do repositório principal.

WL_PATH

Caminho absoluto ao repositório VCS.

WL_BRANCH

Ramo do repositório configurado no componente atual.

WL_FILEMASK

Máscara de ficheiro para componente atual.

WL_TEMPLATE

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

WL_NEW_BASE

Nome do ficheiro usado para criar traduções (pode estar vazio).

WL_FILE_FORMAT

Formato de ficheiro 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 de projeto usado para construir a URL.

WL_COMPONENT_NAME

Nome de componente.

WL_PROJECT_NAME

Nome do projeto.

WL_COMPONENT_URL

URL do componente.

WL_ENGAGE_URL

URL de engajamento do projeto.

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

Pode ser utilizado para atualizar os ficheiros de tradução quando a fonte VCS fonte altera. Para conseguir isto, por favor, lembre-se que o Weblate só vê fcheiros submetidos para VCS, por isso precisa de submeter as alterações como parte do “”script””.

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

#! /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.

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

Registo de atividades complementares

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

Cada entrada grava se o processamento está pendente,bem sucedido, falhou, ou foi ignorado. Entradas ignoradas incluem a razão pela qual o extra não executou, como por exemplo um componente incompatível, nenhuma mudança relevante, ou um agendamento configurado cujo prazo ainda não terminou. Uma entrada bem sucedida ainda pode significar que o extra verificou as suas entradas mas não encontrou nada a mudar.

Para extras de âmbito abrangente que processam componentes independentemente, o registo de atividade contém uma entrada separada para cada componente.

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