Markdoc

Traduce el texto de Markdoc y los atributos de cadena seleccionados sin alterar las anotaciones, las variables ni el código.

Las anotaciones de Markdoc vinculan el texto del documento con componentes y variables personalizados. El gestor de archivos markdoc traduce el texto compatible y los atributos de etiquetas seleccionados que contienen cadenas, conservando las anotaciones que necesita tu renderizador.

Selecciona las propiedades visibles de las etiquetas #

Un documento puede combinar metadatos visibles, un identificador de diseño fijo y un bloque destacado:

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

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

El párrafo y los campos title y description de los metadatos de cabecera, seleccionados por defecto, son texto. El atributo title de la etiqueta se incluye en la traducción cuando lo selecciona una regla de propiedades. type="warning" y layout: article son identificadores estructurales; déjalos sin seleccionar, salvo que el componente que los utiliza espere expresamente valores traducidos.

Las reglas pueden aplicar un nombre de propiedad a todas las etiquetas o limitarlo a etiquetas específicas. Opta por esta segunda opción cuando distintas etiquetas utilicen el mismo atributo para fines diferentes. Los atributos numéricos, booleanos, derivados de variables y otros atributos que no sean cadenas no se consideran unidades de texto literal.

Qué se mantiene protegido #

El código en bloques delimitados y el código en línea quedan fuera de la traducción. Los enlaces conservan sus destinos, aunque sus textos pueden cambiar. Las anotaciones en línea y las imágenes son estructuras protegidas dentro del texto que las rodea. Los nombres de las etiquetas y los atributos no seleccionados permanecen en el documento. El gestor aplica secuencias de escape a los atributos de cadena traducidos para respetar las comillas de Markdoc, pero esto no proporciona el esquema de etiquetas personalizadas de tu renderizador.

Los campos title y description de los metadatos de cabecera se seleccionan por defecto. Si la selección de metadatos de cabecera está vacía, estos campos no cambian. Al seleccionar un mapa o una secuencia, se incluyen sus descendientes escalares. Elige rutas precisas, como seo.title, cuando los campos de enrutamiento o los identificadores de contenido adyacentes deban permanecer sin cambios.

Mantén la alineación entre el original y la traducción #

La reconstrucción sustituye segmentos de texto en el original actual y puede reutilizar la redacción de un original anterior y su traducción alineada. Si sus estructuras protegidas en línea no se corresponden de forma segura, la reutilización puede fallar. Conserva la revisión del original que acompañaba a la traducción aceptada, sobre todo después de mover etiquetas o cambiar enlaces.

No des por hecho que se seleccionará este gestor para un documento .md que contenga anotaciones de Markdoc. La CLI infiere Markdown para .md; selecciona el formato de forma explícita cuando el lenguaje del documento requiera el comportamiento de Markdoc.

Configura la traducción de Markdoc #

La CLI infiere markdoc a partir de .mdoc; no se puede delimitar el alcance por claves. Utiliza la configuración de la CLI para los metadatos de cabecera, la selección de propiedades de las etiquetas y la estructura de destino, o GitHub para el flujo de trabajo del repositorio.

Valida con el esquema del sitio #

El gestor de archivos no configura las rutas del marco de trabajo, la carga de contenido ni las transformaciones de Markdoc de tu aplicación. Tras recuperar la traducción, analízala y renderízala con los mismos esquemas que el original. Revisa los atributos visibles, los destinos de los enlaces, las variables y los metadatos de cabecera seleccionados junto con los párrafos traducidos.