Configuración de importación de archivos

.MD / .MDX - Markdown y MDX (TMS)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Tipos de archivo

  • .MD

  • .MARKDOWN

  • .MDX

Opciones de importación

  • Filtrar 

    Elige qué dialecto de Markdown utiliza el analizador al importar el archivo. Esto también afecta a los caracteres que se escapan o desescapan automáticamente al importar y exportar.

    • Sin formato

      Analiza solo la estructura base de Markdown (encabezados, párrafos, listas, énfasis básico).

    • PHP/Python Markdown Extra

      Analiza utilizando el dialecto "Extra" de PHP Markdown / Python-Markdown, añadiendo compatibilidad con tablas, listas de definiciones, notas al pie, abreviaturas y listas de atributos.

    • GitHub Flavored Markdown

      Analiza utilizando la especificación de GitHub Flavored Markdown (GFM), añadiendo compatibilidad con tablas, listas de tareas, tachado y enlaces automáticos.

    • MDX

      Analiza el archivo como MDX: Markdown más componentes JSX, expresiones JSX ({...}) y declaraciones import/export de ESM. Las tablas, las listas de tareas, el tachado y los enlaces automáticos funcionan igual que en GitHub Flavored Markdown. Los bloques de código sangrados y los enlaces automáticos entre signos de menor y mayor (<url>) no son compatibles, ya que MDX utiliza la sangría para anidar componentes y no analiza esas estructuras.

      MDX es Markdown extendido con JSX, por lo que el contenido puede incorporar componentes y expresiones de JavaScript (por ejemplo, en documentación creada con Docusaurus o Next.js). El filtro MDX nunca se selecciona automáticamente: debe seleccionarse en la configuración de importación de archivos, tanto para archivos .MDX como para archivos .MD que contengan sintaxis MDX. No existe detección por extensión de archivo ni por contenido.

      Nota

      La compatibilidad con MDX debe estar habilitada para tu organización. Si MDX no está disponible en la lista Filtro, ponte en contacto con tu gestor de éxito del cliente o con el servicio de asistencia de Phrase.

      Importante

      Cambiar un proyecto existente de otro filtro de Markdown a MDX modifica la forma en que se segmenta el contenido. Ten en cuenta que, tras el cambio, se producirá una disminución puntual del aprovechamiento de la memoria de traducción.

  • Un salto de línea crea un nuevo segmento 

    Inicia un nuevo segmento en cada salto de línea forzado.

  • Dejar espacios en blanco 

    Conserva la misma estructura de espacios en blanco en el documento de destino (por ejemplo, espaciado, saltos de línea, etc.).

  • Procesar encabezado YAML 

    Procesa el front matter YAML en la parte superior del archivo. Cuando se selecciona, se aplican los ajustes de importación de .YAML.

  • Importar bloques de código 

    Extrae el contenido de los bloques de código para su traducción. Con el filtro MDX, esto también se aplica a los bloques de código delimitados anidados dentro de componentes JSX (por ejemplo, dentro de <CodeGroup>).

  • Excluir elementos de código 

    Al seleccionar esta opción, los elementos de código se importarán como etiquetas de Phrase TMS individuales.

  • Hacer que las URL sean traducibles

    Hace que las URL estén disponibles para su traducción.

  • Convertir en etiquetas de Phrase TMS 

    Aplica expresiones regulares para convertir el texto especificado en etiquetas.

    Importante

    Los problemas con las etiquetas son una causa común de errores de exportación. Comprueba siempre que las etiquetas y el formato sean correctos antes de exportar archivos. Esto se puede hacer realizando comprobaciones de control de calidad.

  • Elementos personalizados (convertidos a etiquetas de Phrase) 

    Defina los elementos del archivo que se convertirán en etiquetas.

  • Bloques no traducibles 

    Defina las secciones del archivo que no deben importarse.

    Ejemplo:

    Nombre del elemento: notrans.

    Código: <notrans>Chrysler</notrans> entered three factory-prepared <notrans>Dodge Shadows</notrans> to the event in 1985. All three vehicles retired in the first day of the three-day <notrans>Olympus</notrans> rally.

    Resultado: Chrysler は、1985年に工場で準備された3台の Dodge Shadows に参加しました。3台の車両はすべて3日間の Olympus ラリーの初日にリタイアしました。

  • No evitar caracteres 

    Una lista de caracteres que no deben escaparse en el archivo completado (por ejemplo, #, -, [, <,\,`, ![,](,:).

    Con el filtro MDX, tanto < como { se escapan de forma predeterminada en el texto traducido, porque un < o { sin escapar en el destino rompería la sintaxis MDX. Añádelos aquí solo si necesitas que el carácter aparezca tal cual, sin escapar, en el archivo de salida.

Opciones específicas de MDX

Las siguientes cuatro opciones solo están disponibles cuando se selecciona MDX en Filtro.

  • Atributos traducibles

    Define pares adicionales de etiqueta/atributo JSX para hacerlos traducibles, utilizando el mismo formato etiqueta/atributo que la configuración Atributos traducibles del filtro HTML. Por ejemplo, Figure/title permite traducir el atributo title solo en el componente Figure, mientras que title (sin restringir a un componente) permite traducirlo en todas las etiquetas.

    Los componentes personalizados (nombres de etiquetas que comienzan con una letra mayúscula, como <Figure>) no tienen atributos traducibles por defecto, así que enuméralos aquí explícitamente. Las etiquetas en minúsculas/estilo HTML (<img>, <a>, etc.) ya tienen valores predeterminados de atributos estándar.

  • Importar atributos traducibles predeterminados

    Activada por defecto.

    Aplica los valores predeterminados de atributos traducibles de HTML estándar (por ejemplo, alt en <img>, title en <a>) a las etiquetas en minúsculas/estilo HTML, además de cualquier elemento enumerado en Atributos traducibles. Los componentes personalizados nunca reciben estos valores predeterminados, independientemente de esta configuración. Sus atributos solo se pueden traducir cuando se añaden a Atributos traducibles.

    Cuando está desactivada, solo los atributos enumerados en Atributos traducibles son traducibles, incluso en etiquetas en minúsculas.

  • Hacer que los elementos sean traducibles por defecto

    Activada por defecto.

    Define si el texto dentro de un componente JSX es traducible por defecto.

    • Cuando está habilitada: El texto dentro de cualquier componente (por ejemplo, <Tabs>, <Note>) es traducible, a menos que el componente aparezca en Elementos que anulan la traducibilidad por defecto.

    • Cuando está desactivada: El texto dentro de los componentes no es traducible, a menos que el componente aparezca en Elementos que anulan la traducibilidad por defecto.

  • Elementos que anulan la traducibilidad predeterminada

    Una lista de nombres de componentes, separados por comas, a los que se aplica lo contrario a lo establecido en Hacer que los elementos sean traducibles por defecto.

    La traducibilidad de un componente incluido aquí se invierte en su totalidad: todo su contenido, incluidos los componentes anidados en él, queda sujeto a esta excepción y no se evalúa individualmente. Cuando la anulación hace que un componente no sea traducible, su contenido se conserva exactamente como está escrito. Usa esta lista para:

    • excluir algunos componentes sin contenido en prosa (por ejemplo, CodeGroup, Mermaid) cuando Hacer que los elementos sean traducibles por defecto está activado, o

    • incluir en la lista de permitidos algunos componentes con contenido en prosa cuando esa configuración está desactivada.

Cómo se maneja el contenido JSX

Esto se aplica cuando se selecciona MDX en Filtro.

  • Las etiquetas JSX (<Component>, <Component attr="value" />) y los nombres de etiquetas y atributos nunca son traducibles. Solo el contenido de los elementos y los valores de atributo configurados explícitamente son traducibles.

  • Las expresiones entre llaves ({...}), las expresiones de JavaScript, los atributos de propagación ({...props}) y los comentarios ({/* comment */}) nunca son traducibles. Se conservan exactamente como están escritos, dondequiera que aparezcan: en atributos, integrados en el texto o en una línea independiente.

  • Las declaraciones import y export siempre se excluyen de la traducción, dondequiera que aparezcan en el archivo.

¿Fue útil este artículo?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.