Markdoc

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

Las anotaciones de Markdoc vinculan el texto del documento con componentes personalizados y variables. El procesador de archivos markdoc traduce el texto compatible y los atributos de etiquetas seleccionados que contienen cadenas de texto, y conserva 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 una nota destacada:

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 iniciales, seleccionados de forma predeterminada, son texto. El atributo title de la etiqueta se convierte en contenido para traducir cuando una regla de propiedades lo selecciona. type="warning" y layout: article son identificadores estructurales; déjalos sin seleccionar, a menos que el componente que los utiliza espere explícitamente valores traducidos.

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

Qué se mantiene protegido #

El código en bloques delimitados y en línea queda fuera de la traducción. Los enlaces conservan sus destinos, aunque su texto puede cambiar. Las anotaciones en línea y las imágenes son elementos protegidos dentro del texto que las rodea. Los nombres de las etiquetas y los atributos no seleccionados permanecen en el documento. El procesador aplica secuencias de escape a los atributos de texto traducidos para respetar las reglas de uso de comillas de Markdoc, pero no proporciona el esquema de etiquetas personalizadas de tu renderizador.

Los campos title y description de los metadatos iniciales se seleccionan de forma predeterminada. Si la selección de metadatos iniciales está vacía, estos campos no se modifican. 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 cercanos deban permanecer sin cambios.

Mantén la alineación entre el origen y el destino #

La reconstrucción reemplaza fragmentos de texto en el documento de origen actual y puede reutilizar la redacción de una versión anterior del origen 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 origen que acompañaba a la traducción aceptada, especialmente después de mover etiquetas o cambiar enlaces.

No des por hecho que se usará este procesador para un documento .md con anotaciones de Markdoc. La CLI infiere Markdown para .md; selecciona el formato de manera 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 limitar el alcance por clave. Usa la configuración de la CLI para los metadatos iniciales, la selección de propiedades de etiquetas y la estructura de destino, o GitHub para el flujo de trabajo del repositorio.

Valida con el esquema del sitio #

El procesador de archivos no configura las rutas del entorno de desarrollo, la carga de contenido ni las transformaciones de Markdoc de tu aplicación. Después de recuperar el documento de destino, analízalo y renderízalo con los mismos esquemas que el documento de origen. Revisa los atributos visibles, los destinos de los enlaces, las variables y los metadatos iniciales seleccionados junto con los párrafos traducidos.