Conceptos básicos

18ways tiene opiniones claras sobre algunas cosas. Una vez que estas estén claras, el resto de la superficie de la API es sencilla.

Configuración regional base

Tu baseLocale es el idioma en el que escribes.

Si la copia de tu producto está escrita en inglés británico, tu configuración regional base es en-GB. Si está escrita en inglés americano, tu configuración regional base es en-US.

Cuando la configuración regional actual coincide con la configuración regional base, 18ways devuelve el texto fuente de inmediato y omite el trabajo de traducción.

Idioma de destino

Tu localidad objetivo es el idioma que el usuario está leyendo actualmente.

En Next.js, el adaptador puede resolverlo desde middleware, cookies, la ruta y preferencias del navegador.

Contextos

Los contextos son cómo los grupos de 18ways relacionan el contenido.

Úsalos para mantener las solicitudes de traducción pequeñas y evitar mezclar texto no relacionado.

'use client';
 
import { Ways } from '@18ways/react';
 
export function MarketingPage() {
  return (
    <Ways context="marketing">
      <Ways context="hero">
        <Hero />
      </Ways>
      <Ways context="pricing">
        <Pricing />
      </Ways>
    </Ways>
  );
}

Los ámbitos anidados Ways se componen en una única ruta de contexto. marketing más hero se convierte en marketing.hero.

Locales aceptados

18ways distingue entre:

• un locale que puede reconocer, como fr-FR
• un idioma que tu proyecto realmente acepta

El tiempo de ejecución puede obtener la lista de locales aceptados de la API, y luego normalizar los valores de locales entrantes en función de esa lista.

Por eso @18ways/next puede hacer cosas sensatas como redirigir /en-US/docs a /en-GB/docs cuando solo está habilitado en-GB.

import { init as initWays } from '@18ways/next/server';
 
const ways = initWays({
  apiKey: 'YOUR_18WAYS_PUBLIC_API_KEY',
  baseLocale: 'en-GB',
  acceptedLocales: [
    'en-GB',
    'fr-FR',
    'de-DE',
  ],
  pathRouting: {
    exclude: ['/dashboard', '/__design', '/__email'],
  },
});

Persistencia

La cookie de preferencia de localización utilizada por el tiempo de ejecución es 18ways_locale.

Cuando se cargan las traducciones

@18ways/next puede resolver el locale en el servidor, sembrar traducciones de contexto y emitir metadatos traducidos.

Modelo mental compartido

Mantén el modelo simple:

1. Elige el paquete correcto para tu aplicación.
2. Configura correctamente la configuración regional base.
3. Mantén las claves de contexto estables y significativas.
4. Deja que el tiempo de ejecución traduzca frases completas, no fragmentos.

Siguiente: Formato de Mensaje