i18n-editor

i18n-editor는 다국어 JSON 번역 파일을 효율적으로 관리할 수 있는 데스크톱 에디터입니다. 여러 워크스페이스를 전환하면서 다양한 프로젝트의 번역 파일을 한 곳에서 관리할 수 있습니다.

목차

• 주요 개념
  • 워크스페이스
  • 네임스페이스
• 주요 기능
• 시작하기
  • 설치
  • 실행
• 사용 방법
  • 워크스페이스 관리
  • 네임스페이스 관리

주요 개념

워크스페이스 (Workspace)

워크스페이스는 하나의 프로젝트에서 사용되는 다국어 번역 파일들의 집합을 의미합니다. 각 워크스페이스는 다음과 같은 특징을 가집니다:

• 독립적인 언어 설정: 각 워크스페이스는 자신만의 지원 언어 목록을 가질 수 있습니다.
• 여러 네임스페이스 관리: 하나의 워크스페이스 안에서 여러 개의 네임스페이스를 관리할 수 있습니다.

네임스페이스 (Namespace)

네임스페이스는 번역 파일을 논리적으로 구분하는 단위입니다. 예를 들어:

• common: 공통으로 사용되는 번역
• auth: 인증 관련 번역
• product: 상품 관련 번역

각 네임스페이스는 지원하는 모든 언어의 번역을 포함하며, JSON 파일로 관리됩니다.

주요 기능

• 워크스페이스 관리

  • 여러 프로젝트의 번역 파일을 별도의 워크스페이스로 관리
  • 워크스페이스 간 빠른 전환 지원
  • 마지막으로 작업한 워크스페이스 자동 복원

• 네임스페이스 편집

  • 모든 언어의 번역을 한 화면에서 관리
  • 새로운 번역 키-값 쌍 추가 및 삭제
  • 번역 실시간 수정

• 언어 관리

  • 새로운 언어 추가 및 삭제
  • 언어별 번역 파일 자동 동기화

시작하기

설치

npm을 사용하는 경우:

npm install -D i18n-editor

yarn을 사용하는 경우:

yarn add -D i18n-editor

실행

기본 설정으로 실행 (포트 5252 사용):

npx i18n-editor

커스텀 포트로 실행:

i18n-editor -p 9000

또는

i18n-editor --port 9000

명령어를 실행하면 자동으로 브라우저 창이 열리면서 애플리케이션이 실행됩니다. 기본적으로 시스템의 기본 브라우저를 사용하여 실행됩니다.

사용 방법

워크스페이스 관리

워크스페이스 구조

워크스페이스는 다음과 같은 구조를 가져야 합니다:

📂workspace
  📂ko
    🗒️common.json
    🗒️...
  📂en
    🗒️common.json
    🗒️...
  📂ja
    🗒️common.json
    🗒️...
  📂... (언어 코드명)

워크스페이스 선택

1. 홈 화면에서 "디렉토리 선택하고 시작" 버튼을 클릭합니다.
2. 번역 파일이 있는 디렉토리를 선택합니다.
3. 선택한 디렉토리가 워크스페이스로 등록됩니다.

워크스페이스 전환

• 사이드바의 워크스페이스 목록에서 원하는 워크스페이스를 클릭하여 전환할 수 있습니다.
• 최근 사용한 워크스페이스는 자동으로 저장되어 다음 실행 시 복원됩니다.

워크스페이스 수정

• 워크스페이스의 기본 정보를 수정할 수 있습니다
  • 디렉토리 변경
  • 워크스페이스명
  • 언어 추가 및 삭제
  • 네임스페이스 추가 및 삭제

네임스페이스 관리

네임스페이스 편집

1. 워크스페이스에서 편집할 네임스페이스를 선택합니다.
2. 표 형식의 에디터에서 번역을 관리할 수 있습니다:
   • 새 번역 추가
     • 특정 번역의 행 옵션 메뉴에서 "위에 번역 추가" 혹은 "아래에 번역 추가" 선택
     • 네임스페이스 최하단에 번역 키값을 입력하여 번역 추가
   • 번역 수정: 셀을 클릭하여 직접 편집
   • 번역 삭제: 행 옵션 메뉴에서 "삭제" 선택