MDX
Traduce el texto de MDX y las propiedades literales seleccionadas de los componentes sin alterar las expresiones, las importaciones ni la estructura de los componentes.
MDX permite incluir componentes interactivos junto con el texto de un artículo. El procesador de archivos mdx traduce el texto compatible y los elementos secundarios de los componentes, conservando su marcado. Selecciona explícitamente las propiedades literales de los componentes cuando también contengan texto visible para los lectores; las importaciones y las expresiones no se ejecutan para detectar texto.
Separa el texto de los datos de los componentes #
Por ejemplo, un recuadro destacado tiene un título visible y una propiedad que controla su comportamiento:
import Callout from "./Callout";
## Delivery options {#delivery}
<Callout title="Delivery deadline" kind="warning">
Confirm your address before checkout.
</Callout>El encabezado y el texto de los elementos secundarios se traducen. kind es un dato del componente que debe permanecer sin cambios. title solo se traduce cuando una regla de propiedades de componentes lo selecciona. Una regla limitada a Callout y title es más segura que traducir todos los atributos con ese nombre en componentes no relacionados.
Se admiten propiedades cuyos valores son cadenas literales. Una propiedad calculada mediante una expresión no equivale a un mensaje literal. Las importaciones, las expresiones de JavaScript y los bloques de código quedan fuera de la extracción habitual de texto. La estructura de los componentes debe seguir siendo compatible con el renderizador de la aplicación.
Metadatos iniciales y anclas de encabezados #
El procesador de archivos selecciona title y description de los metadatos iniciales de forma predeterminada. Usa una selección vacía para dejar esos metadatos sin traducir. Al seleccionar un mapa o una secuencia, se incluyen sus descendientes escalares, así que elige rutas precisas, como seo.title, cuando los campos de enrutamiento cercanos deban permanecer sin cambios. Consulta Configuración de la CLI para obtener información sobre translateFrontmatterFields y translateComponentProps.
Las anclas de encabezados de Docusaurus, como {#delivery}, se mantienen protegidas mientras cambia el texto del encabezado. El manejo de anclas reconoce la sintaxis de las líneas de encabezado fuera de los bloques de código delimitados y conserva los segmentos de las URL sin cambios. Verifica el ID del encabezado renderizado y los enlaces entrantes en tu sitio.
Actualizaciones y alineación #
La redacción existente se puede reutilizar cuando el texto de origen y la traducción anteriores tienen unidades de texto correspondientes y una estructura protegida dentro del texto. Si esa correspondencia es ambigua, el procesador puede rechazar la reutilización. Mantén las traducciones aceptadas vinculadas a la revisión de origen correspondiente, en lugar de proporcionar sin advertencia un documento con una estructura no relacionada.
Revisa las propiedades seleccionadas después de reconstruir el documento, incluidas las etiquetas visibles fuera del texto de los elementos secundarios, y compila el resultado con el procesador MDX de tu aplicación.
Configura la traducción de MDX #
La CLI infiere mdx a partir de .mdx; el alcance por clave no está disponible para este formato. Consulta Configuración de la CLI o GitHub para conocer las opciones de archivo.
Revisa el componente renderizado #
Compila el MDX obtenido con el procesador que realmente usa tu aplicación y revisa en conjunto las propiedades de los componentes, las anclas, las variables y los ejemplos de código. La traducción de archivos MDX conserva un documento que contiene JSX; en cambio, la extracción de mensajes de React encuentra llamadas compatibles en el código fuente de la aplicación y genera catálogos. Elige el flujo de trabajo que corresponda al lugar donde se escribe el mensaje.