MDX
Traduza o texto em MDX e as propriedades literais selecionadas dos componentes, preservando expressões, importações e a estrutura dos componentes.
O MDX permite incluir componentes interativos junto ao texto de um artigo. O processador de arquivos mdx traduz o texto e os elementos filhos de componentes compatíveis, preservando a marcação. Selecione explicitamente as propriedades literais dos componentes quando elas também contiverem texto visível aos leitores; importações e expressões não são executadas para identificar texto.
Separe o texto dos dados dos componentes #
Por exemplo, uma caixa de destaque tem um título visível e uma propriedade que controla seu comportamento:
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>O título e o texto dos elementos filhos são conteúdo para tradução. kind é um dado do componente que deve permanecer inalterado. title só entra na tradução quando uma regra de propriedades de componentes o seleciona. Uma regra restrita a Callout e title é mais segura do que traduzir todos os atributos com esse nome em componentes sem relação entre si.
Há suporte para propriedades com valores literais de texto. Uma propriedade calculada por uma expressão não equivale a uma mensagem literal. Importações, expressões JavaScript e blocos de código ficam fora da extração comum de texto. A estrutura dos componentes ainda precisa ser compatível com o renderizador da aplicação.
Frontmatter e âncoras de títulos #
Por padrão, o processador de arquivos seleciona title e description no frontmatter. Forneça uma seleção vazia para manter o frontmatter sem tradução. Ao selecionar um mapa ou uma sequência, seus descendentes escalares também são incluídos. Por isso, escolha caminhos precisos, como seo.title, quando os campos de roteamento vizinhos precisarem permanecer inalterados. Consulte Configuração da CLI para saber mais sobre translateFrontmatterFields e translateComponentProps.
As âncoras de títulos do Docusaurus, como {#delivery}, são preservadas quando o texto do título é alterado. O tratamento de âncoras reconhece a sintaxe das linhas de título fora de blocos de código delimitados e mantém os slugs de URL inalterados. Verifique o ID do título renderizado e os links que apontam para ele no seu site.
Atualizações e alinhamento #
A redação existente pode ser reaproveitada quando a versão anterior do texto de origem e a tradução têm unidades de texto e estruturas protegidas em linha correspondentes. Se essa correspondência for ambígua, o processador poderá rejeitar o reaproveitamento. Mantenha as traduções aceitas vinculadas à revisão correspondente do texto de origem, em vez de fornecer, sem aviso, um documento sem relação estrutural com ela.
Confira as propriedades selecionadas após a reconstrução, incluindo os rótulos visíveis fora do texto dos elementos filhos, e compile o resultado com o processador MDX da sua aplicação.
Configure a tradução de MDX #
A CLI infere mdx a partir de .mdx; o escopo por chave não está disponível para este formato. Consulte Configuração da CLI ou GitHub para ver as opções de arquivo.
Verifique o componente renderizado #
Compile o MDX obtido com o processador que você usa na aplicação e confira, em conjunto, as propriedades dos componentes, as âncoras, as variáveis e os exemplos de código. A tradução de arquivos MDX preserva um documento que contém JSX; já a extração de mensagens do React identifica chamadas compatíveis no código-fonte da aplicação e gera catálogos. Escolha o workflow adequado ao local em que a mensagem é criada.