🔄

i18n-download-force

Google Sheets의 데이터로 로컬 번역을 완전히 덮어씁니다

⚠️

위험: 데이터 손실 가능

이 명령어는 로컬 번역 파일을 Google Sheets의 데이터로 완전히 덮어씁니다. 로컬에만 있는 번역이 모두 삭제됩니다. 일반적으로 i18n-download를 사용하는 것이 안전합니다.

개요

i18n-download-force는 Google Sheets를 단일 진실 공급원(Single Source of Truth)으로 사용할 때를 위한 명령어입니다. 로컬 번역 파일을 Sheets의 데이터로 완전히 대체합니다.

⚠로컬 번역 완전 덮어쓰기

⚠로컬 전용 번역 삭제

⚠되돌릴 수 없음 (Git 미사용 시)

사용 시기

✅Google Sheets를 마스터로 사용

모든 번역 작업이 Google Sheets에서만 이루어지고, 로컬 파일은 단순히 Sheets의 복사본인 경우

✅로컬 변경사항이 없음을 확신

로컬에서 번역을 직접 수정하지 않고, Sheets에서만 번역을 관리하는 경우

✅로컬 파일 리셋 필요

로컬 파일이 손상되었거나 문제가 있어서 Sheets의 깨끗한 버전으로 다시 시작하고 싶은 경우

사용법

설정 파일 사용

npx i18n-download-force

명령줄 옵션 사용

npx i18n-download-force \
  --spreadsheet-id "YOUR_SPREADSHEET_ID" \
  --credentials "./credentials.json"

작동 방식

Sheets 데이터 가져오기

Google Sheets에서 모든 번역을 읽어옵니다.

로컬 파일 삭제

기존 로컬 번역 파일의 내용을 완전히 지웁니다.

Sheets 데이터 쓰기

Sheets의 번역을 로컬 파일에 씁니다. 병합 없음.

예제 출력

$ npx i18n-download-force --spreadsheet-id "1abc...xyz"

⚠️  WARNING: This will overwrite all local translations!
📊 Reading from Google Sheets...
   Spreadsheet: "i18n Translations"
   Sheet: "Translations"
   ✓ Found 128 translation keys
   Languages: ko, en

🔄 Force overwriting local files...
   ✗ Removed all existing local data
   ✓ locales/ko.json (128 keys)
   ✓ locales/en.json (128 keys)

✅ Force download complete!
   Total keys: 128
   All local files replaced with Sheets data

i18n-download와 비교

특성	i18n-download	i18n-download-force
로컬 번역 보존	✓	✗
스마트 병합	✓	✗
안전성	안전함	주의 필요
사용 빈도	자주 사용	드물게 사용
권장 사용	일반적인 경우	특수한 경우

안전 대책

💡실행 전 Git 커밋

명령 실행 전에 현재 상태를 Git에 커밋하세요. 문제가 생기면 되돌릴 수 있습니다.

git add locales/
git commit -m "backup before force download"
npx i18n-download-force

💡백업 생성

로컬 번역 파일을 다른 위치에 백업한 후 명령을 실행하세요.

💡Sheets 내용 확인

Google Sheets의 내용이 올바른지 확인한 후 다운로드하세요.

모범 사례

❌일반적으로 사용하지 마세요

대부분의 경우 i18n-download를 사용하는 것이 더 안전합니다.

✅명확한 워크플로우 정의

팀에서 Google Sheets를 단일 진실 공급원으로 사용하기로 명확히 합의한 경우에만 사용하세요.

✅CI/CD에서 사용

자동화된 배포 파이프라인에서 Sheets로부터 항상 최신 번역을 가져오는 용도로 사용할 수 있습니다.