Verificações e correções¶

Correções automáticas personalizadas¶

Também pode implementar a sua própria correção automática, além das predefinidas e incluí-las em AUTOFIX_LIST.

As correções automáticas são poderosas, mas também podem causar danos; tenha cuidado ao escrever uma.

Por exemplo, a correção automática a seguir iria substituir cada ocorrência da cadeia foo, numa tradução com bar:

from weblate.trans.autofixes.base import AutoFix


class ReplaceFooWithBar(AutoFix):
    """Replace foo with bar."""

    # Might be localized using gettext_lazy
    name = "Foobar"

    def fix_single_target(self, target, source, unit):
        if "foo" in target:
            return target.replace("foo", "bar"), True
        return target, False

Para instalar verificações personalizadas, forneça um caminho totalmente qualificado à classe Python em AUTOFIX_LIST, veja Verificações de qualidade personalizadas, sugestões automáticas, extensões e correções automáticas.

Personalizando comportamento a usar marcadores¶

Pode ajustar o comportamento do Weblate usando marcadores. Os marcadores fornecem feedback visual aos tradutores e os ajudam a melhorar a sua tradução. Os marcadores são mesclados a partir das seguintes fontes:

Marcadores adicionais da cadeia fonte:
- Informações adicionais sobre cadeias fonte descreve a edição manual.
- Edição em massa pode ser usado para aplicar marcadores em lote.
- O complemento Edição em massa pode aplicar marcadores automaticamente.
Marcadores por cadeia extraídos do formato do ficheiro, consulte Formatos de ficheiro de localização.
Marcadores de tradução (atualmente apenas o marcador read-only para a cadeia de carateres fonte bilíngue ou quando a edição de modelo monolingue está desativada).
Marcadores específicos do formato de ficheiro.
Configuração de componente (Marcadores de tradução).
Configuração de projeto (Marcadores de tradução).

Os marcadores são separados por vírgulas; se tiverem parâmetros, eles são separados por dois pontos. Pode usar aspas para incluir espaços em branco ou caracteres especiais na cadeia. Por exemplo:

placeholders:"special:value":"other value", regex:.*

Aspas simples e duplas são aceitas e caracteres especiais são tratados com barra invertida:

placeholders:"quoted \"string\"":'single \'quoted\''

placeholders:r"^#*"

Para verificar se os tradutores não alteram o título de um documento Markdown. Uma verificação com falha será acionada se a cadeia ### Index for traduzido como # Indice.

placeholders:r"\]\([^h].*?\)"

Para garantir que as ligações internas não estão a ser traduzidos (ou seja, [test](../checks) não se torna [test](../chequeos)).

Marcadores definidos num nível mais alto podem ser descartados com a sintaxe discard:NAME. Por exemplo, se um componente estiver configurado como safe-html, poderá adicionar discard:safe-html aos marcadores de cadeias para ignorá-lo esta cadeia especifica.

Aqui está uma lista de marcadores atualmente aceites:

read-only: A cadeia é apenas para leitura e não deve ser editada no Weblate, veja Cadeias apenas de leitura.
terminology: Usado em Glossário. Copia a cadeia em todos os idiomas do Glossário para que possa ser usada de forma consistente em todas as traduções. Também útil em combinação com read-only, por exemplo em nomes de produtos.
priority:N: Prioridade da cadeia. As cadeias de maior prioridade são apresentados primeiro para tradução. A prioridade predefinida é 100, quanto maior prioridade que um texto tem, mais cedo é oferecido para tradução.
max-length:N: Limita o comprimento máximo de uma cadeia a N caracteres, veja Tamanho máximo da tradução.
xml-text: Trata o texto como documento XML, afeta Sintaxe XML e Markup XML.
font-family:NAME: Define a família de letras para verificações da renderização, veja Gerir letras.
font-weight:WEIGHT: Define o peso da letra para verificações da renderização, veja Gerir letras.
font-size:SIZE: Define o tamanho da letra para verificações da renderização, veja Gerir letras.
font-spacing:SPACING: Define o espaçamento de letras para verificações da renderização, veja Gerir letras.
icu-flags:FLAGS: Define marcadores para personalizar o comportamento da verificação de qualidade MessageFormat do ICU.
icu-tag-prefix:PREFIX: Define um prefixo necessário para etiquetas XML para a verificação de qualidade MessageFormat do ICU.
placeholders:NAME:NAME2:...: Cadeias de espaço reservado esperados na tradução, veja Espaços reservados.
replacements:FROM:TO:FROM2:TO2...: Substituições para realizar quando verificar os parâmetros de texto resultantes (por exemplo, em Tamanho máximo da tradução ou Tamanho máximo da tradução). O caso de utilização típico para isso é expandir os objetos colocáveis para garantir que o texto se ajusta até com os valores longos, por exemplo: replacements:%s:"John Doe".
variants:SOURCE: Marque esta cadeia de carateres como uma variante de cadeia de carateres com a fonte correspondente. Consulte Variantes de cadeias.
regex:REGEX: Expressão regular para corresponder à tradução; veja Expressão regular.
discard:NAME: Descarta o marcador definido num nível superior.
forbidden: Indica tradução proibida num glossário, veja Traduções proibidas.
strict-same: Faz Tradução inalterada evitar o uso de exceções de palavras embutidas.
strict-format: Faça com que as verificações de formato imponham o uso do formato mesmo para formas de plural com um único valor, consulte Cadeias formatadas.
case-insensitive: Ajustar o comportamento de verificação para não diferenciar maiúsculas de minúsculas. Atualmente, isso afeta apenas a verificação de qualidade Espaços reservados.

accelerator: Especifique o marcador de aceleração de pontuação individual, por exemplo accelerator:&, accelerator:_, ou accelerator:~. Ative a verificação de qualidade Chave aceleradora.
asciidoc-text: Trata um texto como um documento AsciiDoc, afeta Tradução inalterada. Ativa a verificação de qualidade Marcação AsciiDoc.
bbcode-text: Trata um texto como um documento Bulletin Board Code (BBCode), afeta Tradução inalterada. Ativa a verificação de qualidade Markup BBCode.
check-glossary: Ativa a verificação de qualidade Não segue o glossário.
fluent-parts: Ativa verificação de qualidade Partes Fluent.
fluent-references: Ativa a verificação de qualidade Referências Fluent.
fluent-target-inner-html: Ativa a verificação de qualidade Tradução Fluent HTML interno.
fluent-target-syntax: Ativa a verificação de qualidade Sintaxe de tradução Fluent.
angularjs-format: Ativa a verificação de qualidade Cadeia de interpolação AngularJS.
automattic-components-format: Ativa a verificação de qualidade Formatação de componentes do Automattic.
c-format: Ativa a verificação de qualidade Formato C.
c-sharp-format: Ativa a verificação de qualidade Formato C#.
csharp-format: Ativa a verificação de qualidade Formato C#.
es-format: Ativa a verificação de qualidade Literais de modelo de ECMAScript.
i18next-interpolation: Ativa a verificação de qualidade Interpolação de i18next.
icu-message-format: Ativa a verificação de qualidade MessageFormat do ICU e Sintaxe de MessageFormat do ICU.
java-printf-format: Ativa a verificação de qualidade Formato Java.
java-format: Ativa a verificação de qualidade Formato de Mensagem Java.
auto-java-messageformat: Trata o texto enquanto Java MessageFormat condicional, ativando Formato de Mensagem Java apenas quando a fonte contém marcadores de lugar Java MessageFormat. Ativa a verificação de qualidade Formato de Mensagem Java.
javascript-format: Ativa a verificação de qualidade Formato JavaScript.
laravel-format: Ativa a verificação de qualidade Formato Laravel.
lua-format: Ativa a verificação de qualidade Formato Lua.
object-pascal-format: Ativa a verificação de qualidade Formato Object Pascal.
objc-format: Ative a verificação de qualidade Formato de Objective-C.
percent-placeholders: Ativa a verificação de qualidade Espaços reservados de percentagem.
perl-brace-format: Ativa a verificação de qualidade Formato de chave Perl.
perl-format: Ativa a verificação de qualidade Formato Perl.
php-format: Ativa a verificação de qualidade Formato PHP.
python-brace-format: Ativa a verificação de qualidade Formato de chaveta Python.
python-format: Ativa a verificação de qualidade Formato Python.
qt-format: Ativa a verificação de qualidade Formato Qt.
qt-plural-format: Ativa a verificação de qualidade Forma plural Qt.
ruby-format: Ativa a verificação de qualidade Formato Ruby.
scheme-format: Ativa a verificação de qualidade Formato Scheme.
vue-format: Ativa a verificação de qualidade Formatação vue I18n.
rst-text: Trata um texto como um documento reStructuredText, afeta Tradução inalterada. Ativa as verificações de qualidade reStructuredText inconsistente e Erro de sintaxe reStructuredText.
md-text: Trata um texto como um documento Markdown e fornece destaque de sintaxe Markdown na área de texto da tradução. Ativa as verificações de qualidade Hiperligações de marcação, Referências de Markdown e Sintaxe de Markdown.
max-length: Ativa a verificação de qualidade Tamanho máximo da tradução.
max-lines: Ativa a verificação de qualidade Número máximo de linhas.
max-size: Ativa a verificação de qualidade Tamanho máximo da tradução.
placeholders: Ativa a verificação de qualidade Espaços reservados.
regex: Ativa a verificação de qualidade Expressão regular.
safe-mdx: Ativa a verificação de qualidade MDX Seguro.
safe-html: Ativa a verificação de qualidade HTML inseguro.
auto-safe-html: Tratar o texto enquanto HTML condicional, ativado HTML inseguro apenas para texto simples ou cadeias de carateres fonte que contêm markup HTML padrão ou elementos personalizados válidos. Isto é útil para variantes de Markdown tais como MDX, onde sintaxe de colchete pode não ser HTML. Ativa a verificação de qualidade HTML inseguro.
url: A cadeia deve consistir apenas numa URL. Ativa a verificação de qualidade URL.
fluent-source-inner-html: Ativa a verificação de qualidade HTML interno de fonte Fluent.
fluent-source-syntax: Ativa a verificação de qualidade Sintaxe de origem Fluent.

ignore-all-checks: Ignora todas as verificações de qualidade.

ignore-accelerator: Ignora a verificação de qualidade Chave aceleradora.
ignore-asciidoc-markup: Ignora a verificação de qualidade Marcação AsciiDoc.
ignore-bbcode: Ignora a verificação de qualidade Markup BBCode.
ignore-xml-chars-around-tags: Ignora a verificação de qualidade Carateres em torno das etiquetas XML.
ignore-duplicate: Ignora a verificação de qualidade Palavras consecutivas duplicadas.
ignore-check-glossary: Ignora a verificação de qualidade Não segue o glossário.
ignore-double-space: Ignora a verificação de qualidade Espaço duplo.
ignore-fluent-parts: Ignora a verificação de qualidade Partes Fluent.
ignore-fluent-references: Ignora a verificação de qualidade Referências Fluent.
ignore-fluent-target-inner-html: Ignora a verificação de qualidade Tradução Fluent HTML interno.
ignore-fluent-target-syntax: Ignora a verificação de qualidade Sintaxe de tradução Fluent.
ignore-angularjs-format: Ignora a verificação de qualidade Cadeia de interpolação AngularJS.
ignore-automattic-components-format: Ignora a verificação de qualidade Formatação de componentes do Automattic.
ignore-c-format: Ignora a verificação de qualidade Formato C.
ignore-c-sharp-format: Ignora a verificação de qualidade Formato C#.
ignore-es-format: Ignora a verificação de qualidade Literais de modelo de ECMAScript.
ignore-i18next-interpolation: Ignora a verificação de qualidade Interpolação de i18next.
ignore-icu-message-format: Ignora a verificação de qualidade MessageFormat do ICU.
ignore-java-printf-format: Ignorar a verificação de qualidade Formato Java.
ignore-java-format: Ignora a verificação de qualidade Formato de Mensagem Java.
ignore-javascript-format: Ignora a verificação de qualidade Formato JavaScript.
ignore-laravel-format: Ignora a verificação de qualidade Formato Laravel.
ignore-lua-format: Ignora a verificação de qualidade Formato Lua.
ignore-object-pascal-format: Ignora a verificação de qualidade Formato Object Pascal.
ignore-objc-format: Ignora a verificação de qualidade Formato de Objective-C.
ignore-percent-placeholders: Ignora a verificação de qualidade Espaços reservados de percentagem.
ignore-perl-brace-format: Ignora a verificação de qualidade Formato de chave Perl.
ignore-perl-format: Ignora a verificação de qualidade Formato Perl.
ignore-php-format: Ignora a verificação de qualidade Formato PHP.
ignore-python-brace-format: Ignora a verificação de qualidade Formato de chaveta Python.
ignore-python-format: Ignora a verificação de qualidade Formato Python.
ignore-qt-format: Ignora a verificação de qualidade Formato Qt.
ignore-qt-plural-format: Ignora a verificação de qualidade Forma plural Qt.
ignore-ruby-format: Ignora a verificação de qualidade Formato Ruby.
ignore-scheme-format: Ignora a verificação de qualidade Formato Scheme.
ignore-vue-format: Ignora a verificação de qualidade Formatação vue I18n.
ignore-translated: Ignora a verificação de qualidade Foi traduzido.
ignore-inconsistent: Ignora a verificação de qualidade Inconsistente.
ignore-rst-references: Ignora a verificação de qualidade reStructuredText inconsistente.
ignore-kashida: Ignora a verificação de qualidade Letra Kashida utilizada.
ignore-md-link: Ignora a verificação de qualidade Hiperligações de marcação.
ignore-md-reflink: Ignora a verificação de qualidade Referências de Markdown.
ignore-md-syntax: Ignora a verificação de qualidade Sintaxe de Markdown.
ignore-max-length: Ignora a verificação de qualidade Tamanho máximo da tradução.
ignore-max-lines: Ignora a verificação de qualidade Número máximo de linhas.
ignore-max-size: Ignora a verificação de qualidade Tamanho máximo da tradução.
ignore-escaped-newline: Ignora a verificação de qualidade \n não correspondente.
ignore-end-colon: Ignora a verificação de qualidade Dois pontos não correspondentes.
ignore-end-ellipsis: Ignora a verificação de qualidade Reticências não correspondentes.
ignore-end-exclamation: Ignora a verificação de qualidade Ponto de exclamação não correspondente.
ignore-end-stop: Ignora a verificação de qualidade Ponto final não correspondente.
ignore-end-interrobang: Ignora a verificação de qualidade Interrobangue não compatível.
ignore-end-question: Ignora a verificação de qualidade Ponto de interrogação não correspondente.
ignore-end-semicolon: Ignora a verificação de qualidade Ponto e vírgula não correspondente.
ignore-newline-count: Ignora a verificação de qualidade Quebras de linha não coincidentes.
ignore-plurals: Ignora a verificação de qualidade Faltam plurais.
ignore-multiple-capital: Ignora a verificação de qualidade Múltiplas maiúsculas.
ignore-kabyle-characters: Ignora a verificação de qualidade Caracteres não padronizados em Kabyle.
ignore-placeholders: Ignora a verificação de qualidade Espaços reservados.
ignore-prohibited-initial-character: Ignora a verificação de qualidade Caractere inicial proibido.
ignore-punctuation-spacing: Ignora a verificação de qualidade Espaçamento da pontuação.
ignore-regex: Ignora a verificação de qualidade Expressão regular.
ignore-rst-syntax: Ignora a verificação de qualidade Erro de sintaxe reStructuredText.
ignore-reused: Ignora a verificação de qualidade Tradução reutilizada.
ignore-safe-mdx: Ignora a verificação de qualidade MDX Seguro.
ignore-same-plurals: Ignora a verificação de qualidade Mesmos plurais.
ignore-begin-newline: Ignora a verificação de qualidade Nova linha no início.
ignore-begin-space: Ignora a verificação de qualidade Espaços no início.
ignore-end-newline: Ignora a verificação de qualidade Nova linha no final.
ignore-end-space: Ignora a verificação de qualidade Espaço no final.
ignore-same: Ignora a verificação de qualidade Tradução inalterada.
ignore-safe-html: Ignora a verificação de qualidade HTML inseguro.
ignore-url: Ignora a verificação de qualidade URL.
ignore-xml-tags: Ignora a verificação de qualidade Markup XML.
ignore-xml-invalid: Ignora a verificação de qualidade Sintaxe XML.
ignore-zero-width-space: Ignora a verificação de qualidade Espaçamento nulo.
ignore-ellipsis: Ignora a verificação de qualidade Reticências.
ignore-fluent-source-inner-html: Ignora a verificação de qualidade HTML interno de fonte Fluent.
ignore-fluent-source-syntax: Ignora a verificação de qualidade Sintaxe de origem Fluent.
ignore-icu-message-format: Ignora a verificação de qualidade Sintaxe de MessageFormat do ICU.
ignore-long-untranslated: Ignora a verificação de qualidade Não traduzido há muito tempo.
ignore-multiple-failures: Ignora a verificação de qualidade Várias verificações falhadas.
ignore-unnamed-format: Ignora a verificação de qualidade Várias variáveis sem nome.
ignore-source-max-length: Ignora a verificação de qualidade Tamanho da cadeia de carateres fonte.
ignore-optional-plural: Ignora a verificação de qualidade Não pluralizado.

Nota

Geralmente, a regra é chamada de ignore-* para qualquer verificação, utilizando o seu identificador, para que possa utilizá-la mesmo para as suas verificações personalizadas.

Estas etiquetas são compreendidas tanto nas definições de Configuração de componente, por definições das cadeia de carateres fonte quanto no próprio ficheiro de tradução (por exemplo, no GNU gettext).

Sinalizadores baseados em localização¶

Alguns marcadores são adicionados às cadeias por padrão, com base nos seus locais. Isto significa que determinadas verificações serão automaticamente ativadas, dependendo de onde o texto for usado.

rst-text: Este marcador é adicionado automaticamente às cadeias nos ficheiros reStructuredText, se a extensão do local for .rst.
md-text: Este marcador é automaticamente adicionado às cadeias em ficheiros Markdown, se a extensão do local for .md, .markdown, ou .mdx.

Forçar verificações¶

As verificações aplicadas não podem ser ignoradas e marcam a cadeia de carateres enquanto Precisa de edição (veja Estados de tradução). Isto evita os tradutores de esconderem tais verificações.

Dica

Ativar a imposição de verificação não a ativa automaticamente. Algumas verificações pode ter que ser ativadas adicionando o marcador correspondente aos marcadores da cadeia de carateres ou componente.

Isto é mais adequado com verificações que podem causar sérios problemas quando utilizadas, como verificações para Cadeias formatadas. Usar para verificações de estilo como Tradução inalterada não é recomendado porque ignorar estas verificações, por vezes, é uma abordagem razoável.

A Filtro de qualidade de tradução pode ser usada para excluir cadeias de carateres que precisam de ser editadas de ser enviadas para o controlo de versão.

Veja também

Gerir letras¶

Dica

As fontes carregadas no Weblate são usadas puramente para fins de verificação Tamanho máximo da tradução, elas não têm efeito na interface de utilizador do Weblate.

A verificação Tamanho máximo da tradução usada para calcular as dimensões do texto renderizado precisa de ser carregada no Weblate e selecionada a usar um marcador de tradução (ver Personalizando comportamento a usar marcadores).

Ferramenta de gestão de fontes do Weblate em Fonts sob o menu Operações do seu projeto de tradução fornece interface para carregar e gerir fontes. As fontes TrueType ou OpenType podem ser carregadas, configurar grupos de fontes e usá-los na verificação.

Os grupos de letras permitem definir letras diferentes para idiomas diferentes, o que é normalmente necessário para idiomas não-latinos:

O grupos de letras são identificados pelo nome, que não pode conter espaços ou caracteres especiais, de modo que ele pode ser facilmente utilizado na definição da verificação:

A família de letras e o estilo são automaticamente reconhecidos após carregá-los:

Pode ter muitas letras carregadas para Weblate:

Para utilizar os tipos de letra para verificar o comprimento da cadeia de carateres, passe-lhe os sinalizadores apropriados (consulte Personalizando comportamento a usar marcadores). Provavelmente precisará dos seguintes:

max-size:500 / max-size:300:5: Define a largura máxima em pixels e, opcionalmente, a quantidade máxima de linhas . A quebra de palavras é aplicada quando mais do que uma linha é configurada.
font-family:ubuntu: Define o grupo de letras para usar especificando seu identificador.
font-size:22: Define o tamanho da fonte em pixels.

Escrever as próprias verificações¶

Uma ampla gama de verificações de qualidade são incorporadas, (veja Verificações de qualidade), embora eles possam não cobrir tudo o que deseja verificar. A lista de verificações realizadas pode ser ajustada a usar CHECK_LIST e também pode adicionar verificações personalizadas.

Crie uma subclasse de weblate.checks.Check
Define alguns atributos.
Implemente o método check (se quiser lidar com plurais no seu código) ou o método check_single (que faz isso por si).

Alguns exemplos:

Para instalar verificações personalizadas, forneça um caminho totalmente qualificado à classe Python em CHECK_LIST, veja Verificações de qualidade personalizadas, sugestões automáticas, extensões e correções automáticas.

Verificar se o texto de tradução não contém «foo»¶

Esta é uma verificação bastante simples que apenas verifica se a tradução não possui a cadeia «foo».

"""Simple quality check example."""

from django.utils.translation import gettext_lazy

from weblate.checks.base import TargetCheck


class FooCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    # Might be localized using gettext_lazy
    name = "Foo check"

    # Description for failing check
    description = gettext_lazy("Your translation is foo")

    # Real check code
    def check_single(self, source, target, unit):
        return "foo" in target

A verificar se os plurais de texto da tradução checa são diferentes¶

Usa as informações de idioma para verificar se as duas formas plurais no idioma tcheco não são os mesmos.

"""Quality check example for Czech plurals."""

from django.utils.translation import gettext_lazy

from weblate.checks.base import TargetCheck


class PluralCzechCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    # Might be localized using gettext_lazy
    name = "Foo check"

    # Description for failing check
    description = gettext_lazy("Your translation is foo")

    # Real check code
    def check_target_unit(self, sources, targets, unit):
        if unit.translation.language.is_base({"cs"}):
            return targets[1] == targets[2]
        return False

    def check_single(self, source, target, unit) -> bool:
        """We don't check target strings here."""
        return False