Ficheiros de Marcação¶

Added in version 5.0.

O conteúdo traduzível é extraído dos ficheiros Markdown e oferecido para a tradução. Para ficheiros Markdown com sintaxe JSX, utilize Ficheiros MDX.

Unidades Markdown obtêm automaticamente os sinalizadores md-text, auto-safe-html and strict-same. Isto mantêm a verificação de HTML inseguro ativa para texto simples, HTML padrão, e elementos personalizados enquanto que evita limpeza HTML em sintaxe de parêntesis retos não HTML tal como componentes MDX ou do tipo JSX. Use o sinalizador safe-html para cadeias de carateres que se sabe que contêm HTML e devem ser sempre validadas, incluindo porções SVG ou MathML.

Nota

Ao contrário da maioria dos outros formatos, as alterações nos ficheiros de tradução não serão importadas para o Weblate porque isso não pode ser feito de forma confiável. A fonte da verdade para as traduções é o Weblate, não o ficheiro traduzido.

Veja também

Markdown

Exemplo de ficheiro:

# Ahoj světe!

Orangutan has five bananas.

Try Weblate at [weblate.org](https://demo.weblate.org/)!

*Thank you for using Weblate.*

Recursos suportados¶
Extensões de ficheiro	`.markdown`, `.md`
Lingualidade ⓘ	Monolingue
Suporta plural ⓘ	`No`
Suporta descrições ⓘ	`No`
Suporta explicação ⓘ	`No`
Suporta contexto ⓘ	`No`
Suporta localização ⓘ	`No`
Suporta marcadores ⓘ	`No`
Identificador API	`markdown`
Suporta cadeias de carateres apenas de leitura ⓘ	`No`
Suporta a remoção de cadeias de careteres obsoletas ⓘ	`No`
Marcadores de verificação adicionados por este formato ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Configuração do Weblate¶

Configuração de componente típica do Weblate
Máscara de ficheiros	`path/*.md`
Ficheiro de idioma base monolingue	`path/en.md`
Modelo para novas traduções	`path/en.md`
Formato de ficheiro	Ficheiro Markdown
Parâmetros de formato de ficheiro	`markdown_merge_duplicates=True`

Gerir cadeias de carateres duplicadas¶

Por predefinição, o Weblate trata cada ocorrência de uma cadeia de carateres como uma unidade de tradução separada para fornecer contexto baseado em linhas. Isto pode ser problemático para tabelas Markdown, onde reordenar linhas muda o contexto e pode levar a perda de tradução.

Para consolidar cadeias de carateres idênticas em uma única unidade de tradução, ative Deduplicar cadeias de carateres idênticas no Parâmetros de formato de ficheiro.

Nota

Ativar esta opção desativa contexto baseado em linha para as unidade unidas, assegurando que traduções permanecem estáveis ainda que linhas ou secções sejam movidas para dentro do documento.

Traduzir valores de informações iniciais¶

Por predefinição, as informações iniciais YAML é extraída em um único bloco traduzível. Ative Traduzir valores das informações iniciais em Parâmetros de formato de ficheiro, para analisar as informações iniciais YAML e traduzir apenas valores escalares de cadeias de carateres enquanto se preserva chaves, estrutura, comentários, e formatação sempre que possível. A mesma definição está disponível para ficheiros Ficheiros MDX.