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ções ↓ Extras 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.
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¶
Ativado quando um extra é executado manualmente a partir de gestão de extra ou da 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¶
Ativado mesmo após uma tradução ser removida.
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¶
Ativado após a cadeia de carateres ser sincronizada com o 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:
modeModo de tradução automático
Escolhas disponíveis:¶ suggestAdicionar como sugestão
translateAdicionar como tradução
fuzzyAdicionar como «Precisa de edição»
qConsulta
Por favor, note que a tradução de todas as cadeias de carateres irá rejeitar 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
Introduza a lesma de um componente para utilizar como fonte, deixe em branco para utilizar todos os componentes no projeto atual.
enginesMotores de tradução automática
thresholdLimite 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:
thresholdLimiar de tradução
A percentagem de cadeias de carateres traduzidas que devem estar presentes para que a tradução seja incluída.
css_selectorSeletor de CSS
Seletor CSS para detetar elementos localizáveis.
cookie_nameNome do cookie do idioma
Nome do cookie que armazena a preferência de idioma.
filesExtrair 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.
Para uma limpeza única de um ficheiro de tradução individual, utilize Limpar inutilizadas em Manutenção do repositório nessa tradução em vez de instalar o extra.
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
Os componentes partilhados de outros projetos não são considerados nisto.
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:
matchExpressão regular para corresponder ficheiros de tradução
The regular expression must define a named group for component. Also define a named group for language when matching translation files. When the file mask is set, omit language and match the monolingual base or new base file instead.
file_formatFormato de ficheiro
name_templatePersonalizar nome do componente
Utiliza a sintaxe de modelo do Django. Este modelo deve incluir {{ component }}.
base_file_templateDefinir nome do ficheiro base monolingue
Deixe em branco para os ficheiros de tradução bilingue. Quando definido, este modelo deve incluir {{ component }}.
new_base_templateDefina 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_templateFicheiro 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 }}.
filemask_templateDefine the file mask
Leave empty to match translation files directly. When set, discovery matches the monolingual base or new base file and uses this template as the file mask. Include a language wildcard and {{ component }}, for example locale//{{ component }}.po or docs/{{ component }}_.md.
language_regexFiltro de idioma
Expressão regular para filtrar ficheiros de tradução ao examinar por uma máscara de ficheiros.
copy_addonsClonar extensões do componente principal para os recém-criados
removeRemover componentes para os ficheiros inexistentes
- Gatilhos:
Adiciona ou remove automaticamente componentes do projeto com base em alterações de ficheiros no sistema de controlo 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.
Requisitos de descoberta¶
Para descobrir um componente de forma bem sucedida, a configuração tem que fazer todas as opções seguintes:
The regular expression must define a
componentnamed group. Matching translation files also requires alanguagenamed group.Campos de modelo usado para nomear ou localizar ficheiros por componente devem incluir
{{ component }}, para que o valor renderizado mude verdadeiramente para cada componente descoberto.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.
Exemplo trabalhado: news_<lang>.md¶
Este é um modelo comum de variantes linguísticas baseado no nome do ficheiro:
docs/news_en.mddocs/news_cs.mddocs/guide_en.md
Utilize a predefinição Variantes de idioma baseados em nome de ficheiro para um ponto de começo, depois escolha o formato de ficheiro correspondente e reveja os valores populados.
- Expressão regular:
(?:(?P<path>.*/))?(?P<component>.+?)_(?P<language>[A-Za-z]{2,3}(?:[_-][A-Za-z0-9]+)*)\.(?P<extension>[^/.]+)- Nome do componente:
{{ component }}- Máscaras de ficheiros descobertos:
docs/news_*.mddocs/guide_*.md
Neste exemplo, {{ component }} resulta no nome de ficheiro base antes do sufixo de idioma, por isso docs/news_en.md, docs/news_pt_BR.md, e docs/news_pt-BR.md tornam-se todos no componente news.
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:
Exemplos de descoberta de componentes¶
O exemplo trabalhado acima abrange o layout de variantes mais comum, baseado no nome do ficheiro. Os exemplos seguintes mostram outras estruturas de repositório nas quais pode corresponder.
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.pocs/website.pode/application.pode/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.polocale/cs/LC_MESSAGES/website.polocale/de/LC_MESSAGES/application.polocale/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.posrc/locale/website.cs.posrc/locale/application.de.posrc/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.polocale/cs/website/cs.polocale/de/application/de.polocale/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.xmlres/values-cs/strings-help.xmlres/values-de/strings-about.xmlres/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.propertiesparent/module1/submodule/src/main/resources/ApplicationResource_es.propertiesparent/module2/src/main/resources/ApplicationResource_de.propertiesparent/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ções ↓ Definições ↓ Sistema 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.
Veja também
Fedora Messaging¶
Added in version 5.15.
- ID da extensão:
weblate.fedora_messaging.publish- Configuração:
amqp_urlURL do intermediário AMQP
O URL do intermediário do AMQP para se ligar.
topic_prefixPrefixo de tópico
Prefixo opcional a adicionar à frente de tópicos de mensagens gerados.
publish_timeoutTempo de limite da publicação
Quantos segundos a esperar pela confirmação da entrega do intermediário.
connection_attemptsTentativas de conexão
Quantas vezes tentar estabelecer ligação ao intermedário.
retry_delayAtraso da repetição
Quantos segundos a esperar entre tentativas de conexão.
ca_certConjunto de certificados CA (PEM)
Cole apenas blocos de certificados, cada um começado por «—–BEGIN CERTIFICATE—–» e terminado por «—–END CERTIFICATE—–«.
client_keyChave de cliente privada (PEM)
Cole um único bloco de chave privada PEM não encriptada. Chaves privadas encriptadas não são suportadas.
client_certCertificado de cliente (PEM)
Cole apenas blocos de certificado PEM começados por «—–BEGIN CERTIFICATE—–»; não cole o resultado de «openssl x509 -text».
event_filterEventos de alteração a ativar
Escolha quais eventos de alteração devem ativar este extra. Eventos de alteração a ativar
eventsEventos de alteração selecionados
- Gatilhos:
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.
Por exemplo, o evento de cópia de segurança do projeto para o projeto website utiliza weblate.project_backed_up.website. Uma alteração de tradução no projeto website, componente frontend, e tradução checa utiliza weblate.translation_changed.website.frontend.cs. A mesma alteração o componente frontend dentro das categorias parent e child utiliza weblate.translation_changed.website.parent.child.frontend.cs.
Corpo da mensagem¶
O corpo consiste dos seguintes campos (dado que os mesmos estão disponíveis para o evento):
change_idID numérico da alteração
actionNome completo da alteração.
timestampRegisto de data/hora em formato ISO
targetNovo valor da alteração (por exemplo, nova tradução do texto)
oldValor antigo da alteração (p. ex. tradução anterior da cadeia)
sourceCadeia fonte.
urlURL absoluto para visualizar o objeto relacionado.
authorNome de utilizador do autor (pode ser diferente do utilizador, por exemplo, ao aceitar sugestões)
userNome de utilizador provisório
projectAbreviação do projeto
componentAbreviação do componente
translationCódigo de idioma de tradução
Cabeçalhos de mensagem¶
Há cabeçalhos adicionais os quais também pode utilizar para roteamento:
actionNome completo da alteração.
projectAbreviação do projeto
componentAbreviação do componente
Mensagens de exemplo¶
Evento de união de repositório:
{
"id": 1,
"action": "Merged repository",
"timestamp": "2017-06-15T11:30:47.325000+00:00",
"url": "http://example.com/projects/test/test/",
"component": "test"
}
Novo evento de cadeia de carateres fonte:
{
"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"]
}
Evento de atualização de recurso:
{
"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"
}
Evento de eliminação de projeto:
{
"id": 9,
"action": "Removed project",
"timestamp": "2019-10-17T15:57:08.559420+00:00",
"target": "test",
"user": "testuser"
}
Novo evento de colaborador:
{
"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"]
}
Nova evento de tradução:
{
"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"]
}
Veja também
Edição em massa¶
- ID da extensão:
weblate.flags.bulk- Configuração:
qConsulta
stateEstado a definir
Escolhas disponíveis:¶ -1Não alterar
10Precisa de edição
11Precisa de edição (Precisa de reescrita)
12Precisa de edição (Precisa de verificação)
20Traduzido
30Aprovadas
add_flagsBandeiras de tradução para adicionar
remove_flagsBandeiras de tradução para remover
add_labelsEtiqueta a adicionar
remove_labelsEtiquetas a remover
- Gatilhos:
Edição em série de marcadores, etiquetas, ou estados das cadeias de carateres.
Exemplos::
Consulta de pesquisa |
|
|---|---|
Etiqueta a adicionar |
recente |
Consulta de pesquisa |
|
|---|---|
Bandeiras de tradução para adicionar |
|
Consulta de pesquisa |
|
|---|---|
Bandeiras de tradução para adicionar |
|
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:
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
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:
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
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:
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
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:
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
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:
filenameNome do ficheiro gerado
templateConteúdo do ficheiro gerado
- Gatilhos:
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
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:
sourceCadeias fonte
targetTradução de destino
Todas as cadeias de carateres nesta tradução serão sobrescritas
prefixTexto estático anexado
var_prefixTexto da variável anexado
suffixTexto estático acrescentado
var_suffixTexto da variável acrescentado
var_multiplierMultiplicador de texto variável
Quantas vezes repetir o texto da variável, dependendo do comprimento da cadeia fonte.
include_readonlyIncluir 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:
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.
Atualiza a variável ALL_LINGUAS em ficheiros configure, configure.in ou configure.ac, quando uma tradução é adicionada ou removida.
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:
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o ficheiro POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiariamente
weeklySemanalmente
monthlyMensalmente
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocalizaçõ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:¶ fileUtilizar definições de formato de ficheiro
keepExtrair localizações para o ficheiro POT
omitNã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.
Este extra atualiza o modelo configurado em Modelo para novas traduções. Está disponível para componentes gettext PO, e o componente deve definir um modelo para novas traduções.
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.
Esta atualização de modelo não atualiza ficheiros PO de tradução por si mesmo. Mantenha Atualizar ficheiros PO para coincidir com POT (msgmerge) instalado quando a tradução de ficheiros deve seguir alterações de modelo automaticamente. O formulário de instalação para este extra pode instalar tal extra, mas definições de extra existentes não mostram essa opção de instalação novamente.
Requisitos do Django¶
Este extra requer xgettext e msguniq. Executa o invólucro de extração interno do Weblate para mensagens Django em vez de invocar o manage.py makemessages de um projeto, e por isso não carrega definições Django do projeto ou aplicações.
O modelo para novas traduções devem usar o domínio django ou djangojs. Nomes de modelos suportados são django.pot, djangojs.pot, django.po, e djangojs.po. O Weblate infere o diretório fonte a partir do caminho do modelo e ignora os diretórios de tradução do repositório durante a extração.
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:
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o ficheiro POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiariamente
weeklySemanalmente
monthlyMensalmente
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocalizaçõ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:¶ fileUtilizar definições de formato de ficheiro
keepExtrair localizações para o ficheiro POT
omitNão extrair localizações
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.
checksVerificações do xgettext
Validação adicional do xgettext a ativar para mensagens extraídas.
Escolhas disponíveis:¶ ellipsis-unicodeellipsis-unicode
space-ellipsisspace-ellipsis
quote-unicodequote-unicode
bullet-unicodebullet-unicode
keywordAdditional keywords
Newline-separated extra keywords passed to xgettext using –keyword.
keyword_exclusiveUtilizar palavras chave exclusivamente
Quando ativo, passa
--keywordsem um valor para o xgettext antes da palavra chave adicional, desativando todas as palavras chave predefinidas para que apenas a palavra chave especificada acima seja reconhecida.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
- 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.
Este extra atualiza o modelo configurado em Modelo para novas traduções. Está disponível para componentes gettext PO, e o componente deve definir um modelo para novas traduções.
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.
Esta atualização de modelo não atualiza ficheiros PO de tradução por si mesmo. Mantenha Atualizar ficheiros PO para coincidir com POT (msgmerge) instalado quando a tradução de ficheiros deve seguir alterações de modelo automaticamente. O formulário de instalação para este extra pode instalar tal extra, mas definições de extra existentes não mostram essa opção de instalação novamente.
Requisitos do Meson¶
Este extra requer xgettext; não invoca Meson. Segue convenções Meson gettext ao ler POTFILES ou POTFILES.in a partir do diretório gettext e ao passar a palavra chave GLib e o marcador de formato predefinido para 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.
O Weblate não lê a lista de ficheiros fonte a partir de meson.build. Utiliza POTFILES ou POTFILES.in, que corresponde à convenção gettext do Meson. Quando o projeto Meson utiliza um diretório ou domínio gettext não predefinido, espelhe esse layout no caminho de modelos de componente.
Gerar ficheiros MO¶
- ID da extensão:
weblate.gettext.mo- Configuração:
pathCaminho do ficheiro MO gerado
Se não especificado, será utilizada a localização do ficheiro PO.
fuzzyIncluir cadeias que necessitam edição
Entradas que necessitam edição (imprecisas) normalmente não estão prontas para uso como traduções.
- Gatilhos:
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: A configuração Definições foi movida para Parâmetros de formato de ficheiro.
- ID da extensão:
weblate.gettext.msgmerge- Configuração:
Esta extensão não tem configuração.
- Gatilhos:
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:
Cadeias de carateres novas traduzíveis aparecem em todos os idiomas
Cadeias de caracteres removidas são marcadas como obsoletas
Cadeias de carateres modificadas são marcadas como necessitando de revisão (impreciso)
A maioria das opções da linha de comandos de msgmerge podem ser definidas através de configuração de parâmetros de formato de ficheiro. Ative o parâmetro po_remove_obsolete para remover entradas #~ quando ficheiros PO são guardados.
Atualizar ficheiro POT (Sphinx)¶
Added in version 5.17.
- ID da extensão:
weblate.gettext.sphinx- Configuração:
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o ficheiro POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiariamente
weeklySemanalmente
monthlyMensalmente
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocalizaçõ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:¶ fileUtilizar definições de formato de ficheiro
keepExtrair localizações para o ficheiro POT
omitNão extrair localizações
filter_modeFiltragem
Opcionalmente, remove cadeias que não são úteis para traduzir após a extração de Sphinx.
Escolhas disponíveis:¶ noneNenhum
weblate_docsDocumentaçã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.
Este extra atualiza o modelo configurado em Modelo para novas traduções. Está disponível para componentes gettext PO, e o componente deve definir um modelo para novas traduções.
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.
Esta atualização de modelo não atualiza ficheiros PO de tradução por si mesmo. Mantenha Atualizar ficheiros PO para coincidir com POT (msgmerge) instalado quando a tradução de ficheiros deve seguir alterações de modelo automaticamente. O formulário de instalação para este extra pode instalar tal extra, mas definições de extra existentes não mostram essa opção de instalação novamente.
Requisitos do Sphinx¶
Este extra requer sphinx-build, fornecido pela instalação do extra sphinx. O modelo para novas traduções deve ser um ficheiro .pot sob o diretório locales. O diretório antes do locales é usado enquanto diretório fonte para o Sphinx e deve conter conf.py.
Extração utiliza a configuração do Sphinx incluída no Weblate e não carrega a configuração do projeto. O Weblate executa o construtor gettext do Sphinx, normaliza referências fonte para caminhos relativos ao diretório fonte, e copia o modelo gerado de volta para o caminho de modelos configurado.
Atualizar ficheiro POT (xgettext)¶
Added in version 5.17.
- ID da extensão:
weblate.gettext.xgettext- Configuração:
intervalAtualizar frequência
Com que frequência o complemento deve atualizar o ficheiro POT quando o componente for restaurado.
Escolhas disponíveis:¶ dailyDiariamente
weeklySemanalmente
monthlyMensalmente
normalize_headerNormalizar cabeçalho POT
Atualiza os cabeçalhos gettext e substitui os espaço reservado em comentários do POT.
location_modeLocalizaçõ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:¶ fileUtilizar definições de formato de ficheiro
keepExtrair localizações para o ficheiro POT
omitNão extrair localizações
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.
checksVerificações do xgettext
Validação adicional do xgettext a ativar para mensagens extraídas.
Escolhas disponíveis:¶ ellipsis-unicodeellipsis-unicode
space-ellipsisspace-ellipsis
quote-unicodequote-unicode
bullet-unicodebullet-unicode
keywordAdditional keywords
Newline-separated extra keywords passed to xgettext using –keyword.
keyword_exclusiveUtilizar palavras chave exclusivamente
Quando ativo, passa
--keywordsem um valor para o xgettext antes da palavra chave adicional, desativando todas as palavras chave predefinidas para que apenas a palavra chave especificada acima seja reconhecida.input_modeFonte 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:¶ patternsPadrões de ficheiro-fonte
potfilesManifesto POTFILES
languageLinguagem 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_patternsPadrões de ficheiro-fonte
Padrões glob relativos ao repositório, separados por nova linha, para ficheiros 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 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.
Este extra atualiza o modelo configurado em Modelo para novas traduções. Está disponível para componentes gettext PO, e o componente deve definir um modelo para novas traduções.
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.
Esta atualização de modelo não atualiza ficheiros PO de tradução por si mesmo. Mantenha Atualizar ficheiros PO para coincidir com POT (msgmerge) instalado quando a tradução de ficheiros deve seguir alterações de modelo automaticamente. O formulário de instalação para este extra pode instalar tal extra, mas definições de extra existentes não mostram essa opção de instalação novamente.
Requisitos xgettext¶
Este extra requer xgettext. Configure qualquer um dos padrões de ficheiros ou um manifesto POTFILES / POTFILES.in. Padrões de ficheiro fonte são padrões de glob relativos a um repositório e apenas ficheiros de repositório correspondentes são passados para 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.
Execuções de atualizações de repositório automático são ignoradas a não ser que os ficheiros alterados correspondam aos padrões de fonte configurados, correspondam a ficheiros listados no manifesto, alterem um manifesto observado, ou alterem a configuração do extra.
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:
squashSubmeter com squash
Escolhas disponíveis:¶ allTodos os commits num só
languagePor idioma
filePor ficheiro
authorPor autor
append_trailersAnexar 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_messageMensagem de commit
Esta mensagem de commit será usada em vez das mensagens de commit combinadas dos commits após squash.
- Gatilhos:
Comprimir as submissões Git antes de enviar as alterações.
Dica
Para evitar conflitos desnecessários, é recomendado que configure a receção automática de alterações da fonte através de webhooks ou API, veja 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:
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_sensitiveAtivar a ordenação de chaves sensível a maiúsculas e minúsculas
- Gatilhos:
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:
ageDias a manter
- Gatilhos:
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:
ageDias a manter
votesLimites 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:
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:
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_urlURL do Webhook
event_filterEventos de alteração a ativar
Escolha quais eventos de alteração devem ativar este extra. Eventos de alteração a ativar
eventsEventos de alteração selecionados
- Gatilhos:
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: Conformidade do comprimento do segredo com a especificação agora é validado.
- ID da extensão:
weblate.webhook.webhook- Configuração:
webhook_urlURL do Webhook
secretSegredo de Webhook
O segredo de Webhooks Padrão é uma cadeia de carateres codificada em base64.
event_filterEventos de alteração a ativar
Escolha quais eventos de alteração devem ativar este extra. Eventos de alteração a ativar
eventsEventos de alteração selecionados
- Gatilhos:
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.
O secret fornecido é uma cadeia de carateres codificada em base64 entre 24 bytes (192 bits) e 64 bytes (512 bits). Pode ter o prefixo whsec_ para identificação fácil.
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¶
|
Alibaba |
|
Amazon Translate |
|
Anthropic |
|
Apertium APy |
|
Tradutor IA da Azure |
|
Modo Zen |
|
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 |
|
tmserver |
Formato de ficheiro¶
|
XLIFF 1.2 com extensões Apple |
|
Ficheiros de metadados da App Store |
|
Ficheiro ARB |
|
Recurso de Cadeias do Android |
|
Ficheiro AsciiDoc |
|
Ficheiro de legendas Advanced Substation Alpha |
|
Haiku catkeys |
|
Compor Recurso Multiplataforma |
|
Ficheiro CSV |
|
Ficheiro CSV com vários valores |
|
Ficheiro CSV simples |
|
Ficheiros de texto DokuWiki |
|
Ficheiro DTD |
|
Ficheiro XML plano |
|
Ficheiro fluente |
|
Ficheiro Format.JS JSON |
|
Ficheiro JSON go-i18n v1 |
|
Ficheiro JSON go-i18n v2 |
|
Ficheiro go-i18n TMOL |
|
Ficheiro de gotext JSON |
|
Propriedades GWT |
|
Ficheiro HTML |
|
Ficheiro i18next JSON v3 |
|
Ficheiro i18next JSON v4 |
|
Ficheiro IDML |
|
Ficheiro INI |
|
Ficheiro INI de Inno Setup |
|
Ficheiro de idioma Joomla |
|
Ficheiro JSON |
|
Ficheiro de estrutura integrada JSON |
|
Cadeias de carateres de PHP Laravel |
|
Ficheiro Markdown |
|
Ficheiro MDX |
|
Ficheiro de texto MediaWiki |
|
@draggable/i18n ficheiro de idioma |
|
Recurso Mobile Kotlin |
|
Ficheiro JSON Nextcloud |
|
Ficheiro de OpenDocument |
|
Cadeias de carateres de PHP |
|
Ficheiro 1.2 de tradução XLIFF |
|
Ficheiro gettext PO |
|
Ficheiro gettext PO (monolingue) |
|
XLIFF 1.2 com extensões gettext |
|
Propriedades de Java |
|
Ficheiro RC |
|
Ficheiro RESJSON |
|
Ficheiro ResourceDictionary |
|
Ficheiro de recursos .Net |
|
Ficheiro Ruby YAML |
|
Ficheiro de legendas SubRip |
|
Ficheiro de legendas Substation Alpha |
|
Cadeias de iOS |
|
Ficheiro de stringsdict |
|
Ficheiro de legendas MicroDVD |
|
Ficheiro de TermBase eXchange |
|
Ficheiro TOML |
|
Ficheiro de tradução Qt Linguist (versão 2) |
|
Ficheiro de tradução Qt Linguist (versão 1) |
|
Ficheiros de texto simples |
|
Ficheiro WebExtension JSON |
|
Ficheiro WixLocalization |
|
XLIFF 1.2 com suporte transponível |
|
Ficheiro tradução 2.0 XLIFF |
|
Ficheiro de tradução XLIFF 2.0 com suporte de colocáveis |
|
Excel Open XML |
|
Página Completa XWiki |
|
Propriedades do XWiki Java |
|
Propriedades do XWiki Page |
|
Ficheiro YAML |
Eventos de alteração a ativar¶
|
Eventos de conteúdo de tradução |
|
Todos os eventos de alteração |
|
Eventos de alteração selecionados |
Eventos de alteração selecionados¶
As seguintes ações de alterações podem aparecer em notificações de carga. O Fedora Messaging utiliza a coluna identificadora em tópicos de mensagem, enquanto que cargas de webhook utilizam a coluna de nome no campo de action.
Id. |
Identificador |
Nome |
Descrição |
|---|---|---|---|
|
|
Recurso atualizado |
Um ficheiro de tradução foi sincronizado com o seu repositório. |
|
|
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. |
|
|
Tradução alterada |
Uma tradução existente foi editada por um utilizador. |
|
|
Comentário adicionado |
Um comentário foi adicionado à cadeia de carateres. |
|
|
Sugestão adicionada |
Uma sugestão de tradução foi adicionada. |
|
|
Tradução adicionada |
Uma cadeia de carateres previamente não traduzida foi traduzida por um utilizador. |
|
|
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. |
|
|
Sugestão aceite |
Uma sugestão de tradução foi aceite como a tradução. |
|
|
Tradução revertida |
Uma tradução foi restaurada para um valor anterior. |
|
|
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. |
|
|
Cadeia de carateres fonte adicionada |
Uma cadeia de carateres fonte foi adiciona fora do repositório ou das atualizações enviadas. |
|
|
Componente bloqueado |
Um componentes foi bloqueado para tradução. |
|
|
Componente desbloqueado |
Um componente foi desbloqueado para tradução. |
|
|
Alterações submetidas |
Mudanças de componente pendentes foram enviadas. |
|
|
Alterações enviadas |
Mudanças de repositório foram enviadas para a fonte. |
|
|
Redefinição do repositório |
Um repositório foi reiniciado para o seu estado fonte. |
|
|
Repositório unido |
As mudanças do repositório fonte foram mescladas. |
|
|
Repositório rebaseado |
As mudanças de Repositório foram rebased na fonte. |
|
|
A união do repositório falhou |
A união de mudanças do repositório fonte falhou. |
|
|
Falha na rebase do repositório |
O rebase de mudanças do repositório falhou. |
|
|
A análise falhou |
O Weblate não conseguiu analisar o ficheiro de tradução. |
|
|
Tradução removida |
O idioma de tradução foi removido. |
|
|
Sugestão removida |
A sugestão de tradução foi removida. |
|
|
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. |
|
|
O envio para o repositório falhou |
O envio de mudanças para o repositório fonte falhou. |
|
|
Sugestão removida durante a limpeza |
Uma sugestão de tradução obsoleta foi removida durante a limpeza. |
|
|
Cadeia de carateres fonte alterada |
A cadeia de carateres fonte foi editada no Weblate. |
|
|
Cadeia de carateres adicionada |
Uma cadeia de carateres nova foi adicionada no Weblate. |
|
|
Alterado estados em massa |
O estado da tradução de uma ou mais cadeias de carateres foram mudadas em massa. |
|
|
Visibilidade alterada |
A visibilidade de projeto ou componente foi mudada. |
|
|
Utilizador adicionado |
Garantido acesso a um utilizador. |
|
|
Utilizador removido |
O acesso de um utilizador foi removido. |
|
|
Tradução aprovada |
Uma tradução foi aprovada durante revisão. |
|
|
Marcada para edição |
Uma tradução foi marcada como necessitando de edição. |
|
|
Componente removido |
O componente de tradução foi removido. |
|
|
Projeto removido |
Um projeto de tradução foi removido. |
|
|
Projeto renomeado |
Um projeto de tradução foi renomeado. |
|
|
Componente renomeado |
Um componente de tradução foi renomeado. |
|
|
Componente movido |
Um componente foi movido para dentro de um projeto. |
|
|
Colaborador aderiu |
Um utilizador fez a sua primeira contribuição para uma tradução. |
|
|
Anúncio publicado |
Um anúncio foi publicado. |
|
|
Alerta acionado |
Um alerta de componente foi ativado. |
|
|
Idioma adicionado |
Uma linguagem de tradução foi adicionada. |
|
|
Idioma solicitado |
Um utilizador pediu um novo idioma. |
|
|
Projeto criado |
Um projeto de tradução foi criado. |
|
|
Componente criado |
Um componente de tradução foi criado. |
|
|
Utilizador convidado |
Um utilizador foi convidado para um projeto. |
|
|
Notificação de repositório recebida |
O Weblate recebeu uma notificação de repositório de um alojamento de código. |
|
|
Ficheiro de tradução substituído pelo envio |
Um ficheiro de tradução foi substituído por um ficheiro enviado. |
|
|
Licença alterada |
A informação de licença de projeto ou componente mudou. |
|
|
Acordo da licença de colaborador alterado |
O acordo de licença de colaborador foi mudado. |
|
|
Captura do ecrã adicionada |
Uma captura de ecrã foi associada com uma cadeia de carateres. |
|
|
Captura de ecrã enviada |
Uma captura de ecrã foi enviada. |
|
|
Cadeia de carateres atualizada no repositório |
Uma cadeia de carateres foi mudada ao sincronizar a partir do repositório. |
|
|
Extra instalado |
Um extra foi instaldo. |
|
|
Configuração do extra alterada |
Uma configuração de extra foi mudada. |
|
|
Extra desinstalado |
Um extra foi desinstalado. |
|
|
Cadeia de carateres removida |
Uma cadeia de carateres foi removida de uma tradução. |
|
|
Comentário removido |
Um comentário de cadeia de carateres foi removida. |
|
|
Comentário resolvido |
Um comentário de cadeia de carateres foi marcado como resolvido. |
|
|
Explicação atualizada |
A explicação para uma cadeia de carateres fonte foi atualizada. |
|
|
Categoria removida |
Uma categoria de componente foi removida. |
|
|
Categoria renomeada |
Uma categoria de componente foi renomeada. |
|
|
Categoria movida |
Uma categoria de componente foi movida. |
|
|
Falha ao guardar a cadeia de carateres |
O Weblate não conseguiu guardar uma cadeia de carateres alterada. |
|
|
Cadeia de carateres adicionada ao repositório |
Uma nova cadeia de carateres foi encontrada durante a sincronização a partir do repositório. |
|
|
Cadeia de carateres atualizada no envio |
Uma cadeia de carateres foi mudada durante o processamento de um ficheiro enviado. |
|
|
Cadeia de carateres adicionada no envio |
Uma nova cadeia de carateres foi encontrada durante o processamento de um ficheiro enviado. |
|
|
Tradução atualizada pelo envio da fonte |
Uma tradução foi sincronizada após o envio de um ficheiro fonte. |
|
|
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. |
|
|
Verificação forçada aplicada |
Uma tradução foi marcada como necessitando de edição por uma verificação obrigatória. |
|
|
Alteração propagada |
A edição de tradução foi propagada para outra cadeia de carateres correspondente. |
|
|
Ficheiro enviado |
Um ficheiro foi enviado para uma tradução. |
|
|
Sinalizações extra atualizadas |
Marcadores de cadeia de carateres fonte adicionais foram atualizados. |
|
|
Tipo de letra enviado |
Uma fonte foi enviada. |
|
|
Tipo de letra alterado |
Uma fonte enviada foi alterada. |
|
|
Tipo de letra removido |
Uma fonte enviada foi removida. |
|
|
Sincronização forçada das traduções |
Ficheiros de tradução foram sincronizadas forçosamente com o repositório. |
|
|
Reverificação forçada das traduções |
Ficheiros de tradução foram analisados forçosamente por mudanças. |
|
|
Captura de ecrã removida |
Uma captura de ecrã foi removida. |
|
|
Etiqueta adicionada |
Uma etiqueta foi adiciona a uma cadeia de carateres. |
|
|
Etiqueta removida |
Uma etiqueta foi removida de uma cadeia de carateres. |
|
|
Limpeza do repositório |
A árvore de trabalho do repositório foi limpa. |
|
|
Cadeia fonte adicionada no envio |
Uma cadeia de carateres fonte foi adicionada durante o processamento de um ficheiro enviado. |
|
|
Cadeia fonte adicionada no repositório |
Uma cadeia de carateres fonte foi adicionada durante a sincronização a partir do repositório. |
|
|
Cópia de segurança do projeto feita |
Uma cópia de segurança do projeto foi criada. |
|
|
Projeto restaurado |
Um projeto foi restaurado a partir de uma cópia de segurança. |
|
|
Componente restaurado |
Um componentes foi restaurado a partir de uma cópia de segurança. |
|
|
Edição de utilizador revertida |
Todas as edições selecionadas por um utilizador foram revertidas. |
|
|
Definição de projeto alterada |
Uma definição de projeto foi alterada. |
|
|
Definição de componente alterada |
Uma definição de componente foi alterada. |
|
|
O acesso do utilizador foi alterado |
As permissões de acesso de utilizador foram alteradas. |
|
|
Espaço de trabalho criado |
Um espaço de trabalho foi criado. |
|
|
Definição de espaço de trabalho mudado |
Uma definição de espaço de trabalho foi alterada. |
|
|
Projeto movido |
Um projeto foi movido para dentro ou fora de um espaço de trabalho. |
|
|
Repositório remoto atualizado |
Uma atualização de repositório remoto foi completado. |
|
|
Falha na atualização do repositório remoto |
A atualização de um repositório remoto falhou. |
|
|
Alerta ignorado |
Um alerta de componente foi ignorado. |
|
|
Alerta reaberto |
Um alerta de componente foi reaberto após o seu contexto ter mudado. |
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
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.
Veja também
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.