Mejores prácticas

La forma más rápida de obtener malas traducciones es hacer que el tiempo de ejecución trabaje alrededor de problemas de estructura de la aplicación que se pueden evitar.

Usa nombres de contexto reales

Las buenas claves de contexto explican dónde se encuentra el texto:

await engine.t('Pay now', {
  context: 'checkout.payment-form',
});
 
await engine.t('Billing history', {
  context: 'dashboard.billing-history',
});
 
await engine.t('Simple pricing', {
  context: 'marketing.pricing-hero',
});

Evita los buckets anónimos como page1, copy o misc.

Traduce pensamientos completos

Bien:

const label = await engine.t(
  'Download your latest invoice as PDF'
);

Evitar:

18ways puede manejar el caso de enlace común como un solo mensaje. <T><a href="#">Haz clic aquí</a> para ver más</T> debe permanecer como una sola oración en lugar de ser dividida y unida nuevamente.

const first = await engine.t('Download');
const second = await engine.t(
  'your latest invoice'
);
const third = await engine.t('as PDF');
 
const stitched = [first, second, third].join(' ');

Mantén el límite del paquete claro

• Si estás en Next.js, utiliza @18ways/next para la resolución de locales y metadatos.
• Si solo estás en React, mantén el estado de la localidad en tu aplicación y usa @18ways/react.
• Si estás fuera de React, utiliza @18ways/core y hazte cargo de la integración de la interfaz de usuario tú mismo.

Deja que el enrutamiento coincida con tu producto

Las páginas de marketing público generalmente desean enrutamiento de locales basado en la ruta para SEO. Los paneles internos y las rutas de herramientas internas a menudo no lo hacen. Por eso, el sitio actual excluye /dashboard, /__design y /__email del enrutamiento por ruta.

Mantén la copia fuente humana

18ways funciona mejor cuando el texto fuente se lee como una copia de producto real, no como una clave de traducción comprimida.

Una buena copia de fuente proporciona al modelo un mejor contexto y le da a tu equipo algo legible en el código.