Cafe24 i18n Translation Helper

VS Code 확장 프로그램으로, Cafe24 프로젝트의 국제화(i18n) 코드를 번역된 텍스트로 변환하는 기능을 제공합니다.

기능

1. 인라인 번역 데코레이션 (v1.1.0 신규)

• 명령어: 한국어 번역 표시 켜기/끄기로 번역 표시 ON/OFF
• i18n 코드 옆에 한국어 번역을 인라인으로 표시
• Globe 아이콘과 함께 번역 텍스트 표시
• 파일 내 모든 번역을 한눈에 확인 가능

2. 국제화 코드 -> 번역문 변환

• 소스 코드 내의 i18n 코드를 선택한 언어의 번역된 텍스트로 변환합니다
• 지원하는 i18n 코드 형식:
  • PHP 스타일: <?= __('msgID', 'groupID'); ?>
  • 일반 함수: __('msgID', 'groupID')
  • 특수 형식: __msgID#groupID__

3. 빠른 한국어 번역 (Quick Korean Translation)

• 단축키:
  • Windows/Linux: Ctrl + Shift + T
  • Mac: Command + Shift + T
• 선택한 코드 영역의 i18n 코드를 즉시 한국어로 변환하여 팝업으로 표시
• 우클릭 메뉴에서 Quick Translate to Korean 옵션을 통해 번역 가능
• 도메인 자동 검색 순서: admin -> front -> javascript -> template
• 별도의 UI 선택 없이 빠르게 한국어 번역 확인 가능

사용 방법

전체 파일 번역

1. 명령 팔레트 열기 (Ctrl+Shift+P / Cmd+Shift+P)
2. "Convert i18n Code to Translation" 명령 실행
3. 원하는 언어 선택 (ko_KR, en_US, ja_JP 등)
4. 변환된 결과가 새 파일에서 열립니다

빠른 한국어 번역

1. 번역하고 싶은 i18n 코드가 포함된 영역을 드래그하여 선택
2. Shift + I (Mac: Shift + I) 단축키 입력
3. 팝업으로 한국어 번역 결과 확인

요구사항

• VS Code 1.60.0 이상
• 프로젝트 내 locale 디렉토리 구조:

  locale/
  ├── ko_KR/
  │   └── LC_MESSAGES/
  │       └── domain.json
  ├── en_US/
  │   └── LC_MESSAGES/
  └── ja_JP/
      └── LC_MESSAGES/
  

설정

데코레이션 스타일 설정 (v1.1.0 신규)

• cafe24-i18n.decoration.textColor: 번역 텍스트 색상 (기본값: #6B9955)
• cafe24-i18n.decoration.margin: 번역 텍스트 여백 (기본값: 0 0.2em 0 0.2em)
• cafe24-i18n.decoration.fontStyle: 번역 텍스트 글꼴 스타일 (normal/italic/bold)

기본 설정

config.json 파일을 통해 locale 디렉토리 위치를 지정할 수 있습니다:

{
  "localeDirectory": "path/to/locale"
}

단축키

• Ctrl/Cmd + Shift + T: 빠른 한국어 번역

명령어

1. 한국어 번역 표시 켜기/끄기: 인라인 번역 표시를 켜거나 끕니다
2. Convert i18n Code to Translation: 전체 파일의 i18n 코드를 번역문으로 변환합니다
3. Quick Translate to Korean: 선택한 영역의 i18n 코드를 한국어로 번역합니다

릴리즈 노트

1.1.0 (2025-01-21)

• 인라인 번역 데코레이션 기능 추가
• 데코레이션 스타일 커스터마이징 설정 추가

1.0.0 (2024-12-20)

• 국제화 코드를 번역된 텍스트로 변환하는 기능 추가
• 빠른 한국어 번역 기능 추가 (Ctrl+Shift+I)
• 다국어 지원 (ko_KR, en_US, ja_JP)
• locale 디렉토리 자동 감지 기능