Negen talen, één brontekst

De mensen die bestellen via Portal, onze website en webshop voor de spiritshandel, zitten over de hele wereld. Veel van hen redden zich prima in het Engels, maar de meesten lezen liever hun eigen taal, zeker als ze op het punt staan een grote bestelling te plaatsen. Daarom spreekt Portal er negen: Engels, Nederlands, Duits, Frans, Italiaans, Spaans, Chinees, Japans en Arabisch.
Alles met de hand vertalen werkte voor ons nooit. We passen teksten en functies te vaak aan, en elke wijziging zou langs een vertaler moeten voor elke taal. Voor je het weet is de helft van de site in minstens één taal verouderd.
Waar we begonnen
In 2023 hadden we zes talen en een set JSON-bestanden: één per taal, met Engels als bron. Een klein script vergeleek de bestanden, stuurde nieuwe Engelse teksten naar DeepL, schreef de vertalingen terug en ruimde op wat niet meer gebruikt werd. Een paar honderd zinnen vertalen ging van weken naar seconden, en een tekst toevoegen werd: in het Engels schrijven en het script draaien.
Dat werkte, maar alle teksten zaten in de code. Een woord op de site aanpassen betekende een developer, een commit en een deploy.
Hoe het nu werkt
De teksten zijn uit de code gehaald en zitten nu in de backend. Elk stukje tekst in de webshop is een placeholder: een sleutel met een Engelse brontekst en een vertaling per taal, die je kunt aanpassen zonder aan de code te komen.
Komt er een nieuwe tekst bij, dan is het Engels eerst aan de beurt. Heeft nog niemand die geschreven, dan stelt Claude een eerste Engelse tekst voor op basis van wat de sleutel zegt dat het is, zoals offer.delivery_week. Dat voorstel is een startpunt dat iemand nog moet lezen, niet de definitieve tekst. Vanuit die Engelse tekst vult DeepL de andere acht talen in. Productnamen en vaktermen zijn gemarkeerd, zodat ze onvertaald blijven, en de teksten die er echt toe doen krijgen nog steeds een menselijke controle.
We kozen DeepL boven Google Translate omdat de vertalingen voor ons soort tekst gewoon beter waren.

Wat we geleerd hebben
Het belangrijkste wat we leerden: zorg dat het Engels klopt. Een machine vertaalt precies wat je erin stopt, dus een vage Engelse tekst levert negen vage vertalingen op. “Cart” kan een winkelwagentje zijn of een karretje waarin je rijdt; met wat meer context in het Engels worden alle vertalingen in één keer beter.
Vroeger hield het wachten op vertalingen elke wijziging op. Nu staat nieuwe tekst in alle negen talen klaar zodra het Engels af is, en controleren we alleen met de hand waar het echt uitmaakt.