YAML 파일을 온라인으로 번역하는 방법

AI 기반 도구를 사용하면 YAML 현지화 파일을 쉽게 번역할 수 있습니다. 다음 단계에 따라 몇 분 안에 완전히 번역된 YAML 파일을 얻으세요:

1. .yaml 또는 .yml 파일 콘텐츠를 위 편집기에 붙여넣으세요.
2. 원본 언어를 설정하거나(자동 감지를 위해 비워둠) 대상 언어 코드(예: es, de, ja, zh)를 입력하세요.
3. 번역을 클릭하고 AI가 YAML 콘텐츠를 처리할 때까지 기다리세요. 대용량 파일의 경우 번역에 몇 분 정도 걸릴 수 있습니다.
4. 번역된 출력을 복사하거나 저장소에 커밋할 준비가 된 .yaml 파일로 다운로드하세요.

YAML 파일이란 무엇인가요?

YAML(YAML Ain't Markup Language)은 현대 소프트웨어 개발에서 구성 파일 및 현지화에 널리 사용되는 사람이 읽을 수 있는 데이터 직렬화 형식입니다. 깔끔하고 들여쓰기 기반의 구문 덕분에 JSON이나 XML보다 읽고 쓰기가 쉽습니다.

YAML 파일은 .yaml 또는 .yml 확장자를 사용하며 Ruby on Rails, Symfony(PHP), Vue i18n, Flutter ARB, Spring Boot 및 기타 여러 프레임워크의 표준 현지화 형식입니다. 단일 YAML 파일에는 일반적으로 한 언어에 대한 모든 번역된 문자열이 포함됩니다.

YAML은 중첩 키, 목록 및 인라인 주석을 지원하므로 애플리케이션의 구성 요소 트리를 반영하는 계층적 구조로 대규모 UI 문자열 세트를 구성하는 데 특히 적합합니다.

현지화를 위한 YAML 파일 구조

일반적인 YAML 현지화 파일은 중첩된 키-값 쌍을 사용하여 기능이나 구성 요소별로 문자열을 구성합니다. 다음은 일반적인 YAML 구조의 예입니다:

# Application configuration
app:
  name: "My Application"
  version: "2.0.0"
  description: "A powerful tool for managing your workflow"

navigation:
  home: "Home"
  about: "About Us"
  contact: "Contact"
  login: "Sign In"
  logout: "Sign Out"

messages:
  welcome: "Welcome back, {{name}}!"
  error: "An unexpected error occurred. Please try again."
  success: "Your changes have been saved successfully."

buttons:
  save: "Save"
  cancel: "Cancel"
  delete: "Delete"
  confirm: "Confirm"

• 키-값 쌍 — YAML의 기초: key: "번역된 문자열".
• 중첩 키 — 공통 부모 아래에 관련 문자열을 그룹화합니다: button.save: "저장".
• 목록 — - 접두사를 사용하는 정렬된 값 시퀀스.
• 주석 — #으로 시작하는 줄은 번역가를 위한 문맥을 제공하며 선택적으로 보존됩니다.
• 보간 플레이스홀더 — {{name}} 또는 %{count}와 같은 변수는 그대로 보존되며 절대 번역되지 않습니다.

YAML 현지화 파일 예시

아래는 프로덕션 Rails 및 Vue i18n 프로젝트에서 볼 수 있는 중첩 키, 보간 및 주석 사용을 보여주는 실제 YAML 현지화 파일입니다:

# en/messages.yaml
user:
  greeting: "Hello, {{name}}!"
  farewell: "Goodbye, {{name}}. See you soon!"
  profile:
    title: "Your Profile"
    subtitle: "Manage your account settings"
    avatar: "Profile Picture"

errors:
  notFound: "The page you are looking for does not exist."
  unauthorized: "You are not authorized to view this page."
  serverError: "A server error occurred. Please contact support."

forms:
  required: "This field is required."
  email: "Please enter a valid email address."
  minLength: "Must be at least {{min}} characters."

AI는 모든 문자열 값을 번역하는 동시에 키, 보간 변수 및 구조적 들여쓰기는 완전히 변경하지 않고 유지합니다. 결과물은 대상 언어에 대한 드롭인 교체 파일입니다.

소프트웨어 현지화에서의 YAML 파일

YAML은 사람이 읽을 수 있는 가독성과 기계가 파싱할 수 있는 가독성 사이의 적절한 균형을 유지하기 때문에 소프트웨어 현지화에서 가장 인기 있는 형식 중 하나입니다. 개발자는 특별한 도구 없이도 YAML 파일을 직접 편집할 수 있으며, 자동화된 파이프라인은 이를 안정적으로 처리할 수 있습니다.

일반적인 현지화 워크플로우에서는 locales 또는 i18n 디렉토리 내에 언어당 하나의 YAML 파일(예: en.yml, de.yml, ja.yml)을 유지합니다. 원본 언어 파일은 참조로 취급되며, 각 대상 로케일에 대해 번역된 복사본이 생성됩니다.

YAML을 현지화에 사용하는 프레임워크 및 도구

YAML 현지화 파일은 여러 언어와 플랫폼에 걸쳐 광범위한 인기 프레임워크에서 지원됩니다:

• Ruby on Rails — 기본 i18n 형식으로 YAML을 사용합니다(config/locales/en.yml). Rails i18n 젬은 중첩 키, 복수형 및 보간을 기본적으로 지원합니다.
• Symfony (PHP) — XLIFF와 함께 YAML 번역 파일을 지원합니다. translations/messages.en.yaml의 YAML 파일은 Symfony 번역 구성 요소를 구동합니다.
• Spring Boot (Java) — Spring은 일반적으로 .properties 파일을 사용하지만, application.yml의 Spring YAML 지원과 i18n4java와 같은 커뮤니티 라이브러리는 YAML을 현지화로 확장합니다.
• Flutter / Dart — easy_localization 패키지와 유사한 Flutter i18n 라이브러리는 YAML 파일을 사용하여 모바일 및 데스크톱 앱의 번역을 관리합니다.
• Vue i18n — 공식 Vue.js 국제화 플러그인은 YAML 메시지 파일을 지원합니다. Vite-plugin-vue-i18n을 사용하면 .yaml 파일을 Vue 구성 요소로 직접 가져올 수 있습니다.
• React / Next.js — next-i18next 및 react-i18next와 같은 라이브러리는 사용자 지정 백엔드를 통해 YAML 번역 파일을 로드할 수 있어 Next.js 현지화에 인기 있는 선택입니다.

YAML 번역을 위한 AI 용어집 생성

AI 용어집 생성 기능을 사용하면 모든 YAML 현지화 파일에서 일관된 용어를 유지할 수 있습니다. 번역 옵션에서 용어집 생성 및 저장을 토글하여 저장 및 재사용을 활성화하세요:

• 일관된 용어 — AI는 원본 YAML과 기존 대상 번역을 분석하여 핵심 용어의 용어집을 구축함으로써 제품명, UI 라벨 및 기술 용어가 앱 전체에서 동일하게 번역되도록 합니다.
• 도메인 특화 용어 — 대상 문자열 필드에 이미 번역된 YAML 콘텐츠 샘플을 제공하세요. AI는 선호하는 용어를 학습하고 새 문자열에 자동으로 적용합니다.
• 사용 방법 — 용어집 생성이 활성화되었을 때 나타나는 선택적 대상 문자열 필드에 번역된 YAML 콘텐츠를 붙여넣으세요. AI가 반복되는 용어를 추출하여 번역 가이드로 사용합니다. 대상 문자열이 제공되지 않으면 AI는 원본 콘텐츠만으로 용어집 항목을 생성하며, 이는 여전히 일관성을 향상시킬 수 있습니다.

YAML 번역에 L10n.dev를 사용하는 이유

• AI 기반 정확도 — 당사의 번역 엔진은 원시 텍스트뿐만 아니라 YAML 현지화 문맥을 이해합니다. 키, 앵커, 별칭 및 구조적 구문을 무시하면서 사람이 읽을 수 있는 문자열을 번역합니다.
• 구조 보존 — 들여쓰기, 중첩 및 YAML 계층 구조는 항상 보존됩니다. 번역된 파일은 수정 없이 파싱할 수 있는 유효한 YAML 문서입니다.
• 보간 지원 — {{name}}, %{count}, :variable 및 ICU 메시지 형식 변수와 같은 플레이스홀더는 감지되어 번역 중에 그대로 유지됩니다.
• 중첩 키 인식 — AI는 깊게 중첩된 YAML 파일의 계층적 구조를 이해하고 트리 내 위치에 따라 각 문자열에 대한 정확한 문맥을 유지합니다.
• 다중 프레임워크 호환성 — 출력은 Ruby on Rails, Symfony, Vue i18n, Flutter, Spring Boot 및 표준 YAML 현지화 파일을 사용하는 기타 모든 프레임워크와 호환됩니다.
• 최대 10,000 문자까지 무료로 번역하세요. 유료 플랜은 대규모 프로젝트를 위한 확장 가능한 가격을 제공합니다.가격 보기
• 대용량 파일에 최적화 — 매우 큰 YAML 파일(수백 킬로바이트)의 경우 최대 5MB의 파일 업로드를 지원하는 I18N 파일 번역 페이지를 사용하세요.

일반적인 YAML 번역 사용 사례

YAML 번역은 광범위한 애플리케이션 유형 및 개발 워크플로우에서 사용됩니다:

• Ruby on Rails 앱 — 다국어 Rails 애플리케이션을 위해 config/locales/en.yml을 추가 언어 파일로 번역합니다.
• Symfony PHP 프로젝트 — Symfony 기반 웹사이트 및 API를 위해 translations/messages.en.yaml 및 도메인별 번역 파일을 현지화합니다.
• Vue.js / Nuxt.js 앱 — Vue 단일 페이지 애플리케이션 및 Nuxt.js 정적 사이트에 언어 지원을 추가하기 위해 Vue i18n YAML 메시지 파일을 번역합니다.
• Flutter 모바일 앱 — 여러 시장을 대상으로 하는 크로스 플랫폼 Flutter 앱을 위해 assets/lang/en.yaml 현지화 파일을 번역합니다.
• 구성 및 CMS 콘텐츠 — 다국어 사이트 콘텐츠를 위해 Jekyll, Hugo 또는 Gatsby와 같은 정적 사이트 생성기에서 사용하는 YAML 구성 파일을 번역합니다.
• 정적 사이트 생성기 — Jekyll은 사이트 전체 문자열에 _data/ YAML 파일을 사용하고, Hugo는 i18n/ YAML 파일을 사용하며, Gatsby는 gatsby-plugin-react-i18next를 통해 YAML을 지원합니다.
• CI/CD 및 DevOps 파이프라인 — L10n.dev REST API를 사용하여 YAML 번역을 배포 파이프라인에 통합하고 릴리스 워크플로우의 일부로 현지화를 자동화합니다.

현지화를 위한 YAML vs JSON

YAML과 JSON은 모두 현지화 파일에 널리 사용되지만 강점이 다릅니다. YAML의 사람이 읽을 수 있는 구문, 주석 지원 및 컴팩트한 여러 줄 문자열은 개발자가 번역 파일을 직접 편집하는 Ruby 및 PHP와 같은 커뮤니티에서 선호됩니다.

JSON은 JavaScript 생태계(React, Angular, Vue) 전반에서 더 보편적으로 지원되며 프로그래밍 방식으로 파싱하기가 더 쉽습니다. 프로젝트에서 두 형식을 모두 사용하는 경우 L10n.dev는 두 형식을 모두 지원합니다. JSON 번역 페이지에서 JSON 파일을, 여기에서 YAML 파일을 번역할 수 있습니다.

대부분의 프로젝트에서 형식 선택은 사용하는 프레임워크에 의해 결정됩니다. Rails, Symfony 또는 Vue i18n을 사용하는 경우 YAML이 자연스러운 선택입니다. Angular i18next, React i18next 또는 Next.js를 사용하는 경우 JSON이 더 일반적입니다. L10n.dev는 두 형식 모두 잘 처리합니다.

자주 묻는 질문

번역 중에 YAML 파일의 어떤 부분이 보존되나요?

모든 YAML 구조 요소(키, 들여쓰기, 중첩, 앵커(&), 별칭(*), 주석(#) 및 목록 구문(-))가 보존됩니다. {{variable}}, %{name} 및 :symbol과 같은 보간 플레이스홀더는 항상 변경되지 않고 유지됩니다. 사람이 읽을 수 있는 문자열 값만 번역됩니다.

번역 중에 보간 변수와 플레이스홀더는 안전한가요?

네. 당사의 AI는 Rails(%{name}), Vue i18n({name}), Symfony(%variable%), Flutter({name}) 및 ICU 메시지 형식에서 사용하는 일반적인 보간 패턴을 감지합니다. 이러한 변수는 작성된 그대로 보존되며 절대 번역되거나 수정되지 않습니다.

YAML 파일을 어떻게 번역하나요?

.yaml 또는 .yml 파일 콘텐츠를 위 편집기에 붙여넣고, 대상 언어 코드(예: fr, de, ja, zh)를 설정한 후 번역을 클릭하세요. AI는 모든 키와 구조가 보존된 완전히 번역된 YAML 파일을 반환합니다. 결과를 .yaml 파일로 다운로드하세요.

AI 용어집 생성이 YAML 번역에 어떻게 도움이 되나요?

용어집 생성 및 저장을 활성화하면 기존에 번역된 YAML 콘텐츠를 원본 파일과 함께 붙여넣을 수 있습니다. AI는 반복되는 용어를 추출하여 번역 가이드로 사용함으로써 제품명, 기능 라벨 및 도메인 용어가 파일 전체와 향후 번역 전반에서 일관되게 번역되도록 합니다.

대용량 YAML 현지화 파일을 번역할 수 있나요?

이 페이지는 수백 킬로바이트까지의 개별 YAML 파일에 잘 작동합니다. 대량의 YAML 번역이나 매우 큰 파일의 경우 최대 5MB의 파일 업로드를 지원하고 대규모 현지화 프로젝트에 더 안정적인 전달을 제공하는 I18N 파일 번역 페이지를 사용하세요.