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

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

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

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

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

다운로드 옵션은 Download 창에서 파일을 다운로드할 때 표시되며 General, Advanced, Encoding 탭이 있습니다.

다른 File format을 선택하면 다른 옵션이 표시됩니다. 자세한 내용은 specific file format에 관한 관련 문서를 참조하십시오.

선택적으로 General 탭의 File name 필드를 사용하여 사용자 지정 내보내기 파일 이름을 지정하거나, 비워 두어 시스템 정의 이름을 생성할 수 있습니다.

기본적으로 번역 가능 리소스는 원래 파일 구조를 유지하는 대신 키와 값으로 저장됩니다. 이를 통해 한 형식에 잠김 상태가 되지 않으면서 파일 형식<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:
      # accounts
      - file: ./path/to/locales/accounts.<locale_name>.yml
        params:
          tags: accounts
      # emails
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: emails

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

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

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

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

정적 제품 현지화

제품이 완전히 개발되어 업데이트가 거의 없는 경우, 제품의 별도 버전을 프로젝트 내에 둘 수 있습니다.

지속적인 업데이트가 있는 프로젝트 현지화

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

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

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

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