Kennis
Een site in veertien talen: zo pak je i18n aan
Meertaligheid is geen vertaalklus aan het eind. Het begint bij hoe je je code opzet: geen tekst in de code, sleutels per onderwerp, en elke taal getest.

Deze site bestaat in veertien talen, van Nederlands en Engels tot Japans, Amhaars en Afaan Oromo. Met AI is vertalen snel. Het werk zit in de opzet: als tekst vastzit in de code, wordt elke nieuwe taal een klus.
In gewone technische taal i18n (internationalisation) betekent: je code zo opzetten dat elke tekst uit een vertaalbestand komt. Elke tekst heeft een Engelse sleutel, en per taal een bestand met de vertalingen. De browser regelt meervouden en datums per taal met
Intl.PluralRulesenIntl.DateTimeFormat.
Waarom het ertoe doet
Klanten lezen het liefst in hun eigen taal. Maar een site die je per taal met de hand bijhoudt, raakt snel uit de pas: een knop die in het Duits nog Engels is, een datum in het verkeerde formaat. Met een goede opzet voeg je een taal toe zonder de code te raken, en ziet een test meteen wat ontbreekt.

Hoe het werkt
De code bevat alleen sleutels; een agent vertaalt het bronbestand, een mens controleert, en een test en de build vangen wat ontbreekt.

Wat je doet
- Nooit tekst in de code. Elke tekst die een gebruiker ziet, komt uit een vertaalbestand.
- Engelse sleutels, één bestand per onderwerp per taal. Bij ons: i18next, met platte sleutels als
contact.hero.title. - Kies een brontaal en een terugval. Onze brontaal is Nederlands. Ontbreekt een sleutel, dan valt de site terug op Engels, en daarna op Nederlands.
- Meervouden per taal. Niet elke taal heeft alleen “één” en “meer”. Pools heeft extra vormen; wij gebruiken daarvoor
_one,_few,_manyen_other.Intl.PluralRuleskiest de juiste vorm. - Datums en getallen met
Intl, nooit zelf in elkaar gezet. - Rechts-naar-links voorbereiden. Voor Arabisch of Hebreeuws zet je volgens het W3C
dir="rtl"op hethtml-element. Gebruik in CSS logische eigenschappen, zoalsmargin-inline-startin plaats vanmargin-left, dan draait de opmaak vanzelf mee. - Let op taalregels. Japans en Chinees zetten geen spatie tussen zinnen. Turks heeft een hoofdletter İ met punt, waar zoeken rekening mee moet houden.
- Vertalen met een agent, controleren door een mens. Vaste zinnen en merknamen leg je vast, zodat de agent ze niet hertaalt.
- Test elke taal. Bij ons faalt
npm run check:i18nals een sleutel ontbreekt, en bouwt CI alle veertien talen.
Wat we met je kunnen doen: we maken je site of app meertalig, met een opzet waarin je zonder programmeur een taal toevoegt. Plan een gesprek.