Melhores práticas

A forma mais rápida de obter traduções ruins é fazer com que o tempo de execução contorne problemas de estrutura de aplicativo evitáveis.

Use nomes de contexto reais

Boas chaves de contexto explicam onde o texto está localizado:

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>
  );
}

Evite baldes anónimos como page1, copy ou misc.

Traduzir pensamentos completos

Bom:

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 pode lidar com o caso de link comum como uma mensagem. <T><a href="#">Clique aqui</a> para ver mais</T> deve permanecer como uma frase em vez de ser dividida e costurada novamente.

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

Mantenha a fronteira do pacote clara

• Se estiver no Next.js, use @18ways/next para resolução de localidade e metadados.
• Se você estiver apenas no React, mantenha o estado de localidade na sua aplicação e use @18ways/react.
• Se estiver fora do React, use @18ways/core e faça a integração da interface do utilizador você mesmo.

Deixe o encaminhamento corresponder ao seu produto

As páginas de marketing públicas geralmente desejam roteamento de localidade baseado em caminho para SEO. Os painéis internos e as rotas de ferramentas internas muitas vezes não o fazem. É por isso que o site atual exclui /dashboard, /__design e /__email do roteamento por caminho.

Mantenha a cópia original humana

18ways funciona melhor quando o texto de origem é escrito como uma cópia de produto real, e não como uma chave de tradução comprimida.

Uma boa cópia de origem fornece ao modelo um melhor contexto e dá à sua equipa algo legível no código.