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.

Utiliza 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="TU_CLAVE_API_PÚBLICA_DE_18WAYS"
      locale="es-ES"
      baseLocale="es-ES"
      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 cubos anónimos como pagina1, copia, o varios.}

Traduce pensamientos completos

Bien:

import { T } from '@18ways/react';
 
export function InvoiceLink() {
  return (
    <T>
      Descargue su última factura como{' '}
      <a href="/invoices/latest.pdf">PDF</a>
    </T>
  );
}

Evitar:

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

import { T } from '@18ways/react';
 
export function InvoiceLink() {
  return (
    <>
      <T>Descargar</T>{' '}
      <T>tu última factura</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 localización en tu aplicación y utiliza @18ways/react.
• Si estás fuera de React, utiliza @18ways/core y gestiona tú mismo la integración de la interfaz de usuario.

Deja que el enrutamiento coincida con tu producto

Las páginas de marketing públicas suelen querer enrutamiento de locales basado en la ruta para SEO. Los paneles internos a menudo no lo hacen. Por eso, el sitio actual excluye /dashboard del enrutamiento de rutas.

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 origen proporciona al modelo un mejor contexto y le da a su equipo algo legible en el código.