Ficheiros MDX¶

Added in version 2026.5.

Nota

O apoio para este formato está em desenvolvimento. Alguns recursos podem não estar disponíveis ainda e o comportamento pode mudar entre as versões. O feedback dos testes é bem-vindo.

Ficheiros MDX são ficheiros Markdown com sintaxe JSX. O Weblate extrai texto Markdown traduzível e preserva importações, exportações, componentes JSX, e expressões.

Unidades MDX automaticamente possuem os marcadores md-text, auto-safe-html, strict-same e safe-mdx. Isto mantém a verificação de HTML inseguro ativo para texto simples, HTML padrão, e elementos personalizados enquanto que evita limpeza HTML e sintaxe MDX e do tipo JSX. Utilize o marcador safe-html explícito para cadeias de carateres que se sabe que contêm HTML e dever ser sempre validadas, incluíndo excertos 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

MDX

Exemplo de ficheiro:

---
title: Ahoj světe!
description: Learn with Weblate
---

import LessonCard from "./LessonCard"
export const metadata = { slug: "intro" }

# Ahoj světe!

<LessonCard title="Keep this code" count={5}>
  Do not translate this JSX body.
</LessonCard>

Orangutan has five bananas.

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

*Thank you for using Weblate.*

Recursos suportados¶
Extensões de ficheiro	`.mdx`
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	`mdx`
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`, MDX Seguro

Configuração do Weblate¶

Configuração de componente típica do Weblate
Máscara de ficheiros	`path/*.mdx`
Ficheiro de idioma base monolingue	`path/en.mdx`
Modelo para novas traduções	`path/en.mdx`
Formato de ficheiro	Ficheiro MDX
Parâmetros de formato de ficheiro	`mdx_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 MDX, onde reordenar mudanças altera 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.