Extensões

Novo na versão 2.19.

Extensões fornecem maneiras para personalizar e automatizar o fluxo de trabalho de tradução. Administradores podem gerir extensões a partir do menu GerirExtensões dos respectivos componente de tradução.

Dica

You can also configure add-ons using API, DEFAULT_ADDONS, or install_addon.

../_images/addons.png

Extensões embutidas

Tradução automática

Novo na versão 3.9.

ID da extensão

weblate.autotranslate.autotranslate

Configuração

mode

Modo de tradução automático

filter_type

Filtro de procura

auto_source

Fonte da tradução automática

component

Componentes

Ativar a contribuição para a memória de tradução compartilhada para que o projeto tenha acesso a componentes adicionais.

engines

Motores de tradução automática

threshold

Limite de pontuação

Events triggering add-on

component update, daily

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

Ela é acionada:

  • Quando novas cadeias aparecem num componente.

  • Uma vez por mês para cada componente, isso pode ser configurado a usar BACKGROUND_TASKS.

CDN de localização JavaScript

Novo na versão 4.2.

ID da extensão

weblate.cdn.cdnjs

Configuração

threshold

Limiar de tradução

Limiar para inclusão de traduções.

css_selector

Seletor de CSS

Seletor CSS para detectar 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 remotas a serem analisados para obter cadeias traduzíveis.

Events triggering add-on

daily, repository post-commit, repository post-update

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 a usar CDN Weblate para mais detalhes.

Remover cadeias em branco

Novo na versão 4.4.

ID da extensão

weblate.cleanup.blank

Configuração

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

Events triggering add-on

repository post-commit, repository post-update

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.

Events triggering add-on

repository pre-commit, repository post-update

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.

Adiciona idiomas em falta

ID da extensão

weblate.consistency.languages

Configuração

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

Events triggering add-on

daily, repository post-add

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

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

file_format

Formato de ficheiro

name_template

Personalizar nome do componente

base_file_template

Definir nome do ficheiro base monolingue

Manter vazio para ficheiros de tradução bilingue.

new_base_template

Defina o ficheiro base para as novas traduções

Nome do ficheiro utilizado para criar as novas traduções. Para gettext, escolher o ficheiro «.pot».

language_regex

Filtro de idioma

Expressão regular utilizada para filtrar ficheiros de tradução quando procurar pela máscara de ficheiro.

copy_addons

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

remove

Remover componentes para os ficheiros inexistentes

confirm

Confirmo que as correspondências acima parecem correctas

Events triggering add-on

repository post-update

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

Acionada toda vez que o VCS é atualizado, de outra forma semelhante ao comando de gestão import_project. Desta forma, pode rastrear vários componentes de tradução dentro de um VCS.

A correspondência é feita a usar expressões regulares que permitem uma configuração complexa, mas é necessário algum conhecimento para fazê-la. Alguns exemplos para casos de uso comum encontram-se na secção de ajuda de extensões.

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

../_images/addon-discovery.png

Dica

A extensão de descoberta de componentes usa URLs internas do Weblate. É uma maneira conveniente de compartilhar a configuração do VCS entre vários componentes. Os componentes vinculados usam o repositório local do componente principal configurado a preencher weblate://project/main-component no campo Repositório do código-fonte (em GerirConfiguraçõesSistema de controle de versão) de cada componente. Isso economiza tempo com configuração e recursos do sistema também.

Veja também

Template markup

Edição em massa

Novo na versão 3.11.

ID da extensão

weblate.flags.bulk

Configuração

q

Consulta

state

Estado a definir

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

Events triggering add-on

component update

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

Automatize o etiquetação a começar com a consulta de pesquisa NOT has:label e adicione etiquetas até que todas as cadeias tenham todas as etiquetas necessárias. Outras operações automatizadas para metadados Weblate também podem ser feitas.

Exemplos::

Rotula novas cadeias automaticamente

Consulta de pesquisa

NOT has:label

Etiqueta a adicionar

recente

Marcar como somente leitura todas as entradas do changelog de Ficheiros de metadados da App Store

Consulta de pesquisa

language:en AND key:changelogs/

Bandeiras de tradução para adicionar

read-only

Marcar as traduções inalteradas como «Precisa de edição»

Novo na versão 3.1.

ID da extensão

weblate.flags.same_edit

Configuração

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

Events triggering add-on

unit post-create

Sempre que uma nova cadeia traduzível é importada de VCS e corresponde a uma cadeia fonte, esta é marcada como precisa de edição no Weblate. Isto é especialmente útil para os formatos de ficheiro que incluem cadeias 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

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

ID da extensão

weblate.flags.source_edit

Configuração

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

Events triggering add-on

unit post-create

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

Veja também

Estados de tradução

Marcar as novas traduções como «Precisa de edição»

ID da extensão

weblate.flags.target_edit

Configuração

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

Events triggering add-on

unit post-create

Sempre que uma nova cadeia de tradução é importada de VCS, esta é marcada como precisa de edição no Weblate. Deste modo pode filtrar e editar facilmente as traduções criadas pelos programadores.

Veja também

Estados de tradução

Gerador de estatísticas

ID da extensão

weblate.generate.generate

Configuração

filename

Nome do ficheiro gerado

template

Conteúdo do ficheiro gerado

Events triggering add-on

repository pre-commit

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 Markdown 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

Template markup

Geração da pseudolocalidade

ID da extensão

weblate.generate.pseudolocale

Configuração

source

Cadeias fonte

target

Tradução de destino

prefix

Prefixo da cadeia

suffix

Sufixo da cadeia

Events triggering add-on

component update, daily

Gera uma tradução a adicionar um prefixo e sufixo às cadeias de origem automaticamente.

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.

Dica

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

Dica

You can use this add-on to start translation to a new locale of an existing language or similar language. Once you add the translation to the component, follow to the add-on. Example: If you have fr and want to start fr_CA translation, simply set fr as the source, fr_CA as the target, and leave the prefix and suffix blank.

Uninstall the add-on once you have the new translation filled to prevent Weblate from changing the translations made after the copying.

Contribuintes em comentários

ID da extensão

weblate.gettext.authors

Configuração

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

Events triggering add-on

repository pre-commit

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@cihar.com>, 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.

Events triggering add-on

repository post-add, daily

Atualiza a variável ALL_LINGUAS em ficheiros configure, configure.in ou configure.ac, quando uma nova tradução é adicionada.

Personalizar a saída gettext

ID da extensão

weblate.gettext.customize

Configuração

width

Ajuste de linhas longas

Por predefinição, o gettext quebra as linhas a 77 carateres e novas linhas. Com o parâmetro –no-wrap, quebra apenas em novas linhas.

Events triggering add-on

store post-load

Permite personalizar o comportamento da saída gettext, por exemplo, a quebra de linhas.

Oferece as seguintes opções:

  • Quebrar linhas em 77 caracteres e em novas linhas

  • Quebrar as linhas apenas nas novas linhas

  • Sem quebra de linhas

Nota

Por padrão, o gettext quebra as linhas em 77 caracteres e em novas linhas. Com o parâmetro --no-wrap, a quebra só é feita em novas linhas.

Atualizar ficheiro LINGUAS

ID da extensão

weblate.gettext.linguas

Configuração

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

Events triggering add-on

repository post-add, daily

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

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.

Events triggering add-on

repository pre-commit

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 Template markup.

Atualizar ficheiros PO para coincidir com POT (msgmerge)

ID da extensão

weblate.gettext.msgmerge

Configuração

previous

Manter «msgids» anteriores das cadeias traduzidas

no_location

Remover localizações das cadeias traduzidas

fuzzy

Utilizar correspondência de imprecisa

Events triggering add-on

repository post-update

Updates all PO files (as configured by Máscara de ficheiros) to match the POT file (as configured by Modelo para novas traduções) using msgmerge.

Triggered whenever new changes are pulled from the upstream repository. Most msgmerge command-line options can be set up through the add-on configuration.

Squash de commits git

ID da extensão

weblate.git.squash

Configuração

squash

Submeter com squash

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

Commit message

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

Events triggering add-on

repository post-commit

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

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

Novo na versão 3.4.

  • Todos os commits num só

  • Por idioma

  • Por ficheiro

Novo na versão 3.5.

  • 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.

Novo na versão 4.1.

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

ID da extensão

weblate.json.customize

Configuração

sort_keys

Ordenar chaves JSON

indent

Indentação JSON

Events triggering add-on

store post-load

Permite ajustar o comportamento da saída JSON, por exemplo, a indentação ou a ordenação.

Formata as propriedades do ficheiro Java

ID da extensão

weblate.properties.sort

Configuração

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

Events triggering add-on

repository pre-commit

Ordena o ficheiro de propriedades Java.

Purga de comentários obsoletos

Novo na versão 3.7.

ID da extensão

weblate.removal.comments

Configuração

age

Dias para manter

Events triggering add-on

daily

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

Isso pode ser útil para remover comentários antigos que podem ter ficado desatualizados. Use com cuidado, pois comentários ficarem velhos não significam que eles perderam importância.

Purga de sugestões obsoletas

Novo na versão 3.7.

ID da extensão

weblate.removal.suggestions

Configuração

age

Dias para manter

votes

Limites de votação

Limite para a remoção. Este campo não tem efeito com os votos desativados.

Events triggering add-on

daily

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

Novo na versão 3.9.

ID da extensão

weblate.resx.update

Configuração

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

Events triggering add-on

repository post-update

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

Dica

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

Personalizar a saída YAML

Novo na versão 3.10.2.

ID da extensão

weblate.yaml.customize

Configuração

indent

Indentação de YAML

width

Ajuste de linhas longas

line_break

Quebras de linha

Events triggering add-on

store post-load

Permite ajustar o comportamento da saída YAML, por exemplo, o comprimento de linha ou novas linhas.

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, então, implemente uma função de retorno que vai fazer o processamento.

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 © 2012 - 2021 Michal Čihař <michal@cihar.com>
#
# This file is part of Weblate <https://weblate.org/>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.
#
"""Example pre commit script."""


from django.utils.translation import gettext_lazy as _

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


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events = (EVENT_PRE_COMMIT,)
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long descrption
    verbose = _("Execute script before commit")
    description = _("This addon 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, 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 controle de versão usado.

WL_REPO

URL do repositório upstream.

WL_PATH

Caminho absoluto ao repositório VCS.

WL_BRANCH

Novo na versão 2.11.

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

Novo na versão 2.14.

Nome do ficheiro usado para criar novas 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

Novo na versão 3.9.

Slug do componente usado para construir a URL.

WL_PROJECT_SLUG

Novo na versão 3.9.

Slug de projeto usado para construir a URL.

WL_COMPONENT_NAME

Novo na versão 3.9.

Nome de componente.

WL_PROJECT_NAME

Novo na versão 3.9.

Nome do projeto.

WL_COMPONENT_URL

Novo na versão 3.9.

URL do componente.

WL_ENGAGE_URL

Novo na versão 3.9.

URL de engajamento do projeto.

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

Pode ser usado para atualizar ficheiros de tradução quando a fonte VCS do upstream alterar. Para conseguir isso, lembre-se que o Weblate só vê fcheiros dos quais se fez commit com o VCS, então precisa fazer commit das 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.