Markdown

Traduce el texto del documento y los metadatos iniciales seleccionados sin alterar el código, los enlaces ni la estructura necesaria para reutilizar las traducciones aceptadas.

Un documento Markdown combina texto explicativo con una estructura que facilita la lectura. El controlador de archivos md traduce el texto de encabezados, párrafos, celdas de tablas y etiquetas de directivas compatibles, sin alterar el código ni los destinos de los enlaces. El resultado conserva el formato Markdown para que puedas usarlo con tu motor de renderizado actual.

Texto y estructura protegida #

Por ejemplo, el texto del enlace puede cambiar sin que se modifiquen su destino ni el nombre de la función:

markdown
---
title: Delivery options
description: Choose how your order arrives.
slug: delivery
---

## Choose delivery

Read the [delivery policy](/policies/delivery) before calling `confirmOrder()`.

El encabezado, el texto del párrafo y el texto del enlace son contenido textual. El destino del enlace y el código en línea son estructura protegida. En el perfil de documento normal, los bloques de código delimitados y el HTML sin procesar quedan fuera de la extracción de texto. Usa HTML cuando el documento de origen esté en HTML, o Markdoc cuando las etiquetas personalizadas de Markdoc formen parte del lenguaje del documento.

Selección de metadatos iniciales #

De forma predeterminada, el controlador de archivos selecciona title y description. Los demás campos no se modifican a menos que se seleccionen explícitamente. Una lista translateFrontmatterFields vacía desactiva la traducción de los metadatos iniciales. La elección de campos es una decisión de contenido: un título pensado para leerse se puede traducir, mientras que un slug, un identificador de componente o una clave de enrutamiento podrían tener que mantenerse sin cambios.

Las rutas de campos compatibles permiten acceder a valores anidados, incluidos los elementos de secuencias. Al seleccionar un mapa o una secuencia, se incluyen sus valores escalares descendientes. Elige una ruta precisa, como seo.title, cuando los campos de enrutamiento adyacentes deban mantenerse sin cambios. Usa las opciones de metadatos iniciales de la interfaz seleccionada para elegir el texto.

Para reutilizar traducciones, los documentos deben estar alineados #

El controlador coteja las unidades de texto con el documento de origen anterior y su traducción correspondiente, y luego inserta las traducciones modificadas en la estructura del documento de origen actual. Las traducciones existentes solo se pueden reutilizar cuando la correspondencia es clara. Si el documento de origen anterior y su traducción contienen estructuras protegidas en línea diferentes, la reutilización puede fallar por una incompatibilidad estructural.

Conserva la revisión del documento de origen asociada con las traducciones aceptadas. Si el documento traducido se reorganizó de forma independiente, ajusta su estructura para que coincida con la de ese documento de origen antes de solicitar una actualización incremental. Genera el resultado con el procesador Markdown de tu sitio para verificar las construcciones específicas de cada variante.

Configura y renderiza el documento #

La CLI infiere md a partir de .md. Configura la selección de archivos, los campos de metadatos iniciales y las rutas de salida en Configuración de la CLI, o usa GitHub para la traducción gestionada de repositorios. La selección por claves de la CLI no está disponible para Markdown.

Renderiza la salida con el procesador Markdown de tu sitio. Revisa en conjunto los metadatos traducidos, los enlaces, los fragmentos de encabezados y los ejemplos de código. Conservar /policies/delivery no crea esa página en otro idioma. La guía de contenido estático vincula las rutas de salida con el cargador del sitio y las rutas de idioma.