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:
---
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.