MD & MDX

Usa @better-translate/md cuando tus documentos, publicaciones de blog o páginas de contenido residan en archivos .md o .mdx localizados.

Este paquete no reemplaza el traductor principal. Lee las reglas de configuración regional del traductor que ya creaste.

1. Instala los paquetes

npm install @better-translate/core @better-translate/md

2. Crea el traductor

Crea src/i18n.ts:

1import { configureTranslations } from "@better-translate/core";23const en = {4  docs: {5    title: "Docs",6  },7} as const;89const es = {10  docs: {11    title: "Documentacion",12  },13} as const;1415export const translator = await configureTranslations({16  availableLocales: ["en", "es"] as const,17  defaultLocale: "en",18  fallbackLocale: "en",19  messages: { en, es },20});

3. Crea las carpetas de contenido

Coloca una carpeta por configuración regional bajo la misma raíz:

txt

1content/docs/2  en/3    getting-started.mdx4  es/5    getting-started.mdx

4. Crea los ayudantes de markdown

Crea src/docs.ts:

1import { createMarkdownHelpers } from "@better-translate/md";23import { translator } from "./i18n";45export const docs = createMarkdownHelpers(translator, {6  rootDir: "./content/docs",7});

5. Lee un documento

1import { docs } from "./docs";23const englishDoc = await docs.getDocument("getting-started", {4  locale: "en",5});67const spanishDoc = await docs.getDocument("getting-started", {8  locale: "es",9});

6. Compílalo cuando necesites el resultado

1const compiled = await docs.compileDocument("getting-started", {2  locale: "en",3});45compiled.kind; // "md" o "mdx"6compiled.path;7compiled.usedFallback;

Cuándo usar los ayudantes del servidor

Si tu aplicación ya resuelve la configuración regional de la solicitud en el servidor, usa @better-translate/md/server para que la carga de markdown siga automáticamente la misma configuración regional de la solicitud.

Genera markdown localizado automáticamente

Usa la opción markdown.rootDir del CLI para que el generador traduzca tus archivos markdown: Guía del CLI

Ejemplos

md-nextjs-example

2. Crea el traductor

Crea src/i18n.ts:

1import { configureTranslations } from "@better-translate/core";23const en = {4  docs: {5    title: "Docs",6  },7} as const;89const es = {10  docs: {11    title: "Documentacion",12  },13} as const;1415export const translator = await configureTranslations({16  availableLocales: ["en", "es"] as const,17  defaultLocale: "en",18  fallbackLocale: "en",19  messages: { en, es },20});