Markdoc

Traduza o texto em Markdoc e os atributos de texto selecionados, preservando anotações, variáveis e código.

As anotações Markdoc ligam o texto do documento a componentes personalizados e variáveis. O processador de ficheiros markdoc traduz o texto suportado e os atributos de etiquetas selecionados que contêm valores de texto, preservando as anotações de que o renderizador precisa.

Selecionar propriedades visíveis das etiquetas #

Um documento pode combinar metadados visíveis, um identificador de disposição fixo e uma chamada de atenção:

markdown
---
title: Delivery options
description: Understand the available delivery methods.
layout: article
---

{% callout title="Delivery deadline" type="warning" %}
Confirm your address before checkout.
{% /callout %}

O parágrafo e os campos title e description dos metadados iniciais, selecionados por predefinição, são conteúdo textual. O atributo title da etiqueta é incluído na tradução quando uma regra de propriedade o seleciona. type="warning" e layout: article são identificadores estruturais; deixe-os por selecionar, a menos que o componente que os utiliza exija explicitamente valores traduzidos.

As regras podem aplicar um nome de propriedade a todas as etiquetas ou restringir a sua aplicação a etiquetas específicas. Prefira a opção restrita quando diferentes etiquetas utilizarem o mesmo atributo para fins distintos. Os atributos numéricos, booleanos, derivados de variáveis e outros atributos sem valores de texto não constituem unidades de texto literal.

O que fica protegido #

Os blocos de código delimitados e o código em linha ficam fora da tradução. As ligações mantêm os seus destinos, embora os rótulos possam mudar. As anotações em linha e as imagens são estruturas protegidas no texto envolvente. Os nomes das etiquetas e os atributos não selecionados mantêm-se no documento. O processador aplica as sequências de escape necessárias aos atributos de texto traduzidos para respeitar as regras de utilização de aspas do Markdoc, mas não fornece o esquema de etiquetas personalizadas do renderizador.

Os campos title e description dos metadados iniciais são selecionados por predefinição. Se a seleção de metadados iniciais estiver vazia, estes campos mantêm-se inalterados. Ao selecionar um mapa ou uma sequência, inclui também os respetivos descendentes escalares. Escolha caminhos precisos, como seo.title, quando os campos de encaminhamento ou os identificadores de conteúdo adjacentes tiverem de permanecer inalterados.

Preservar o alinhamento entre a origem e o destino #

A reconstrução substitui segmentos de texto na origem atual e pode reutilizar texto de uma versão anterior da origem e da respetiva tradução alinhada. Se não houver uma correspondência segura entre as estruturas em linha protegidas de ambas, a reutilização pode falhar. Guarde a revisão da origem que acompanhou a tradução aceite, sobretudo depois de mover etiquetas ou alterar ligações.

Não parta do princípio de que um documento .md com anotações Markdoc será tratado por este processador. A CLI infere o formato Markdown para .md; selecione explicitamente o formato quando a linguagem do documento exigir o comportamento do Markdoc.

Configurar a tradução de Markdoc #

A CLI infere markdoc a partir de .mdoc; não é possível delimitar o âmbito por chave. Utilize a configuração da CLI para definir os metadados iniciais, a seleção de propriedades das etiquetas e a disposição do destino, ou o GitHub para o workflow do repositório.

Validar com o esquema do site #

O processador de ficheiros não configura as rotas da estrutura de desenvolvimento, o carregamento de conteúdo nem as transformações Markdoc da aplicação. Depois de obter o documento de destino, faça a análise sintática e a renderização com os mesmos esquemas da origem. Verifique os atributos visíveis, os destinos das ligações, as variáveis e os metadados iniciais selecionados, juntamente com os parágrafos traduzidos.