Markdown

Traduce el texto del documento y los metadatos de cabecera 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 procesador de archivos md traduce el texto de los encabezados, los párrafos, las celdas de tablas y las etiquetas de directivas compatibles, sin alterar el código ni los destinos de los enlaces. El resultado sigue siendo Markdown y puedes usarlo con tu motor de renderizado habitual.

Texto y estructura protegida #

Por ejemplo, el texto de un 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 forman parte de la estructura protegida. En el perfil de documento estándar, 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 sea HTML, o Markdoc cuando las etiquetas personalizadas de Markdoc formen parte del lenguaje del documento.

Selección de metadatos de cabecera #

Por defecto, el procesador de archivos selecciona title y description. Los demás campos no se modifican salvo que los selecciones expresamente. Una lista translateFrontmatterFields vacía desactiva la traducción de los metadatos de cabecera. La elección de los campos depende del contenido: un título destinado a la lectura puede traducirse, mientras que un segmento de URL, un identificador de componente o una clave de enrutamiento pueden tener que conservarse sin cambios.

Las rutas de campo compatibles permiten acceder a valores anidados, incluidos los elementos de una secuencia. 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 de cabecera de la interfaz seleccionada para elegir el texto.

La reutilización requiere documentos alineados #

El procesador coteja las unidades de texto con el documento de origen anterior y su traducción correspondiente, y después inserta las traducciones modificadas en la estructura del documento de origen actual. Las traducciones existentes solo pueden reutilizarse cuando la correspondencia está 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 discrepancia estructural.

Conserva la revisión del documento de origen asociada a la traducción aceptada. Si la traducción se ha reorganizado de forma independiente, ajusta su estructura a la de ese documento de origen antes de solicitar una actualización incremental. Genera el resultado con el procesador Markdown de tu sitio para comprobar las construcciones propias del dialecto utilizado.

Configura y renderiza el documento #

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

Renderiza el resultado con el procesador Markdown de tu sitio. Revisa en conjunto los metadatos traducidos, los enlaces, los fragmentos de los 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 explica la relación entre las rutas de salida, el cargador del sitio y las rutas de idioma.