현지화 파일(Strings) 업로드 및 다운로드

Strings에서 파일을 업로드하려면 다음 단계를 따르십시오.

모든 프로젝트 페이지에서 더 보기 메뉴의 업로드를 선택하여 업로드 아카이브에 액세스하십시오.

업로드 아카이브에는 가능한 모든 상태의 모든 과거 업로드가 나열됩니다. 모든 상태 드롭다운을 클릭하여 상태(성공, 실패 및/또는 진행 상황)별로 업로드를 필터링하십시오. 특정 업로드를 찾으려면 상단의 검색 상자를 사용하여 이름으로 검색하십시오.

나열된 업로드를 클릭하여 영향을 받는 리소스의 자세한 업로드 요약을 액세스하십시오. 모든 성공적인 업로드는 프로젝트의 활동 스트림에도 표시됩니다.

다운로드 옵션은 다운로드<1> 창에서 파일을 다운로드할 때 표시되며 일반, 고급, 인코딩 탭이 있습니다.

다른 파일 형식<1>을 선택하면 다른 옵션이 표시됩니다. 자세한 내용은 특정 파일 형식에 관한 관련 문서를 참조하십시오.

선택적으로 일반 탭의 파일 이름 필드를 사용하여 사용자 지정 내보내기 파일 이름을 지정하거나, 비워 두어 시스템 정의 이름을 생성하십시오.

기본적으로 번역 가능 리소스는 원래 파일 구조를 유지하는 대신 키와 값으로 저장됩니다. 이를 통해 한 형식에 잠기지 않고 상호 교환 가능한 파일 형식<1>을 사용할 수 있으며 태그<2>를 사용하여 유연하게 그룹화할 수 있습니다.

일부 프레임워크나 설정은 추가 구성이 필요한 여러 소스 파일을 요구하기도 합니다.

별도 파일 유지

일반적으로 각 언어에 대한 모든 번역은 하나의 파일에 보관하십시오. 이렇게 하면 리소스 다운로드가 더 빠르고 안정적입니다. 번역은 프로젝트 내에서 조직화되어 유지되므로 작은 파일을 별도로 분리할 필요가 없습니다.

로컬라이제이션 파일을 별도의 파일로 유지해야 하는 경우, 업로드 시 키에 태그를 지정하고 번역된 키를 원래 파일로 다시 다운로드할 때 태그를 참조로 사용하여 파일 기반 워크플로를 사용할 수 있습니다. 키는 여러 태그를 가질 수 있으며 여러 파일에 포함되어 재사용성과 일관성을 보장할 수 있습니다. 태그 기반 워크플로는 유연하며 프로젝트에 업로드하지 않고도 번역 리소스를 재조직할 수 있습니다.

원활한 워크플로를 보장하기 위해 모든 파일에서 키에 고유한 이름을 지정하십시오. 키-값 기반 접근 방식에서는 키가 모든 컨텍스트에서 동일한 값을 할당받아야 합니다. 일부 프레임워크는 여러 파일에 걸쳐 고유하지 않은 키를 사용하는 것을 허용합니다. Symfony와 같은 일부 형식은 메시지 도메인을 지원합니다. 이러한 도메인은 파일 이름으로 감지됩니다. 키는 파일 이름 기반 도메인에 의해 자동으로 범위가 지정되지 않지만, 파일 내 키에 고유한 도메인 접두사를 사용하여 해결할 수 있습니다.

CLI 설정 예시

CLI로 작업하거나 프로젝트를 리포지토리(예: GitHub, GitLab 또는 Bitbucket)와 연결하는 경우, 업로드 및 다운로드를 관리하기 위한 구성 파일을 설정하십시오.

예를 들어, 프로젝트에는 소스 로캘에 대한 의미론적으로 명명된 여러 번역 파일이 있습니다. 예: accounts.en.yml, emails.en.yml 등. 이러한 의미론적 이름은 태그를 통해 관리됩니다.

.phrase.yml을 구성하여 로컬라이제이션 프로젝트의 파일 조직을 반영하고 파일 경로에 태그 자리 표시자를 포함하여 Strings 프로젝트의 태그에 연결하십시오:

phrase:
  access_token: "3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793"
  project_id: "23485c9c5dfb15d85b32d9c5f3d2hl54"
  file_format: yml
  push:
    sources:
      - file: ./path/to/locales/<tag>.en.yml
        params:
          locale_id: "abcd1234cdef1234abcd1234cdef1234"
  pull:
    targets:
      # 계정
      - file: ./path/to/locales/accounts.<locale_name>.yml
        params:
          태그: 계정
      # 이메일
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          태그: 이메일

매개변수 태그는 <tag><1> 자리 표시자를 사용하는 대신 푸시 섹션에서도 사용할 수 있습니다.

구성은 리포지토리에서 푸시를 실행하거나 동기화를 트리거할 때 파일 기반의 태그가 포함된 키를 생성합니다. 풀을 실행하거나 리포지토리로 내보내기를 트리거할 때 태그를 기반으로 키를 파일로 그룹화합니다.

제품, 웹사이트 또는 앱이 여러 다른 언어로 번역되지만, 경우에 따라 현지화는 단순히 선택된 언어뿐만 아니라 한 언어 내의 다른 버전을 의미하기도 합니다.

다음과 같은 경우 추가적인 구분이 필요합니다:

정적 제품 현지화

제품이 완전히 개발되었고 거의 업데이트되지 않는 경우, 프로젝트 내에 별도의 제품 버전이 존재할 수 있습니다.

지속적인 업데이트가 있는 프로젝트 로컬라이즈

제품이 새로운 콘텐츠(키)로 지속적으로 업데이트되는 경우, 이러한 업데이트를 여러 프로젝트에 적용하고 동기화 상태를 유지하는 것은 어렵습니다. 프로젝트 내에서 전용 언어를 사용하여 유지 관리합니다.

ISO 표준을 따르는 언어 코드(예: en-US)는 고유할 필요가 없으므로, 동일한 언어의 여러 버전을 프로젝트 내에서 생성할 수 있습니다. 고유한 언어 이름을 사용하여 지역, 클라이언트 또는 대상을 구분합니다.

설정 시, 기본 로캘에 새로 도입된 모든 키는 다른 언어에서 번역되지 않음으로 표시되며 그에 따라 로컬라이즈됩니다. 클라이언트 및 해당 클라이언트의 번역가와 작업하는 경우, 사용자 프로필 또는 프로젝트 사용자 관리에서 언어 액세스를 업데이트하여 해당 번역가가 자신의 언어 버전만 편집할 수 있도록 구체적으로 할당합니다.

동일한 프로젝트 내에서 작업 및 검토 워크플로를 사용하여 병렬 로컬라이제이션 프로세스를 설정합니다. 이러한 유연성은 API를 통한 언어 파일 업로드 및 다운로드나 자동화된 프로세스로도 확장됩니다.