Фронтенд завантажує лише ключі перекладів, перелічені в services/web/frontend/extracted-translations.json (services/web/frontend/translations-loader.js). Бекенд і його шаблони читають повні файли з services/web/locales/.Виконайте це в каталозі develop один раз після першого налаштування і знову після додавання перекладу або зміни гілки:
bin/i18n
bin/i18n робить дві речі:
Скидає services/web/locales/*.json до закомічених файлів, а потім застосовує патчі локалей так само, як це роблять збірки образу: файли з найвищої теки locales_patches/v* замінюють локалі, а locales_patches/added/*.json об’єднуються поверх, ключ за ключем.
Запускає yarn run extract-translations від імені користувача node у контейнері webpack, що перезаписує extracted-translations.json. Якщо образу webpack немає, спершу синхронізує yarn.lock за допомогою bin/sync і збирає образ.
Потрібен jq на хості.
Зміни, які bin/i18n вносить у services/web/locales/*.json, лише локальні. Не комітьте їх.
За можливості використовуйте наявний ключ. Файли локалей надходять з upstream Overleaf або зі стороннього сайту перекладів, тож не редагуйте їх безпосередньо. Новий ключ додається до services/web/locales/locales_patches/added/, одразу у файл кожної мови (en.json, zh-CN.json та інші).