Formatos de ficheiro de localização

O Weblate suporta uma ampla gama de formatos de tradução. Cada formato é ligeiramente diferente e fornece um conjunto diferente de capacidades.

Dica

Ao escolher um formato de ficheiro para a sua aplicação, é melhor pôr algum formato bem estabelecido no kit de ferramentas/plataforma que usa. Dessa forma, os seus tradutores podem usar adicionalmente todas as ferramentas que estão acostumados e provavelmente contribuirão para o seu projeto.

Deteção automática

O Weblate tenta detetar o formato do ficheiro enquanto vai Adicionar projetos e componentes de tradução. A detecção pode estar errada para diferentes variantes do mesmo formato de serialização (JSON, YAML, propriedades) ou codificação de ficheiro, então verifique se o Formato de ficheiro está correto antes de criar o componente.

Capacidades dos tipos de tradução

Por favor consulte a página de documentação para cada formato de ficheiro individual para informação sobre quais funcionalidades são suportadas nesse formato.

Formatos bilíngues e monolíngues

Ambos os formatos monolingual e bilingual são suportados. Formatos bilingues armazenam dois idiomas num único ficheiro e tradução (exemplos típicos são GNU gettext PO (Objeto Portátil), XLIFF 1.1 e 1.2 ou Cadeias de carateres para Apple iOS). Por outro lado, formatos monolingues identificam a cadeia por ID e cada ficheiro de idioma contém apenas o mapeamento desses para qualquer idioma (tipicamente Recursos de cadeias de carateres para Android). Alguns formatos de ficheiro são utilizados em ambas as variantes, veja a descrição detalhada abaixo.

Para o uso correto de ficheiros monolingues, Weblate requer acesso a um ficheiro a conter uma lista completa de cadeias para traduzir com a fonte dele – este ficheiro é chamado de Ficheiro de idioma base monolingue dentro do Weblate, embora a nomenclatura possa variar no seu paradigma.

Além disso, este fluxo de trabalho pode ser estendido a usar Ficheiro de idioma intermédio para incluir cadeias fornecidas pelos programadores, mas não para ser usado como está nos textos finais.

Estados de cadeias

Muitos formatos de ficheiro diferenciam apenas cadeias «Não traduzidos» e «Traduzidos». Com alguns formatos, é possível armazenar informações de status mais refinadas, como «Necessita de edição» ou «Aprovado».

Descrição da cadeia fonte

As descrições da cadeia fonte podem ser usadas para passar informações adicionais sobre a cadeia a traduzir.

Vários formatos têm suporte nativo para fornecer informações adicionais aos tradutores (por exemplo, XLIFF 1.1 e 1.2, GNU gettext PO (Objeto Portátil), JSON WebExtension, Ficheiros CSV, Excel Open XML, Qt Linguist - .ts, Ficheiros JSON go-i18n, Ficheiros gotext JSON, Ficheiro ARB, Ficheiros de recursos .NET (RESX, RESW)). Muitos outros formatos extraem o comentário mais próximo como descrição da cadeia fonte.

Explicação

A Explicação em cadeias pode ser armazenada e analisada a partir de alguns formatos de ficheiro.

Atualmente suportada apenas em Formato TermBase eXchange.

Localização da cadeia fonte

A localização de uma cadeia no código-fonte pode ajudar tradutores proficientes a descobrir como a cadeia é usada.

Essas informações geralmente estão disponíveis em formatos bilíngues, onde os cadeias são extraídas do código-fonte usando ferramentas. Por exemplo, GNU gettext PO (Objeto Portátil) e Qt Linguist - .ts.

Marcadores de tradução

Os sinalizadores de tradução permitem personalizar o comportamento do Weblate. Alguns formatos suportam a definição deles no ficheiro de tradução (sempre pode defini-los na interface do Weblate, consulte Personalizando comportamento a usar marcadores).

Esta funcionalidade é modelada em sinalizadores em GNU gettext PO (Objeto Portátil).

Adicionalmente, formatos baseados em XML que suportam marcadores extraem-nos do atributo não padrão weblate-flags. O marcador max-length:N também é suportado através do atributo maxwidth como definido no padrão XLIFF, consulte Especificação de bandeiras de tradução.

Contexto

O contexto é utilizado para diferenciar as cadeias de carateres idênticas num formato bilingue utilizadas em âmbitos diferentes (por exemplo, Dom pode ser utilizado como um nome abreviado do dia «Domingo» ou como o nome da nossa estrela mais próxima).

Para formatos monolíngues, o identificador de cadeia (geralmente chamado de chave) pode servir ao mesmo propósito e não é necessário contexto adicional.

Cadeias pluralizadas

Os plurais são necessários para localizar adequadamente as cadeias com contagem variável. As regras dependem de um idioma de destino e muitos formatos seguem a especificação CLDR para isso.

Suporte de plural na tabela de funcionalidades suportadas significa que o Weblate pode representar cadeias de carateres plurais para o formato. Alguns formatos precisam de metadados de plural existentes ou uma variante específica, e não podem criar novas cadeias de carateres plurais a não ser que sejam suportadas nativamente pelo formato.

Dica

Cadeias pluralizantes também precisam de apoio adequado da estrutura da aplicação. Escolha o formato nativo da sua plataforma, como GNU gettext PO (Objeto Portátil), Recursos de cadeias de carateres para Android ou Formato stringsdict.

Multivalue formats

Multivalue formats, such as Ficheiro CSV com vários valores and Formato TermBase eXchange, store independent source and target alternatives within one string. These alternatives have no one-to-one pairing, and their counts do not follow grammatical plural rules.

Source checks inspect every source alternative. Target checks compare each target alternative with the source alternatives. A target passes when it matches any source alternative, independently of their order or the languages” grammatical plural forms. The Unchanged translation check instead reports targets identical to any source alternative, subject to its usual exemptions. Automatic fixes are applied only when all source alternatives produce the same correction.

Machine translation suggestions translate each source alternative independently. Automatic machine translation supports strings with one source alternative and at most one target alternative; it skips strings with multiple alternatives to preserve them. Translation service glossaries can use all alternatives. Automatic Memória de Tradução contributions skip strings with multiple alternatives.

LLM translation services use only strings with one source alternative and one target alternative as examples of previous translations. They omit existing translation context for strings with multiple alternatives.

Cadeias apenas de leitura

Serão incluídas cadeias apenas de leitura dos ficheiros de tradução, mas não podem ser editadas no Weblate. Esta funcionalidade é suportado nativamente por poucos formatos (XLIFF 1.1 e 1.2 e Recursos de cadeias de carateres para Android), mas pode ser emulada em outros ao adicionar um marcador read-only, consulte Personalizando comportamento a usar marcadores.

Remoção de cadeias de carateres obsoletas

Alguns formatos de ficheiros podem ser cadeias de carateres obsoletas. O Weblate pode remover estas cadeias de carateres obsoletas de formatos que suportem esta operação.

Suportando outros formatos

A maioria dos formatos suportados pelo translate-toolkit que suportem serialização podem ser facilmente suportados, mas (ainda) não foram alvo de testes. Na maior parte dos casos é necessária uma camada fina adicional ao Weblate para ocultar diferenças no comportamento de diferentes armazenamentos.

Para adicionar suporte para um novo formato, a abordagem preferida é primeiro implementar o suporte para ele no translate-toolkit.

Parâmetros de formato de ficheiro

Parâmetros de formato de ficheiro fornece uma maneira de configurar definições relacionadas ao formato do ficheiro. Eles são configurados ao nível do componente e permitem-lhe personalizar como é que análise e serialização de ficheiro é feita.

For supported XML formats, xml_utf8_bom controls the UTF-8 byte order mark: preserve keeps the input file’s BOM, include always writes it, and omit removes it. The default is preserve; new files without a template omit the BOM. Other encodings are unchanged.

The xml_encoding_case parameter selects uppercase or lowercase encoding names in the XML declaration, such as UTF-8 or utf-8. The default, default, uses the format’s native casing.

The xml_final_newline parameter controls the newline after the complete XML document, including any trailing comments or processing instructions. Choose include for exactly one final line ending, or omit for none. The default, default, leaves the format’s behavior unchanged. Explicit inclusion uses the serializer’s line-ending style, falling back to LF when the output contains no line endings. Translation-content whitespace is unchanged.

Lista de parâmetros de formato de ficheiro

Nome do parâmetro

Formatos de ficheiro

Etiqueta

Texto de ajuda

csv_encoding

  • csv

  • csv-multi

Codificação de ficheiro

Codificação utilizada para os ficheiros CSV

Escolhas disponíveis:

auto

Auto Detetar

utf-8

UTF-8

csv_escape_formulas

  • csv

  • csv-multi

  • csv-simple

Escapar fórmulas de folha de cálculo

Valores de prefixo que parecem fórmulas de folha de cálculo com um apóstrofe ao gravar ficheiros CSV.

csv_simple_encoding

  • csv-simple

Codificação de ficheiro

Codificação utilizada para os ficheiros CSV simples

Escolhas disponíveis:

auto

Auto Detetar

utf-8

UTF-8

iso-8859-1

ISO-8859-1

dos_eol

Todos os formatos de ficheiro

Finais de linha DOS

Usar terminações de linha DOS (rn) em vez de terminações de linha UNIX (n) em cadeias de carateres.

flatxml_key_name

  • flatxml

Nome chave de FlatXML

flatxml_root_name

  • flatxml

Nome Raiz FlatXML

flatxml_value_name

  • flatxml

Nome do valor FlatXML

gwt_encoding

  • gwt

Codificação de ficheiro

Codificação utilizada pelos ficheiros GWT Properties

Escolhas disponíveis:

utf-8

UTF-8

iso-8859-1

ISO-8859-1

json_indent

  • json

  • json-nested

  • webextension

  • i18next

  • i18nextv4

  • arb

  • go-i18n-json

  • go-i18n-json-v2

  • formatjs

  • gotext

Indentação JSON

json_indent_style

  • json

  • json-nested

  • webextension

  • i18next

  • i18nextv4

  • arb

  • go-i18n-json

  • go-i18n-json-v2

  • formatjs

  • gotext

Estilo de indentação JSON

Escolhas disponíveis:

spaces

Espaços

tabs

Abas

json_sort_keys

  • json

  • json-nested

  • webextension

  • i18next

  • i18nextv4

  • arb

  • go-i18n-json

  • go-i18n-json-v2

  • formatjs

  • gotext

Ordenar chaves JSON

Escolhas disponíveis:

none

Do not sort

case_sensitive

Case-sensitive sort

case_insensitive

Case-insensitive sort

json_use_compact_separators

  • json

  • json-nested

  • webextension

  • i18next

  • i18nextv4

  • arb

  • go-i18n-json

  • go-i18n-json-v2

  • formatjs

  • gotext

Evite espaços após os separadores

line_max_length

  • markdown

  • mdx

Tamanho de linha máxima

O número máximo de carateres para cada linha no ficheiro de saída.

md_extract_code_blocks

  • markdown

  • mdx

Extrair blocos de código

Se se extrai o não conteúdo traduzível de blocos de código em Markdown e ficheiros MDX.

md_extract_frontmatter

  • markdown

  • mdx

Extrair conteúdo da frente

Se se extrai e traduz ou não blocos de conteúdo YAML da frente em ficheiros Markdown e MDX.

md_frontmatter_translate_values

  • markdown

  • mdx

Traduzir valores de matéria frontal

Analizar matéria frontal YAML e traduzir apenas valores de cadeias de carateres escalares. Chaves, estrutura, comentários, e formatação são preservados quando possível.

md_no_placeholders

  • markdown

  • mdx

Desativar espaços reservados

Desativa deteção e processamento de espaços de reserva em ficheiros Markdown e MDX.

merge_duplicates

  • markdown

  • mdx

  • html

  • txt

  • dokuwiki

  • mediawiki

  • asciidoc

De duplicar cadeias de carateres idênticas

Consolida as cadeias de carateres fonte idênticas numa única unidade de tradução. Previne a perda de tradução durante a reestruturação de ficheiro ou a reordenação de tabela, removendo o contexto dependente da posição.

po_contributor_comments

  • po

  • po-mono

Contributor comments

Add contributor names and years to header comments. SPDX also converts existing recognized contributor comments to SPDX-FileCopyrightText entries.

Escolhas disponíveis:

none

Desativado

gettext

Gettext

spdx

SPDX

po_fuzzy_matching

  • po

Utilizar correspondência aproximada

po_keep_previous

  • po

Manter «msgids» anteriores das cadeias traduzidas

Controla comentários msgid anteriores para cadeias de carateres imprecisas.

po_line_wrap

  • po

  • po-mono

Ajuste de linhas longas

Por predefinição, gettext quebra as linhas com 77 carateres e nas novas linhas. Com o parâmetro --no-wrap, a quebra só é realizada nas novas linhas.

Escolhas disponíveis:

77

Quebrar linhas com 77 carateres e nas novas linhas (predefinição de xgettext)

65535

Apenas molda linhas em linhas novas (tal como xgettext --no-wrap)

-1

Sem quebra de linhas

po_no_location

  • po

Não incluir informações de local no ficheiro

po_remove_obsolete

  • po

  • po-mono

Remover cadeias de carateres obsoletas

Remover entradas obsoletas de ficheiros PO ao guardar mudanças de tradução ou ao atualizar através de um ficheiro POT.

po_report_msgid_bugs_to

  • po

  • po-mono

Comunicar erros msgid a

Permite ao Weblate atualizar o cabeçalho do ficheiro «Reportar-Erros-Msgid» se o endereço da cadeia de carateres fonte do relatório está definida.

po_set_language_team

  • po

  • po-mono

Atualizar cabeçalho de equipa de idioma

Permite ao Weblate atualizar o cabeçalho do ficheiro «Idioma-Equipa».

po_set_last_translator

  • po

  • po-mono

Atualizar o último cabeçalho de tradutor

Permite ao Weblate atualizar cabeçalho do ficheiro «Último-Tradutor».

po_set_x_generator

  • po

  • po-mono

Atualizar cabeçalho X-Generator

Permite ao Weblate atualizar o cabeçalho do ficheiro «X-Generator».

properties_encoding

  • properties

Codificação de ficheiro

Codificação utilizada nos ficheiros Java Properties

Escolhas disponíveis:

iso-8859-1

ISO-8859-1

utf-8

UTF-8

utf-16

UTF-16

strings_encoding

  • strings

Codificação de ficheiro

Codificação utilizada para os ficheiros das cadeias de carateres iOS

Escolhas disponíveis:

utf-8

UTF-8

utf-16

UTF-16

xliff_placeables

  • xliff

  • xliff2

Placeables support

Controls whether inline XML elements inside XLIFF strings are preserved as editable placeables. Plain text only escapes XML markup and treats the content as text. With placeables supported, tags such as <x id=»name»/> or <g> stay in the string and appear as placeholders in the editor

Escolhas disponíveis:

plain

Plain text only

placeables

Support placeables

xml_closing_tags

  • ts

  • xliff

  • xliff2

  • poxliff

  • apple-xliff

  • resx

  • aresource

  • moko-resource

  • cmp-resource

  • tbx

Incluir etiqueta de fecho para as etiquetas XML em branco

xml_encoding_case

  • ts

  • xliff

  • xliff2

  • poxliff

  • apple-xliff

  • resx

  • aresource

  • moko-resource

  • cmp-resource

  • tbx

XML declaration encoding case

Controls encoding names in the XML declaration, for example «UTF-8» or «utf-8».

Escolhas disponíveis:

default

Format default

uppercase

Uppercase

lowercase

Lowercase

xml_final_newline

  • ts

  • xliff

  • xliff2

  • poxliff

  • apple-xliff

  • resx

  • aresource

  • moko-resource

  • cmp-resource

  • tbx

XML final newline

Controls the newline at the end of the file, using the format’s line endings.

Escolhas disponíveis:

default

Format default

include

Always include

omit

Always omit

xml_utf8_bom

  • ts

  • xliff

  • xliff2

  • poxliff

  • apple-xliff

  • resx

  • aresource

  • moko-resource

  • cmp-resource

  • tbx

UTF-8 byte order mark

Controls the UTF-8 byte order mark. Other encodings are unchanged. New files without a template omit the mark when preserving input.

Escolhas disponíveis:

preserve

Preserve input

include

Always include

omit

Always omit

xml_whitespace_handling

  • xliff

  • poxliff

  • apple-xliff

  • xliff2

Whitespace handling

Controls how XLIFF whitespace is handled. Follow xml:space honors attributes in the file. Always preserve keeps all whitespace. Always normalize collapses whitespace even when xml:space=»preserve» is set.

Escolhas disponíveis:

standard

Follow xml:space

preserve

Always preserve

normalize

Always normalize

yaml_indent

  • yaml

  • ruby-yaml

Indentação de YAML

yaml_line_break

  • yaml

  • ruby-yaml

Quebras de linha

Escolhas disponíveis:

dos

DOS (\r\n)

unix

UNIX (\n)

mac

MAC (\r)

yaml_line_wrap

  • yaml

  • ruby-yaml

Ajuste de linhas longas

Escolhas disponíveis:

80

Quebrar linhas aos 80 carateres

100

Quebrar linhas aos 100 carateres

120

Quebrar linhas aos 120 carateres

180

Quebrar linhas aos 180 carateres

65535

Sem quebra de linhas