Markdown

Traduza o texto do documento e os metadados iniciais selecionados, preservando o código, as ligações e a estrutura necessária para reutilizar formulações aprovadas.

Um documento Markdown combina texto explicativo com uma estrutura que orienta a leitura. O processador de ficheiros md traduz o texto de títulos, parágrafos, células de tabelas e etiquetas de diretivas suportadas, preservando o código e os destinos das ligações. O resultado mantém-se em Markdown, pronto para o renderizador que já utiliza.

Texto e estrutura protegida #

Por exemplo, o texto da ligação 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 da ligação são conteúdo textual. O destino da ligação e o código em linha são elementos de estrutura protegida. No perfil de documento padrão, os blocos de código delimitados e o HTML em bruto ficam excluídos da extração de texto. Utilize HTML quando o documento de origem estiver em HTML ou Markdoc quando as etiquetas Markdoc personalizadas fizerem parte da linguagem do documento.

Seleção de metadados iniciais #

Por predefinição, o processador de ficheiros seleciona title e description. Os restantes 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 identificador de URL, um identificador de componente ou uma chave de encaminhamento podem ter de permanecer inalterados.

Os caminhos de campos suportados permitem aceder a valores aninhados, incluindo elementos de sequências. Selecionar um mapa ou uma sequência inclui os respetivos valores escalares descendentes. Escolha um caminho preciso, como seo.title, quando os campos de encaminhamento adjacentes tiverem de permanecer inalterados. Utilize as opções de metadados iniciais da interface selecionada para escolher o texto.

A reutilização exige documentos alinhados #

O processador estabelece a correspondência entre as unidades de texto, o documento de origem anterior e a respetiva tradução e, em seguida, insere as traduções alteradas na estrutura do documento de origem atual. Só é possível reutilizar formulações existentes quando essa correspondência é clara. Se o documento de origem anterior e a tradução contiverem estruturas protegidas em linha diferentes, a reutilização pode falhar devido a uma incompatibilidade de estrutura.

Guarde a revisão do documento de origem associada às formulações aprovadas na tradução. Se a tradução tiver sido reorganizada de forma independente, alinhe a respetiva estrutura com esse documento antes de solicitar uma atualização incremental. Gere o resultado com o processador Markdown do seu site para verificar quaisquer construções específicas do dialeto.

Configurar e renderizar o documento #

A CLI infere md a partir de .md. Configure a seleção de ficheiros, os campos de metadados iniciais e os caminhos de saída em Configuração da CLI ou utilize o GitHub para a tradução gerida do repositório. O âmbito das chaves da CLI não está disponível para Markdown.

Renderize o resultado com o processador Markdown do seu site. Verifique em conjunto os metadados traduzidos, as ligações, os fragmentos dos títulos e os exemplos de código. Preservar /policies/delivery não cria essa página noutro idioma. O guia de conteúdo estático relaciona os caminhos de saída com o carregador do site e as rotas dos idiomas.