Naar hoofdinhoud gaan
De frontend laadt alleen de vertaalsleutels die in services/web/frontend/extracted-translations.json staan (services/web/frontend/translations-loader.js). De backend en de templates lezen de volledige bestanden in services/web/locales/. Voer dit in de map develop één keer uit na de eerste installatie, en opnieuw na het toevoegen van een vertaling of het wisselen van branch:
bin/i18n doet twee dingen:
  1. Het zet services/web/locales/*.json terug naar de gecommitte bestanden en past daarna de locale-patches toe zoals de image-builds dat doen: de bestanden van de hoogste map locales_patches/v* vervangen de locales, en locales_patches/added/*.json worden er sleutel voor sleutel overheen samengevoegd.
  2. Het voert yarn run extract-translations uit als gebruiker node in de container webpack, waardoor extracted-translations.json opnieuw wordt geschreven. Als de webpack-image ontbreekt, synchroniseert het eerst yarn.lock met bin/sync en bouwt het de image.
Het heeft jq nodig op de host.
De wijzigingen die bin/i18n aanbrengt in services/web/locales/*.json zijn alleen lokaal. Commit ze niet.
Hergebruik waar mogelijk een bestaande sleutel. De locale-bestanden komen van Overleaf upstream of van een vertaalsite van derden, dus bewerk ze niet rechtstreeks. Een nieuwe sleutel hoort in services/web/locales/locales_patches/added/, in het bestand van elke taal tegelijk (en.json, zh-CN.json en de andere).
Laatst gewijzigd op 20 november 2026