Pinakamahuhusay na gawain

Ang pinakamabilis na paraan para makakuha ng masamang salin ay ang pagpilit sa runtime na mag-work around sa mga problemang madaling naiwasan sa istruktura ng app.

Gumamit ng mga tunay na pangalan ng konteksto

Ang magagandang context key ay nagpapaliwanag kung saan nakalagay ang kopya:

tsx

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

Iwasan ang mga anonymous na bucket gaya ng page1, copy, o misc.

Isalin ang buong diwa

Mabuti:

tsx

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

Iwasan:

Maaaaring pangasiwaan ng 18ways ang karaniwang kaso ng link bilang iisang mensahe. <T><a href="#">Mag-click dito</a> para makakita ng higit pa</T> ay dapat manatiling iisang pangungusap sa halip na hati-hatiin at pagdugtung-dugtungin muli.

tsx

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

Panatilihing malinaw ang hangganan ng pakete

Kung nasa Next.js ka, gamitin ang @18ways/next para sa locale resolution at metadata.
Kung React lang ang gamit mo, itago ang estado ng locale sa app mo at gamitin ang @18ways/react.
Kung wala ka sa React, gamitin ang @18ways/core at ikaw na ang bahala sa UI integration.

Hayaan ang routing na tumugma sa iyong produkto

Karaniwang gusto ng mga public marketing page ang path-based na locale routing para sa SEO. Ang mga internal dashboard at mga route ng internal tooling ay madalas na hindi. Kaya naman hindi kasama ng kasalukuyang site ang /dashboard, /__design, at /__email sa path routing.

Panatilihing human ang source copy

Pinakamainam ang 18ways kapag ang source text ay parang totoong product copy, hindi parang pinagsiksik na translation key.

Ang maayos na source copy ay nagbibigay sa modelo ng mas mahusay na konteksto at nagbibigay sa iyong team ng isang bagay na nababasa sa code.