Frontend wczytuje tylko klucze tłumaczeń wymienione w services/web/frontend/extracted-translations.json (services/web/frontend/translations-loader.js). Backend i jego szablony czytają pełne pliki z services/web/locales/.Uruchom to w katalogu develop raz po pierwszej konfiguracji i ponownie po dodaniu tłumaczenia lub zmianie gałęzi:
bin/i18n
bin/i18n robi dwie rzeczy:
Przywraca services/web/locales/*.json do zatwierdzonych plików, a następnie nakłada poprawki lokalizacji tak, jak robią to buildy obrazu: pliki z najwyższego folderu locales_patches/v* zastępują lokalizacje, a locales_patches/added/*.json są scalane na wierzchu, klucz po kluczu.
Uruchamia yarn run extract-translations jako użytkownik node w kontenerze webpack, co nadpisuje extracted-translations.json. Jeśli brakuje obrazu webpack, najpierw synchronizuje yarn.lock za pomocą bin/sync i buduje obraz.
Wymaga jq na hoście.
Zmiany, które bin/i18n wprowadza w services/web/locales/*.json, są wyłącznie lokalne. Nie commituj ich.
W miarę możliwości używaj istniejącego klucza. Pliki lokalizacji pochodzą z Overleaf upstream lub z zewnętrznej platformy tłumaczeń, więc nie edytuj ich bezpośrednio. Nowy klucz trafia do services/web/locales/locales_patches/added/, do pliku każdego języka jednocześnie (en.json, zh-CN.json i pozostałych).