Chuyển đến nội dung chính
Frontend chỉ tải các khóa dịch được liệt kê trong services/web/frontend/extracted-translations.json (services/web/frontend/translations-loader.js). Backend và các template của nó đọc toàn bộ tệp trong services/web/locales/. Chạy lệnh này trong thư mục develop một lần sau lần thiết lập đầu tiên, và chạy lại sau khi thêm bản dịch hoặc đổi nhánh:
bin/i18n làm hai việc:
  1. Nó đặt lại services/web/locales/*.json về các tệp đã commit, rồi áp dụng các bản vá locale theo cách các bản build image làm: các tệp của thư mục locales_patches/v* cao nhất thay thế các locale, và locales_patches/added/*.json được hợp nhất lên trên, từng khóa một.
  2. Nó chạy yarn run extract-translations dưới người dùng node trong container webpack, việc này ghi lại extracted-translations.json. Nếu thiếu image webpack, trước tiên nó đồng bộ yarn.lock bằng bin/sync và build image.
Nó cần jq trên máy chủ.
Các thay đổi mà bin/i18n tạo ra trong services/web/locales/*.json chỉ là cục bộ. Đừng commit chúng.
Hãy dùng lại một khóa có sẵn bất cứ khi nào có thể. Các tệp locale đến từ Overleaf upstream hoặc một trang dịch của bên thứ ba, vì vậy đừng sửa trực tiếp. Khóa mới được đặt trong services/web/locales/locales_patches/added/, vào tệp của mọi ngôn ngữ cùng lúc (en.json, zh-CN.json và các tệp khác).
Lần sửa đổi cuối 20 tháng 11, 2026