Markdown

Traduza o texto do documento e os campos selecionados dos metadados iniciais, preservando o código, os links e a estrutura necessária para reutilizar traduções aprovadas.

Um documento Markdown combina texto explicativo com uma estrutura que facilita a leitura. O processador de arquivos md traduz o texto de títulos, parágrafos, células de tabelas e rótulos de diretivas compatíveis, preservando o código e os destinos dos links. O resultado continua em Markdown, pronto para o renderizador que você já usa.

Texto e estrutura protegida #

Por exemplo, o texto do link pode mudar, enquanto o destino e o nome da função permanecem inalterados:

markdown
---
title: Delivery options
description: Choose how your order arrives.
slug: delivery
---

## Choose delivery

Read the [delivery policy](/policies/delivery) before calling `confirmOrder()`.

O título, o texto do parágrafo e o texto do link são conteúdo textual. Já o destino do link e o código em linha são estruturas protegidas. No perfil padrão de documentos, blocos de código delimitados e HTML bruto ficam fora da extração de texto. Use HTML quando a origem for um documento HTML ou Markdoc quando tags personalizadas do Markdoc fizerem parte da linguagem do documento.

Seleção de metadados iniciais #

Por padrão, o processador de arquivos seleciona title e description. Os demais campos permanecem inalterados, a menos que sejam selecionados explicitamente. Uma lista translateFrontmatterFields vazia desativa a tradução dos metadados iniciais. A escolha dos campos é uma decisão de conteúdo: um título destinado à leitura pode ser traduzido, enquanto um slug, um identificador de componente ou uma chave de roteamento pode precisar permanecer inalterado.

Os caminhos de campo compatíveis podem apontar para valores aninhados, incluindo elementos de sequências. Ao selecionar um mapa ou uma sequência, seus descendentes escalares também são incluídos. Escolha um caminho específico, como seo.title, quando os campos de roteamento vizinhos precisarem permanecer inalterados. Use as opções de metadados iniciais da interface selecionada para escolher o texto a traduzir.

A reutilização exige documentos alinhados #

O processador compara as unidades de texto com a versão anterior da origem e a tradução correspondente e, em seguida, insere as traduções alteradas na estrutura atual da origem. As traduções existentes só podem ser reutilizadas quando essa correspondência está clara. Se a versão anterior da origem e a tradução tiverem estruturas protegidas em linha diferentes, a reutilização poderá falhar por incompatibilidade de estrutura.

Guarde a revisão da origem associada à tradução aprovada. Se o documento traduzido tiver sido reorganizado de forma independente, alinhe sua estrutura à dessa versão da origem antes de solicitar uma atualização incremental. Gere o resultado com o processador Markdown do seu site para verificar as construções específicas da variante usada.

Configurar e renderizar o documento #

A CLI infere md a partir de .md. Configure a seleção de arquivos, os campos de metadados iniciais e os caminhos de saída em Configuração da CLI ou use o GitHub para a tradução gerenciada de repositórios. O escopo de chave da CLI não está disponível para Markdown.

Renderize a saída com o processador Markdown do seu site. Verifique em conjunto os metadados traduzidos, os links, os fragmentos de títulos e os exemplos de código. Preservar /policies/delivery não cria essa página em outro idioma. O guia de conteúdo estático mostra como conectar os caminhos de saída ao carregador do site e às rotas de idioma.