Verificações e correções

Correções automáticas personalizadas

Você também pode implementar sua própria correção automática, além das padrão e incluí-las em AUTOFIX_LIST.

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

Por exemplo, a correção automática a seguir iria substituir cada ocorrência do texto foo, em uma tradução com bar:

from django.utils.translation import gettext_lazy

from weblate.trans.autofixes.base import AutoFix


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

    name = gettext_lazy("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 para a classe Python em AUTOFIX_LIST, consulte Custom quality checks, add-ons, automatic suggestions and auto-fixes.

Personalizando comportamento usando marcadores

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

• Marcadores adicionais do texto fonte:

  • Informações adicionais sobre textos fonte descreve a edição manual.

  • Editor em massa pode ser usado para aplicar marcadores em lote.

  • O complemento Editor em massa pode aplicar marcadores automaticamente.

• Marcadores por texto extraídos do formato do arquivo, consulte Formatos de arquivo de localização.

• Marcadores de tradução (atualmente apenas o marcador somente leitura para texto fonte bilíngue).

• Marcadores específicos do formato de arquivo.

• 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. Você pode usar aspas para incluir espaços em branco ou caracteres especiais no texto. 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 o texto ### Index for traduzido como # Indice.

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

Para garantir que os links internos não estão sendo traduzidos (ou seja, [test](../checks) não se torna [test](../chequeos)).

Marcadores definidos em um nível mais alto podem ser descartados com a sintaxe discard:NAME. Por exemplo, se um componente estiver configurado como safe-html, você poderá adicionar discard:safe-html aos marcadores de texto para ignorá-lo esse texto especifico.

Aqui está uma lista de marcadores atualmente aceitos:

rst-text

Trata um texto como um documento reStructuredText, afeta Tradução não alterada. Ativa Erro de sintaxe reStructuredText e reStructuredText inconsistente.

bbcode-text

Trata um texto como um documento Bulletin Board Code (BBCode), afeta Tradução não alterada.

dos-eol

Usa marcadores de ponta de linha do DOS em vez dos Unix (\r\n em vez de \n).

read-only

O texto é somente leitura e não deve ser editado no Weblate, consulte Textos somente leitura.

terminology

Usado em Glossário. Copia o texto em todos os idiomas do Glossário para que possa ser usado 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 do texto. Os textos de maior prioridade são apresentados primeiro para tradução. A prioridade padrão é 100, a maior prioridade que um texto tem, mais cedo é oferecido para tradução.

max-length:N

Limita o comprimento máximo de um texto a caracteres N, consulte Comprimento máximo da tradução.

xml-text

Trata o texto como documento XML, afeta Sintaxe XML e Marcação XML.

font-family:NAME

Define a família de fontes para verificações da renderização, consulte Gerenciando fontes.

font-weight:WEIGHT

Define o peso da fonte para verificações da renderização, consulte Gerenciando fontes.

font-size:SIZE

Define o tamanho da fonte para verificações da renderização, consulte Gerenciando fontes.

font-spacing:SPACING

Define o espaçamento de letras para verificações da renderização, consulte Gerenciando fontes.

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 tags XML para a verificação de qualidade MessageFormat do ICU.

placeholders:NAME:NAME2:...

Textos de espaço reservado esperados na tradução, consulte Espaços reservados.

replacements:FROM:TO:FROM2:TO2...

Replacements to perform when checking resulting text parameters (for example in Tamanho máximo da tradução or Comprimento máximo da tradução). The typical use case for this is to expand placeables to ensure that the text fits even with long values, for example: replacements:%s:"John Doe".

variants:SOURCE

Marca este texto como uma variante do texto com o fonte correspondente. Consulte Variantes de textos.

regex:REGEX

Expressão regular para corresponder à tradução; consulte Expressão regular.

discard:NAME

Descarta o marcador definido em um nível superior.

forbidden

Indica tradução proibida em um glossário, consulte Traduções proibidas.

strict-same

Faz Tradução não alterada 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 Textos formatados.

check-glossary

Habilita a verificação de qualidade Não segue o glossário.

angularjs-format

Habilita a verificação de qualidade Texto de interpolação AngularJS.

c-format

Habilita a verificação de qualidade Formato C.

c-sharp-format

Habilita a verificação de qualidade Formato C#.

es-format

Habilita a verificação de qualidade Literais de modelo de ECMAScript.

i18next-interpolation

Habilita a verificação de qualidade Interpolação de i18next.

icu-message-format

Habilita a verificação de qualidade MessageFormat do ICU.

java-printf-format

Habilita a verificação de qualidade Formato Java.

java-format

Habilita a verificação de qualidade MessageFormat do Java.

javascript-format

Habilita a verificação de qualidade Formato JavaScript.

lua-format

Habilita a verificação de qualidade Formato Lua.

object-pascal-format

Habilita a verificação de qualidade Formato de Object Pascal.

percent-placeholders

Habilita a verificação de qualidade Espaços reservados de porcentagem.

perl-brace-format

Habilite a verificação de qualidade Formato de chave Perl.

perl-format

Habilita a verificação de qualidade Formato Perl.

php-format

Habilita a verificação de qualidade Formato PHP.

python-brace-format

Habilita a verificação de qualidade Formato de chaves Python.

python-format

Habilita a verificação de qualidade Formato Python.

qt-format

Habilita a verificação de qualidade Formato Qt.

qt-plural-format

Habilita a verificação de qualidade Formato de plural Qt.

ruby-format

Habilita a verificação de qualidade Formato Ruby.

scheme-format

Habilita a verificação de qualidade Formato Scheme.

vue-format

Habilita a verificação de qualidade Formatação Vue I18n.

md-text

Trata o texto como um documento Markdown e fornece destaque de sintaxe Markdown na área de texto da tradução. Habilita as verificações de qualidade Links Markdown, Referências Markdown e Sintaxe Markdown .

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.

safe-html

Habilita a verificação de qualidade HTML inseguro.

url

O texto deve consistir apenas em uma URL. Habilita a verificação de qualidade URL.

ignore-all-checks

Ignora todas as verificações de qualidade.

fluent-source-inner-html

Habilita a verificação de qualidade HTML interno de fonte Fluent.

fluent-source-syntax

Habilita a verificação de qualidade Sintaxe de origem Fluent.

icu-message-format

Habilita a verificação de qualidade Sintaxe de MessageFormat do ICU.

ignore-bbcode

Ignora a verificação de qualidade Marcação de BBCode.

ignore-duplicate

Ignora a verificação de qualidade Há palavras duplicadas de forma consecutiva.

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 Texto de interpolação AngularJS.

ignore-automattic-components-format

Ignora a verificação de qualidade Formatação dos componentes da 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 MessageFormat do Java.

ignore-javascript-format

Ignora a verificação de qualidade Formato JavaScript.

ignore-lua-format

Ignora a verificação de qualidade Formato Lua.

ignore-object-pascal-format

Ignora a verificação de qualidade Formato de Object Pascal.

ignore-percent-placeholders

Ignora a verificação de qualidade Espaços reservados de porcentagem.

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 chaves 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 Formato de 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 usada.

ignore-md-link

Ignora a verificação de qualidade Links Markdown.

ignore-md-reflink

Ignora a verificação de qualidade Referências Markdown.

ignore-md-syntax

Ignora a verificação de qualidade Sintaxe Markdown.

ignore-max-length

Ignora a verificação de qualidade Comprimento máximo da tradução.

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 Caractere de dois pontos não correspondente.

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 incompatí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 descasadas.

ignore-plurals

Ignora a verificação de qualidade Faltam plurais.

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 de 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-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 Linha em branco 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 não alterada.

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 Marcação XML.

ignore-xml-invalid

Ignora a verificação de qualidade Sintaxe XML.

ignore-zero-width-space

Ignora a verificação de qualidade Espaço com largura zero.

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 com falha.

ignore-unnamed-format

Ignora a verificação de qualidade Várias variáveis sem nome.

ignore-optional-plural

Ignora a verificação de qualidade Não pluralizado.

Nota

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

Esses marcadores são entendidos tanto nas configurações de Configuração de componente, por configurações de textos fonte quanto no próprio arquivo de tradução (por exemplo, no GNU gettext).

Location-based flags

Alguns marcadores são adicionados aos textos por padrão, com base em seus locais. Isso significa que determinadas verificações serão automaticamente habilitadas, dependendo de onde o texto for usado.

• rst-text: Esse marcador é adicionado automaticamente aos textos nos arquivos reStructuredText, se a extensão do local for .rst.

• md-text: Esse marcador é automaticamente adicionado aos textos em arquivos Markdown, se a extensão do local for .md ou .markdown.

Forçando verificações

The enforced checks cannot be dismissed and mark string as Needs editing (see Status de tradução). This prevents translators from hiding such checks.

Dica

Turning on check enforcing doesn’t enable it automatically. Some checks have to be turned on by adding the corresponding flag to the string or component flags.

This is best used with checks that can cause serious issues when used like checks for Textos formatados. Using for style checks like Tradução não alterada is not recommended because dismissal is sometimes a reasonable approach in these.

The Commit Policy can then be used to exclude strings needing editing from being committed to the version control.

Ver também

• Status de tradução

• Verificações forçadas

• Commit Policy

• Informações adicionais sobre textos fonte

• Marcadores de tradução

Gerenciando fontes

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 usuário do Weblate.

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

Weblate font management tool in Fonts under the Operations menu of your translation project provides interface to upload and manage fonts. TrueType or OpenType fonts can be uploaded, set up font-groups and use those in the check.

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

O grupos de fontes 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 fontes e o estilo são automaticamente reconhecidos após carregá-los:

Você pode ter um número de fontes carregadas para Weblate:

Para usar as fontes para verificar o comprimento do texto, passe-o os marcadores apropriados (consulte Personalizando comportamento usando marcadores). Você provavelmente precisará dos seguintes:

max-size:500 / max-size:300:5

Define a largura máxima em pixels e, opcionalmente, o número máximo de linhas (a quebra de palavras é aplicada).

font-family:ubuntu

Define o grupo de fontes para usar especificando seu identificador.

font-size:22

Define o tamanho da fonte em pixels.

Escrevendo as próprias verificações

Uma ampla gama de verificações de qualidade estão embutidas, (consulte Verificações de qualidade), embora eles possam não cobrir tudo o que você deseja verificar. A lista de verificações realizadas pode ser ajustada usando CHECK_LIST e você também pode adicionar verificações personalizadas.

1. Crie uma subclasse de weblate.checks.Check

2. Defina alguns atributos.

3. Implemente o método check (se você quiser lidar com plurais em seu código) ou o método check_single (que faz isso por você).

Alguns exemplos:

Para instalar verificações personalizadas, forneça um caminho totalmente qualificado para a classe Python em CHECK_LIST, consulte Custom quality checks, add-ons, automatic suggestions and auto-fixes.

Verificando 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 o texto “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
    name = gettext_lazy("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

Verificando se os plurais de texto de tradução tcheca 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
    name = gettext_lazy("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