메인 콘텐츠로 건너뛰기
프런트엔드는 services/web/frontend/extracted-translations.json에 나열된 번역 키만 불러옵니다(services/web/frontend/translations-loader.js). 백엔드와 그 템플릿은 services/web/locales/의 전체 파일을 읽습니다. 첫 설정 후 한 번, 그리고 번역을 추가하거나 브랜치를 바꾼 뒤에 다시 develop 디렉터리에서 다음을 실행하세요.
bin/i18n은 두 가지 일을 합니다.
  1. services/web/locales/*.json을 커밋된 파일로 되돌린 다음, 이미지 빌드와 같은 방식으로 로케일 패치를 적용합니다. 가장 높은 locales_patches/v* 폴더의 파일이 로케일을 대체하고, locales_patches/added/*.json이 키 단위로 그 위에 병합됩니다.
  2. webpack 컨테이너에서 node 사용자로 yarn run extract-translations를 실행하여 extracted-translations.json을 다시 씁니다. webpack 이미지가 없으면 먼저 bin/sync로 yarn.lock을 동기화하고 이미지를 빌드합니다.
호스트에 jq가 필요합니다.
bin/i18n이 services/web/locales/*.json에 적용하는 변경은 로컬 전용입니다. 커밋하지 마세요.
가능하면 기존 키를 재사용하세요. 로케일 파일은 Overleaf 업스트림이나 서드파티 번역 사이트에서 가져오므로 직접 편집하지 마세요. 새 키는 services/web/locales/locales_patches/added/에, 모든 언어의 파일(en.json, zh-CN.json 등)에 동시에 추가합니다.
마지막 수정일 2026년 11월 20일