다국어 콘텐츠 관리

이 가이드는 플랫폼의 다국어 콘텐츠를 관리하고 유지보수하는 방법에 대해 설명하며, 모든 언어 버전의 콘텐츠가 동기화되고 일관성을 유지하도록 보장합니다.

지원 언어

플랫폼은 현재 다음 언어를 지원합니다:

간체 중국어 (zh) - 메인 언어
번체 중국어 (zh-Hant) - 번체 중국어 버전
영어 (en) - 국제 공통 언어
일본어 (ja) - 일본 사용자
한국어 (ko) - 한국 사용자
프랑스어 (fr) - 프랑스어 사용자
독일어 (de) - 독일어 사용자
스페인어 (es) - 스페인어 사용자
인도네시아어 (id) - 인도네시아 사용자
브라질 포르투갈어 (pt-BR) - 브라질 사용자
러시아어 (ru) - 러시아어 사용자
터키어 (tr) - 터키 사용자

디렉토리 구조

다국어 콘텐츠는 다음 구조로 정리됩니다:

content/
├── zh/                    # 간체 중국어 (메인 언어)
│   ├── 01.docs/          # 문서
│   ├── 02.guides/        # 가이드
│   └── 03.tools/         # 도구
├── en/                    # 영어
├── ja/                    # 일본어
├── ko/                    # 한국어
├── fr/                    # 프랑스어
├── de/                    # 독일어
├── es/                    # 스페인어
├── id/                    # 인도네시아어
├── pt-BR/                 # 브라질 포르투갈어
├── ru/                    # 러시아어
├── tr/                    # 터키어
└── zh-Hant/               # 번체 중국어

콘텐츠 동기화 원칙

1. 메인 언어 우선

간체 중국어 (zh)가 메인 언어이며, 모든 새로운 콘텐츠는 먼저 중국어 버전에서 생성됩니다
다른 언어 버전은 중국어 버전을 기반으로 번역됩니다

2. 파일 구조 일관성

모든 언어 버전은 동일한 디렉토리 구조를 유지해야 합니다
파일명과 경로는 완전히 일치해야 합니다
각 언어 버전에 해당하는 파일이 있는지 확인하세요

3. 콘텐츠 완전성

중요한 문서는 모든 언어 버전에 해당하는 버전이 있어야 합니다
핵심 기능과 사용자 가이드의 번역을 우선시합니다
기술 문서는 주요 언어를 우선하여 번역할 수 있습니다

번역 워크플로우

1. 콘텐츠 생성

중국어 버전에서 새로운 콘텐츠 생성
콘텐츠 구조가 명확하고 번역하기 쉽도록 확인
표준 Markdown 형식 사용

2. 번역 우선순위

높은 우선순위:

사용자 인터페이스 텍스트
자주 묻는 질문
빠른 시작 가이드
핵심 기능 문서

중간 우선순위:

상세한 기술 문서
API 참조 문서
설정 가이드

낮은 우선순위:

고급 기능 문서
개발자 도구 문서
샘플 코드 주석

3. 번역 품질 검사

번역의 정확성과 완전성 확인
전문 용어의 일관성 유지
문법과 철자 오류 확인
링크와 참조 검증

자동화 도구

다국어 콘텐츠 확인 스크립트

내장된 확인 스크립트를 사용하여 콘텐츠 동기화 상태를 검증:

# 모든 언어의 콘텐츠 동기화 상태 확인
node scripts/multilingual-content.js check

# 누락된 파일 구조 생성
node scripts/multilingual-content.js init

# 환영 페이지 생성
node scripts/multilingual-content.js welcome