Tipos de archivo
-
.MD
-
.MARKDOWN
-
.MDX
Opciones de importación
-
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.
-
Analiza solo la estructura base de Markdown (encabezados, párrafos, listas, énfasis básico).
-
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.
-
Analiza utilizando la especificación de GitHub Flavored Markdown (GFM), añadiendo compatibilidad con tablas, listas de tareas, tachado y enlaces automáticos.
-
Analiza el archivo como MDX: Markdown más componentes JSX, expresiones JSX (
{...}) y declaracionesimport/exportde 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 , 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.
-
-
Inicia un nuevo segmento en cada salto de línea forzado.
-
Conserva la misma estructura de espacios en blanco en el documento de destino (por ejemplo, espaciado, saltos de línea, etc.).
-
Procesa el front matter YAML en la parte superior del archivo. Cuando se selecciona, se aplican los ajustes de importación de .YAML.
-
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>). -
Al seleccionar esta opción, los elementos de código se importarán como etiquetas de Phrase TMS individuales.
-
Hace que las URL estén disponibles para su traducción.
-
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.
-
Defina los elementos del archivo que se convertirán en etiquetas.
-
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 ラリーの初日にリタイアしました。
-
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 .
-
Define pares adicionales de etiqueta/atributo JSX para hacerlos traducibles, utilizando el mismo formato
etiqueta/atributoque la configuración del filtro HTML. Por ejemplo,Figure/titlepermite traducir el atributotitlesolo en el componenteFigure, mientras quetitle(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. -
Activada por defecto.
Aplica los valores predeterminados de atributos traducibles de HTML estándar (por ejemplo,
alten<img>,titleen<a>) a las etiquetas en minúsculas/estilo HTML, además de cualquier elemento enumerado en . Los componentes personalizados nunca reciben estos valores predeterminados, independientemente de esta configuración. Sus atributos solo se pueden traducir cuando se añaden a .Cuando está desactivada, solo los atributos enumerados en son traducibles, incluso en etiquetas en minúsculas.
-
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 . -
Cuando está desactivada: El texto dentro de los componentes no es traducible, a menos que el componente aparezca en .
-
-
Una lista de nombres de componentes, separados por comas, a los que se aplica lo contrario a lo establecido en .
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 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 .
-
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
importyexportsiempre se excluyen de la traducción, dondequiera que aparezcan en el archivo.