로컬라이제이션 파일 사용하기 (문자열)

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

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

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

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

다운로드 옵션은 다운로드 창에서 파일을 다운로드할 때 일반, 고급 및 인코딩 탭으로 제공됩니다.

다른 파일 형식을 선택하면 다른 옵션이 제공됩니다. 자세한 내용은 특정 파일 형식에 대한 관련 기사를 참조하십시오.

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

기본적으로 번역 가능한 리소스는 원본 파일 구조를 유지하는 대신 키와 값으로 저장됩니다. 이것은 하나의 형식에 고정되지 않고 교환 가능한 파일 형식을 허용하며 태그를 사용하여 유연한 그룹화를 가능하게 합니다.

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

별도의 파일 유지

일반적으로 각 언어에 대한 모든 번역을 하나의 파일에 유지하십시오. 이것은 리소스 다운로드를 더 빠르고 견고하게 만듭니다. 번역은 프로젝트에서 정리되어 유지되므로 별도의 작은 파일이 필요하지 않습니다.

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

모든 파일에서 키에 고유한 이름을 부여하여 원활한 워크플로를 보장하십시오. 키-값 기반 접근 방식에서는 키가 모든 컨텍스트에서 동일한 값이 할당되어야 합니다. 일부 프레임워크는 여러 파일에서 비고유 키의 사용을 허용합니다. 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> 자리 표시자를 사용하는 대신 푸시 섹션에서도 사용할 수 있습니다.

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

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

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

정적 제품 현지화

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

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

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

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

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

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