Mga pangunahing konsepto

May ilang bagay na may matibay na paninindigan ang 18ways. Kapag malinaw na ang mga ito, diretso na lang ang natitirang bahagi ng API surface.

Batayang lokal

Ang iyong baseLocale ay ang wikang isinusulat mo.

Kung ang product copy mo ay nakasulat sa British English, ang base locale mo ay en-GB. Kung ito ay nakasulat sa American English, ang base locale mo ay en-US.

Kapag ang kasalukuyang locale ay tumutugma sa base locale, ibinabalik agad ng 18ways ang source text at nilalaktawan ang gawain sa pagsasalin.

Target na lokalidad

Ang iyong target na locale ay ang wikang kasalukuyang binabasa ng user.

Sa Vanilla JS, direktang itinatalaga mo ito sa engine gamit ang engine.setLocale(...).

Mga konteksto

Ang mga context ay kung paano pinagsasama-sama ng 18ways ang magkakaugnay na kopya.

Gamitin ang mga ito para panatilihing maliit ang mga kahilingan sa pagsasalin at maiwasang pagsamahin ang mga hindi magkakaugnay na teksto.

ts
import { create18waysEngine } from '@18ways/core/engine';
 
const engine = create18waysEngine({
  apiKey: 'pk_dummy_demo_token',
  baseLocale: 'en-GB',
  locale: 'fr-FR',
  context: 'marketing',
});
 
const heroTitle = await engine.t('Wrap your text. We handle the rest.', {
  context: 'marketing.hero',
});
 
const pricingTitle = await engine.t('Simple pricing', {
  context: 'marketing.pricing',
});

Gumamit ng mga stable na pangalan ng context para manatiling magkakasama ang magkakaugnay na copy.

Mga tinanggap na locale

18ways ay nagkakaiba sa pagitan ng:

  • isang locale na makikilala nito, gaya ng fr-FR
  • isang lokaling aktuwal na tinatanggap ng iyong proyekto

Sa core package, kadalasan ay itinatago mo ang listahan ng mga tinatanggap na locale sa sarili mong app at ino-normalize mo ito bago tawagan ang engine.setLocale(...).

ts
const acceptedLocales = ['en-GB', 'fr-FR', 'de-DE'];
 
function setLocale(nextLocale: string) {
  const locale = acceptedLocales.includes(nextLocale) ? nextLocale : 'en-GB';
 
  engine.setLocale(locale);
}

Pagpupursige

Ang cookie ng kagustuhan sa locale na ginagamit ng mga runtime adapter ay 18ways_locale.

Kung i-persist mo mismo ang locale at gusto mong manatiling compatible sa mga layer ng React o Next, gamitin ang parehong pangalan.

Kapag naglo-load ang mga pagsasalin

@18ways/core ay nagbibigay sa iyo ng mas mababang antas na engine at caching, pero ikaw ang may-ari ng rendering flow.

Pinagsasaluhang mental na modelo

Panatilihing simple ang modelo:

  1. Piliin ang tamang package para sa iyong app.
  2. Itakda nang tama ang base locale.
  3. Panatilihing matatag at makabuluhan ang mga susi ng konteksto.
  4. Hayaan ang runtime na magsalin ng buong parirala, hindi mga piraso.

Susunod: Pag-format ng Mensahe