Markdoc
Traduza o texto do Markdoc e os atributos de texto selecionados, preservando anotações, variáveis e código.
As anotações do Markdoc conectam o texto do documento a componentes personalizados e variáveis. O processador de arquivos markdoc traduz os trechos de texto compatíveis e os atributos de tags selecionados que contêm valores de texto, preservando as anotações necessárias para o renderizador.
Selecione as propriedades visíveis das tags #
Um documento pode combinar metadados visíveis, um identificador fixo de layout e um bloco de destaque:
---
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 do frontmatter, selecionados por padrão, são texto. O atributo title da tag entra na tradução quando uma regra de propriedade o seleciona. type="warning" e layout: article são identificadores estruturais; deixe-os fora da seleção, a menos que o código que os utiliza espere explicitamente valores traduzidos.
As regras podem selecionar uma propriedade pelo nome em todas as tags ou apenas em tags específicas. Prefira a seleção restrita quando tags diferentes usarem o mesmo atributo para finalidades distintas. Atributos numéricos, booleanos, derivados de variáveis e outros que não contenham valores de texto não são unidades de texto literal.
O que permanece protegido #
Blocos de código delimitados e código em linha ficam fora da tradução. Os links mantêm seus destinos, mas seus rótulos podem mudar. Anotações em linha e imagens são estruturas protegidas em meio ao texto. Os nomes das tags e os atributos não selecionados permanecem no documento. O processador aplica os escapes necessários aos atributos de texto traduzidos para respeitar as regras de aspas do Markdoc, mas isso não fornece o esquema de tags personalizadas do renderizador.
Os campos title e description do frontmatter são selecionados por padrão. Uma seleção vazia de frontmatter mantém esses campos inalterados. Ao selecionar um mapa ou uma sequência, seus descendentes escalares também são incluídos. Escolha caminhos precisos, como seo.title, quando campos de roteamento ou IDs de conteúdo próximos precisarem permanecer fixos.
Preserve o alinhamento entre origem e destino #
A reconstrução substitui trechos de texto na origem atual e pode reaproveitar o texto de uma versão anterior da origem e de sua tradução alinhada. Se as estruturas protegidas em linha dessas versões não corresponderem de forma segura, o reaproveitamento poderá falhar. Guarde a revisão da origem que acompanhou a tradução aceita, especialmente após mover tags ou alterar links.
Não presuma que um documento .md com anotações do Markdoc fará com que este processador seja selecionado. A CLI infere Markdown para .md; selecione o formato explicitamente quando a linguagem do documento exigir o comportamento do Markdoc.
Configure a tradução do Markdoc #
A CLI infere markdoc a partir de .mdoc; o escopo por chave não está disponível. Use a configuração da CLI para definir o frontmatter, a seleção de propriedades de tags e o layout de destino, ou o GitHub para o workflow do repositório.
Valide com o esquema do site #
O processador de arquivos não configura as rotas do framework, o carregamento de conteúdo nem as transformações do Markdoc na sua aplicação. Após obter o conteúdo traduzido, faça a análise sintática e renderize o documento de destino com os mesmos esquemas usados na origem. Confira os atributos visíveis, os destinos dos links, as variáveis e os campos selecionados do frontmatter junto com os parágrafos traduzidos.