DS_L10N/config.yaml

# DS_L10N Configuration File
# 던전 스토커즈 현지화 워크플로우 설정

# ============================================================================
# 경로 설정 (Paths)
# ============================================================================
paths:
  # 언리얼 엔진 현지화 폴더 (LocalExport 상위 폴더)
  # DS_L10N 폴더 기준 상대 경로
  unreal_localization: ../WorldStalker/Content/Localization/LocalExport

  # 번역 작업 출력 폴더
  output_dir: ./output

  # 로그 파일 저장 폴더
  logs_dir: ./logs

  # 오래된 파일 보관 폴더
  archive_dir: ./archive

  # 임시 파일 폴더
  temp_dir: ./temp

# ============================================================================
# 파일명 설정 (File Names)
# ============================================================================
files:
  # 언리얼에서 생성하는 PO 파일명
  po_filename: LocalExport.po

  # 번역 업데이트용 TSV 입력 파일
  translation_input: 번역업데이트.tsv

  # 미번역 항목 추출 파일명 패턴
  untranslated_pattern: "untranslated_{timestamp}.tsv"

  # 병합된 CSV 파일명 패턴
  merged_pattern: "merged_po_entries_{timestamp}.csv"

  # 로그 파일명 패턴
  log_pattern: "workflow_{timestamp}.log"

# ============================================================================
# 언어 설정 (Languages)
# ============================================================================
languages:
  # 원본 언어
  source: ko

  # 번역 대상 언어 목록 (우선순위 순서)
  targets:
    - en
    - ja
    - zh-Hans
    - zh-Hant
    - es-ES
    - es-419
    - fr-FR
    - de-DE
    - ru-RU
    - pt-BR
    - pt-PT
    - it-IT
    - pl-PL
    - tr-TR
    - uk-UA
    - vi-VN
    - th

# ============================================================================
# 검증 설정 (Validation)
# ============================================================================
validation:
  # 변수 일치 확인 (예: {Value}, {Count})
  check_variables: true

  # 리치 텍스트 태그 일치 확인 (예: <Red>...</>)
  check_rich_text_tags: true

  # 줄바꿈 문자 일치 확인 (예: \r\n)
  check_newlines: true

  # 빈 번역 확인
  check_empty_translations: true

  # msgctxt 존재 여부 확인 (PO 파일에 실제 존재하는지)
  check_msgctxt_exists: true

  # 최대 길이 초과 경고 (UI 텍스트 제한)
  max_length_warning: 200

  # 검증 실패 시 업데이트 중단 여부
  stop_on_validation_error: false

# ============================================================================
# 자동 정리 설정 (Cleanup)
# ============================================================================
cleanup:
  # 최근 N개 파일만 유지 (나머지는 archive로 이동)
  keep_recent_files: 5

  # 오래된 파일 자동 보관 활성화
  auto_archive: true

  # 보관 대상 파일 패턴
  archive_patterns:
    - "merged_po_entries_*.csv"
    - "untranslated_*.tsv"
    - "untranslated_*.csv"

  # N일 이상 된 로그 파일 삭제
  delete_old_logs_days: 30

# ============================================================================
# 백업 설정 (Backup)
# ============================================================================
backup:
  # PO 파일 업데이트 전 자동 백업
  auto_backup_before_update: true

  # 백업 파일명 패턴
  backup_pattern: "{original_name}.backup_{timestamp}"

  # 백업 보관 기간 (일)
  keep_backups_days: 7

# ============================================================================
# 로그 설정 (Logging)
# ============================================================================
logging:
  # 로그 레벨: DEBUG, INFO, WARNING, ERROR, CRITICAL
  console_level: INFO

  # 파일 로그 레벨
  file_level: DEBUG

  # 컬러 콘솔 출력 활성화
  colored_output: true

  # 상세 모드 (더 많은 정보 출력)
  verbose: false

  # 진행률 표시
  show_progress: true

# ============================================================================
# 미번역 추출 설정 (Extract)
# ============================================================================
extract:
  # 모든 대상 언어 검사 (false면 en만 검사)
  check_all_languages: false

  # fuzzy 플래그 항목도 포함 (원본 변경으로 리뷰 필요한 항목)
  include_fuzzy: true

  # 언어별 개별 파일로 추출 (false면 통합 파일)
  separate_files: true

# ============================================================================
# 워크플로우 설정 (Workflow)
# ============================================================================
workflow:
  # 오류 발생 시 작업 중단
  stop_on_error: true

# ============================================================================
# 출력 형식 설정 (Output Format)
# ============================================================================
output:
  # CSV/TSV 인코딩
  encoding: utf-8-sig  # UTF-8 with BOM (Excel 호환)

  # CSV 구분자 (쉼표)
  csv_delimiter: ","

  # TSV 구분자 (탭)
  tsv_delimiter: "\t"

  # 모든 필드 따옴표로 감싸기
  quote_all: true

  # 줄바꿈 문자 처리 방식: "literal" (\\r\\n) 또는 "preserve" (\r\n)
  newline_mode: literal

# ============================================================================
# 리치 텍스트 태그 패턴 (Rich Text Tags)
# ============================================================================
rich_text:
  # 인식할 리치 텍스트 태그 패턴
  tag_patterns:
    - "<Red>"
    - "<Blue>"
    - "<Green>"
    - "<Yellow>"
    - "<Orange>"
    - "<Purple>"
    - "<White>"
    - "<Black>"
    - "<RichTextBlock.Style>"
    - "</>"

  # 태그 검증 활성화
  validate_tags: true

# ============================================================================
# 변수 패턴 (Variable Patterns)
# ============================================================================
variables:
  # 변수 패턴 (정규식)
  pattern: "\\{[A-Za-z0-9_]+\\}"

  # 알려진 변수 목록
  known_variables:
    - "{Value}"
    - "{Count}"
    - "{PlayerName}"
    - "{Time}"
    - "{Damage}"
    - "{Duration}"
    - "{Amount}"
    - "{Percent}"
    - "{Range}"
    - "{Level}"
    - "{ItemName}"
    - "{SkillName}"

# ============================================================================
# 고급 설정 (Advanced)
# ============================================================================
advanced:
  # 멀티스레딩 활성화
  use_multithreading: true

  # 스레드 개수 (0 = CPU 코어 수)
  thread_count: 0

  # 메모리 사용 최적화 (대용량 파일 처리 시)
  memory_optimization: false

  # dry-run 모드 (실제 파일 수정 없이 시뮬레이션)
  dry_run: false