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 tu copia de producto está escrita en inglés británico, tu configuración regional base es es-GB. Si está escrita en inglés americano, tu configuración regional base es es-US.

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

Idioma de destino

Tu configuración regional objetivo es el idioma que el usuario está leyendo actualmente.

En Next.js, el adaptador puede resolverlo a partir de 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.

'usar cliente';
 
importar { Maneras } de '@18ways/react';
 
exportar función MarketingPage() {
  retornar (
    <Maneras contexto="marketing">
      <Maneras contexto="hero">
        <Hero />
      </Ways>
      <Ways context="pricing">
        <Pricing />
      </Ways>
    </Ways>
  );
}

Anidado Formas los ámbitos se componen en una única ruta de contexto. marketing más héroe se convierte en marketing.héroe.}

Locales aceptados

18ways distingue entre:

• un idioma 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 en-GB está habilitado.

import { init como initWays } de '@18ways/next/server';
 
const ways = initWays({
  apiKey: 'TU_CLAVE_API_PUBLICA_18WAYS',
  baseLocale: 'es-ES',
  acceptedLocales: [
    'es-ES',
    'fr-FR',
    'de-DE',
  ],
  pathRouting: {
    exclude: ['/dashboard'],
  },
});

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 la configuración regional 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. Establece 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 del Mensaje