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:

import { Ways } from '@18ways/react';
 
export function AppRoot() {
  return (
    <Ways
      apiKey="YOUR_18WAYS_PUBLIC_API_KEY"
      locale="en-GB"
      baseLocale="en-GB"
      context="app"
    >
      <Ways context="checkout.payment-form">
        <PaymentForm />
      </Ways>
      <Ways context="dashboard.billing-history">
        <BillingHistory />
      </Ways>
      <Ways context="marketing.pricing-hero">
        <PricingHero />
      </Ways>
    </Ways>
  );
}

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

Traduce pensamientos completos

Bien:

import { T } from '@18ways/react';
 
export function InvoiceLink() {
  return (
    <T>
      Download your latest invoice as{' '}
      <a href="/invoices/latest.pdf">PDF</a>
    </T>
  );
}

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.

import { T } from '@18ways/react';
 
export function InvoiceLink() {
  return (
    <>
      <T>Download</T>{' '}
      <T>your latest invoice</T>{' '}
      <T>as PDF</T>
    </>
  );
}

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.