Hvernig bætir þú mörgum tungumálum við appið þitt eða vefsíðu

Til að bæta mörgum tungumálum við app þarftu að færa allan texta sem notendur sjá í þýðingaskrár (eina fyrir hvert tungumál), hlaða þeim með i18n-bókasafni og bæta við tungumálavali sem man valið. Fyrir opinberar síður sem þú vilt finna í leit fær hvert tungumál sína eigin slóð, til dæmis /fr/, og útgáfurnar eru tengdar saman með hreflang-merkjum. Síðan þarf að sinna þeim atriðum sem fólk gleymir: dagsetningum, tölum og gjaldmiðlum, lengri texta á sumum tungumálum, tungumálum sem eru lesin frá hægri til vinstri og efni í gagnagrunninum.

Orð sem þú munt heyra

• Alþjóðavæðing (i18n): að undirbúa kóðann þannig að hann styðji hvaða tungumál sem er: enginn fastur strengur, staðbundið snið og sveigjanlegt skipulag. Talan „18“ er fjöldi stafanna á milli i og n.
• Staðfærsla (l10n): að laga appið að tilteknu tungumáli eða markaði, aðallega þýðingu, en stundum líka gjaldmiðil, myndir og lagatexta.
• Staðarstilling (locale): tungumál og, ef vill, land, eins og en-GB eða pt-BR.

Gerðu i18n einu sinni og þá verður hvert nýtt tungumál aðallega þýðingarvinna.

Valkostir og málamiðlanir

Fyrir flest öpp er staðlað i18n-bókasafn með þýðingaskrám rétti grunnurinn. Gerðu drög með vél- eða gervigreindarþýðingu ef þú vilt, og láttu síðan reiprennandi fólk yfirfara það sem viðskiptavinir sjá oftast.

Hlutar fjöltyngds apps

Þýðingaskrár

Í stað <h1>Welcome back</h1> segir kóðinn t('dashboard.welcome'), og hver staðarstilling hefur skrá með textanum:

{
  "dashboard": {
    "welcome": "Velkomin aftur, {{name}}",
    "items_one": "{{count}} hlutur",
    "items_other": "{{count}} hlutir"
  }
}

Notaðu staðgengla fyrir breytur í stað þess að setja setningarbrot saman, því orðaröð er ólík milli tungumála. Og notaðu fleirtölureglur bókasafnsins: enska hefur tvær myndir (1 hlutur, 2 hlutir), en sum tungumál hafa þrjár, fjórar eða fleiri.

Snið dagsetninga, talna og peninga

Ekki forsníða þetta handvirkt. Innbyggða Intl-API vafrans forsníðar fyrir hvaða staðarstillingu sem er: 1,234.5 á ensku verður 1.234,5 á þýsku; dagsetningar skipta á milli dags-fyrst og mánaðar-fyrst; gjaldmiðilstákn færast til. Geymdu dagsetningar í UTC og upphæðir sem tölur með gjaldmiðilskóða, og forsníddu eingöngu til birtingar.

Skipulag sem teygist

Þýddur texti er oft lengri en enskur, einkum þýska og finnska. Forðastu hnappa með föstri breidd og afskorin merki, og prófaðu með lengsta tungumálinu þínu.

Tungumál sem eru lesin frá hægri til vinstri

Arabíska, hebreska, persneska og úrdú eru lesin frá hægri til vinstri. Stilltu dir="rtl" á síðunni fyrir þessar staðarstillingar og notaðu rökrétta CSS-eiginleika (margin-inline-start í stað margin-left; í Tailwind ms-4 í stað ml-4) svo skipulagið speglist sjálft. Tákn sem gefa til kynna stefnu, eins og örvar, þarf líka að snúa við.

Tungumálaval og greining

Sýndu tungumálaval á hverri síðu, merkt með innfæddu heiti hvers tungumáls („Deutsch“, „Français“, „العربية“) frekar en fánum; fánar tákna lönd, ekki tungumál. Greindu tungumál vafrans við fyrstu heimsókn til að stinga upp á útgáfu, en leyfðu skýru vali gestsins að ráða og munaðu það.

Slóðir og SEO

Fyrir síður sem þú vilt í leitarniðurstöðum þarf hvert tungumál sína eigin slóð. Frá og með september 2026 er leiðbeining Google fyrir fjöltyngdar síður þessi:

• Aðskildar slóðir fyrir hvert tungumál: undirmöppur (example.com/fr/) eru einfaldastar; undirlén og landslén virka líka. Slóðabreytur (?lang=fr) eru ekki ráðlagðar.
• Ekki skipta um tungumál eingöngu með vafraköku eða stillingu vafrans, því skriðforrit Google gæti aldrei séð hinar útgáfurnar.
• Ekki beina sjálfkrafa eftir tungumáli; tengdu útgáfurnar saman í staðinn.
• Notaðu hreflang til að segja Google hvaða síður eru þýðingar hver af annarri. Hver útgáfa verður að skrá sjálfa sig og allar hinar, annars gætu tengingarnar verið hunsaðar. Bættu við x-default fyrir varasíðuna.
• Google greinir tungumál síðu út frá sýnilegu efni, ekki út frá lang eða hreflang, svo þýddu alla síðuna, ekki bara valmyndina.

Settu samt <html lang="fr"> á hverja útgáfu: skjálesarar nota það til að velja rétt framburðarmál, sem er hluti af aðgengi.

Innskráð svæði í appinu þurfa ekki að vera í leitarvélum, svo fyrir þau er í lagi að geyma tungumálið í notandaprófílnum. Sjá SEO fyrir vefsíður byggðar með gervigreind til að fá opinberu síðurnar skriðnar í fyrsta lagi.

Efni í gagnagrunninum

Viðmótstexti er í skrám; efni eins og vöruheiti, bloggfærslur og flokkar er í gagnagrunninum. Tvö algeng mynstur:

• Þýðingatafla: product_translations (product_id, locale, name, description). Hreint og skalar fyrir mörg tungumál.
• JSON-dálkur fyrir hvern reit: name: {"en": "...", "fr": "..."}. Einfaldara fyrir fá tungumál.

Ákveddu hvað gerist þegar þýðingu vantar. Venjulega er betra að falla aftur á sjálfgefna tungumálið en að sýna autt svæði.

Tölvupóstar og tilkynningar

Geymdu tungumál hvers notanda og notaðu það líka fyrir tölvupósta, tilkynningar og PDF-skjöl. Auðvelt er að þýða appið og gleyma því að velkomnitölvupósturinn berst enn á ensku.

Fyrirmæli sem virka

Bættu við alþjóðavæðingu með react-i18next. Færðu allan texta sem notendur sjá í locales/en.json með nafnarýmislyklum, notaðu staðgengla og fleirtölureglur í stað strengjasamsetningar, og forsníddu dagsetningar, tölur og verð með Intl eftir núverandi staðarstillingu. Ekki breyta orðalagi enn.

Bættu við frönsku og þýsku. Opinberar markaðssíður fá forskeytin /fr/ og /de/ með ensku við rótina, hreflang-tengingar á hverri síðu (þar á meðal sjálfsvísun og x-default), og html lang stillt á hverri síðu. Bættu við tungumálavali sem sýnir innfært heiti hvers tungumáls. Fyrir innskráðar síður skaltu geyma tungumálið í notandaprófílnum.

Bættu við arabísku með stuðningi fyrir hægri-til-vinstri: stilltu dir="rtl" fyrir arabísku, skiptu vinstri- og hægrispássíum út fyrir rökrétta eiginleika, speglaðu tákn sem vísa í stefnu og athugaðu að eyðublöð og töflur séu enn læsileg.

Skref fyrir skref

1. Veldu fyrsta aukatungumálið út frá raunverulegri eftirspurn, þar sem gestir eða viðskiptavinir þínir eru.
2. Gerðu kóðann alþjóðlegan: færðu strengi í skrár, bættu við fleirtölu og Intl-sniði. Sendu þetta út með eingöngu ensku og athugaðu að ekkert hafi breyst.
3. Ákveddu slóðauppbygginguna fyrir opinberar síður og bættu við hreflang.
4. Þýddu: gerðu drög með vél- eða gervigreindarþýðingu, síðan yfirferð hjá reiprennandi manneskju. Gefðu þýðendum samhengi, því orðið „Book“ er nafnorð á einum skjá og sagnorð á öðrum.
5. Þýddu efni í gagnagrunninum og settu varagildi.
6. Staðfærðu hitt: tölvupósta, villuskilaboð, lagasíður og myndir með texta.
7. Prófaðu hvert tungumál á símabreidd, og með hægri-til-vinstri ef það á við.
8. Settu upp ferli svo nýir eiginleikar komi með þýðingum, ekki mánuðum síðar.

Algeng mistök

• Að setja setningar saman ("You have " + n + " messages"), sem brotnar á öðrum tungumálum.
• Fastur texti sem gleymdist í íhlutum, villuskilaboðum og staðfestingarstrengjum.
• Handvirk sniðun dagsetninga og verða.
• Fánar fyrir tungumál, og sjálfvirk endurbeining sem festir fólk í rangri útgáfu.
• Ein slóð fyrir öll tungumál á síðum sem þú vilt skráðar.
• Hreflang-tengingar vantar til baka, svo Google hunsar merkingarnar.
• Að þýða viðmótið en ekki efnið, eða öfugt.
• Óyfirfarin vélþýðing á verð-, lagaskilmála- og greiðslusíðum.

Gátlisti fyrir fjöltyngt app

• Enginn fastur texti sem notendur sjá; fleirtölureglur og staðgenglar notaðir
• Dagsetningar, tölur og gjaldmiðlar forsniðnir með Intl
• Tungumálaval með innfæddum heitum á hverri síðu; valið er munað
• Aðskildar slóðir fyrir hvert tungumál á opinberum síðum; engar þvingaðar endurbeiningar
• hreflang á hverri útgáfu, þar á meðal sjálfsvísun og x-default
• html lang (og dir="rtl" þar sem þarf) stillt á hverri síðu
• Efni í gagnagrunninum þýtt með skynsamlegum varagildum
• Tölvupóstar og tilkynningar sendar á tungumáli notandans
• Texti sem viðskiptavinir sjá yfirfarinn af reiprennandi manneskju

Fjöltyngd öpp á Mythex

Á Mythex bætir þú tungumálum við með því að biðja um það í spjallinu. Það er ekkert sérstakt þýðingarspjald, svo fyrirmælin hér að ofan virka eins og þau eru skrifuð. Gerðu alþjóðavæðingarskrefið fyrst og athugaðu það í Preview áður en þú bætir við tungumálum, því þetta er stór endurskipulagning. Spjall og vistunarpunktar gefa þér stað til að snúa aftur til ef eitthvað brotnar. Ef þú vilt að appið þýði efni sjálfkrafa með gervigreind eða þýðingar-API notar það þinn eigin API-lykil, geymdan í verkefnisstillingum (umhverfisbreytur og leyndarmál). Hvernig nota á LLM-API útskýrir kostnaðinn. Birtu aftur þegar nýju tungumálin eru tilbúin.

Spurningar