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:

'use client';
 
import { Ways } from '@18ways/react';
 
export function AppPage() {
  return (
    <>
      <Ways context="checkout.payment-form">
        <PaymentForm />
      </Ways>
      <Ways context="dashboard.billing-history">
        <BillingHistory />
      </Ways>
      <Ways context="marketing.pricing-hero">
        <PricingHero />
      </Ways>
    </>
  );
}

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

Traduce pensamientos completos

Bien:

'use client';
 
import Link from 'next/link';
import { T } from '@18ways/react';
 
export function InvoiceLink() {
  return (
    <T>
      Download your latest invoice as{' '}
      <Link href="/invoices/latest.pdf">PDF</Link>
    </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 cosida de nuevo.

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