Mga pinakamahusay na gawi

Ang pinakamabilis na paraan para makakuha ng masamang salin ay ang pagawin ang runtime na umangkop sa mga problemang maiiwasan sa istruktura ng app.

Gumamit ng mga totoong pangalan ng konteksto

Ang mga mabubuting context key ay nagpapaliwanag kung saan nakalagay ang kopya:

ts
await engine.t('Pay now', {
  context: 'checkout.payment-form',
});
 
await engine.t('Billing history', {
  context: 'dashboard.billing-history',
});
 
await engine.t('Simple pricing', {
  context: 'marketing.pricing-hero',
});

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

Isalin ang mga kumpletong kaisipan

Mabuti:

ts
const label = await engine.t('Download your latest invoice as PDF');

Iwasan:

Kayang hawakan ng 18ways ang karaniwang kaso ng link bilang iisang mensahe. <T><a href="#">I-click dito</a> para makakita ng iba pa</T> dapat manatiling isang pangungusap sa halip na hati-hatiin at muling pagsamahin.

ts
const first = await engine.t('Download');
const second = await engine.t('your latest invoice');
const third = await engine.t('as PDF');
 
const stitched = [first, second, third].join(' ');

Panatilihing malinaw ang hangganan ng pakete

  • Kung nasa Next.js ka, gamitin ang @18ways/next para sa pagresolba ng locale at metadata.
  • Kung React lang ang gamit mo, itago ang state ng locale sa app mo at gamitin ang @18ways/react.
  • Kung nasa labas ka ng React, gamitin ang @18ways/core at ikaw na ang bahalang mag-integrate ng UI.

Hayaan ang routing na umangkop sa iyong produkto

Karaniwan, gusto ng mga pampublikong pahina ng marketing ang locale routing na batay sa path para sa SEO. Ang mga internal dashboard at mga ruta ng internal tooling ay kadalasan hindi. Kaya naman hindi isinasama ng kasalukuyang site ang /dashboard, /__design, at /__email sa path routing.

Panatilihing tao ang source copy

Pinakamahusay ang 18ways kapag ang source text ay parang totoong product copy, at hindi parang naka-compress na translation key.

Ang magandang source copy ay nagbibigay sa modelo ng mas mahusay na konteksto at nagbibigay sa iyong team ng isang bagay na madaling basahin sa code.

Pinakamahuhusay na Kasanayan