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 combinar el texto de un artículo con componentes interactivos. El procesador de archivos mdx traduce el texto y el contenido de los componentes que admite, conservando su marcado. Selecciona expresamente las propiedades literales de los componentes que 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 informativo 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 contenido en el componente son traducibles. kind es un dato del componente que debe mantenerse sin cambios. title solo se traduce si 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 entre sí.
Se admiten propiedades cuyo valor es una cadena literal. 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 de cabecera y anclas de encabezados #
El procesador de archivos selecciona title y description en los metadatos de cabecera de forma predeterminada. Indica 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 adyacentes deban mantenerse sin cambios. Consulta Configuración de la CLI para obtener información sobre translateFrontmatterFields y translateComponentProps.
Las anclas de los encabezados de Docusaurus, como {#delivery}, se conservan aunque cambie el texto del encabezado. El tratamiento de las anclas reconoce la sintaxis de las líneas de encabezado fuera de los bloques de código delimitados y no modifica los segmentos de las URL. Comprueba el ID del encabezado renderizado y los enlaces entrantes en tu sitio.
Actualizaciones y alineación #
La redacción existente se puede reutilizar cuando la versión anterior del original y su traducción presentan unidades de texto y estructuras en línea protegidas que se corresponden. Si esa correspondencia es ambigua, el procesador puede rechazar la reutilización. Mantén las traducciones aceptadas vinculadas a la revisión del original que les corresponde, en lugar de proporcionar sin avisar un documento con una estructura distinta.
Revisa las propiedades seleccionadas tras la reconstrucción, incluidas las etiquetas visibles que quedan fuera del texto contenido en el componente, 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; este formato no permite delimitar el ámbito por claves. Consulta Configuración de la CLI o GitHub para ver las opciones de los archivos.
Comprueba el componente renderizado #
Compila el MDX obtenido con el procesador que usas en tu aplicación y revisa conjuntamente 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 busca llamadas compatibles en el código fuente de la aplicación y genera catálogos. Elige el flujo de trabajo que se ajuste al lugar donde se redacta el mensaje.