Naar inhoud

Kies je stijl: Denkbaar

Plan een gesprek

Artikelen

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.

Drie collega's vergelijken een website op verschillende schermen.
Een meertalige site begint bij een goede opzet. Illustratie: Denkbaar.

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.PluralRules en Intl.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.

Een paginaontwerp ligt bij een sleutel en aparte mappen.
Elke taal krijgt een eigen vertaalbestand. Illustratie: Denkbaar.

Hoe het werkt

Code met sleutels, geen tekst

Bronbestand in het Nederlands

Agent vertaalt per taal

Mens controleert

Test: ontbreekt er een sleutel?

Build van alle talen

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

Twee schermen tonen dezelfde opmaak in tegengestelde richtingen.
Bereid ook een opmaak van rechts naar links voor. Illustratie: Denkbaar.

Wat je doet

  1. Nooit tekst in de code. Elke tekst die een gebruiker ziet, komt uit een vertaalbestand.
  2. Engelse sleutels, één bestand per onderwerp per taal. Bij ons: i18next, met platte sleutels als contact.hero.title.
  3. Kies een brontaal en een terugval. Onze brontaal is Nederlands. Ontbreekt een sleutel, dan valt de site terug op Engels, en daarna op Nederlands.
  4. Meervouden per taal. Niet elke taal heeft alleen “één” en “meer”. Pools heeft extra vormen; wij gebruiken daarvoor _one, _few, _many en _other. Intl.PluralRules kiest de juiste vorm.
  5. Datums en getallen met Intl, nooit zelf in elkaar gezet.
  6. Rechts-naar-links voorbereiden. Voor Arabisch of Hebreeuws zet je volgens het W3C dir="rtl" op het html-element. Gebruik in CSS logische eigenschappen, zoals margin-inline-start in plaats van margin-left, dan draait de opmaak vanzelf mee.
  7. Let op taalregels. Japans en Chinees zetten geen spatie tussen zinnen. Turks heeft een hoofdletter İ met punt, waar zoeken rekening mee moet houden.
  8. Vertalen met een agent, controleren door een mens. Vaste zinnen en merknamen leg je vast, zodat de agent ze niet hertaalt.
  9. Test elke taal. Bij ons faalt npm run check:i18n als 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.