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.
Veja também
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.
Veja também
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 |
|
Codificação de ficheiro |
Codificação utilizada para os ficheiros CSV Escolhas disponíveis:
|
csv_escape_formulas |
|
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 |
|
Codificação de ficheiro |
Codificação utilizada para os ficheiros CSV simples Escolhas disponíveis:
|
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 |
|
Nome chave de FlatXML |
|
flatxml_root_name |
|
Nome Raiz FlatXML |
|
flatxml_value_name |
|
Nome do valor FlatXML |
|
gwt_encoding |
|
Codificação de ficheiro |
Codificação utilizada pelos ficheiros GWT Properties Escolhas disponíveis:
|
json_indent |
|
Indentação JSON |
|
json_indent_style |
|
Estilo de indentação JSON |
Escolhas disponíveis:
|
json_sort_keys |
|
Ordenar chaves JSON |
Escolhas disponíveis:
|
json_use_compact_separators |
|
Evite espaços após os separadores |
|
line_max_length |
|
Tamanho de linha máxima |
O número máximo de carateres para cada linha no ficheiro de saída. |
md_extract_code_blocks |
|
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 |
|
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 |
|
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 |
|
Desativar espaços reservados |
Desativa deteção e processamento de espaços de reserva em ficheiros Markdown e MDX. |
merge_duplicates |
|
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 |
|
Contributor comments |
Add contributor names and years to header comments. SPDX also converts existing recognized contributor comments to SPDX-FileCopyrightText entries. Escolhas disponíveis:
|
po_fuzzy_matching |
|
Utilizar correspondência aproximada |
|
po_keep_previous |
|
Manter «msgids» anteriores das cadeias traduzidas |
Controla comentários msgid anteriores para cadeias de carateres imprecisas. |
po_line_wrap |
|
Ajuste de linhas longas |
Por predefinição, gettext quebra as linhas com 77 carateres e nas novas linhas. Com o parâmetro Escolhas disponíveis:
|
po_no_location |
|
Não incluir informações de local no ficheiro |
|
po_remove_obsolete |
|
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 |
|
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 |
|
Atualizar cabeçalho de equipa de idioma |
Permite ao Weblate atualizar o cabeçalho do ficheiro «Idioma-Equipa». |
po_set_last_translator |
|
Atualizar o último cabeçalho de tradutor |
Permite ao Weblate atualizar cabeçalho do ficheiro «Último-Tradutor». |
po_set_x_generator |
|
Atualizar cabeçalho X-Generator |
Permite ao Weblate atualizar o cabeçalho do ficheiro «X-Generator». |
properties_encoding |
|
Codificação de ficheiro |
Codificação utilizada nos ficheiros Java Properties Escolhas disponíveis:
|
strings_encoding |
|
Codificação de ficheiro |
Codificação utilizada para os ficheiros das cadeias de carateres iOS Escolhas disponíveis:
|
xliff_placeables |
|
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:
|
xml_closing_tags |
|
Incluir etiqueta de fecho para as etiquetas XML em branco |
|
xml_encoding_case |
|
XML declaration encoding case |
Controls encoding names in the XML declaration, for example «UTF-8» or «utf-8». Escolhas disponíveis:
|
xml_final_newline |
|
XML final newline |
Controls the newline at the end of the file, using the format’s line endings. Escolhas disponíveis:
|
xml_utf8_bom |
|
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:
|
xml_whitespace_handling |
|
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:
|
yaml_indent |
|
Indentação de YAML |
|
yaml_line_break |
|
Quebras de linha |
Escolhas disponíveis:
|
yaml_line_wrap |
|
Ajuste de linhas longas |
Escolhas disponíveis:
|