Using Localization Files (Strings)

Strings 파일을 업로드 다음 단계를 수행하십시오.

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

업로드 보관함에는 모든 가능한 상태로 모든 기록 uploads 나열됩니다. 모든 상태 드롭다운을 클릭하여 상태(성공, 불합격 및/또는 진행 상황)에 따라 업로드를 필터링합니다. 특정 업로드를 찾으려면 상단의 검색 Box를 사용하여 이름으로 검색합니다.

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

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

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

기본적으로 번역 가능 가능한 리소스는 원래 파일 구조를 유지하는 대신 키와 값으로 저장됩니다. 이렇게 하면 하나의 형식으로 잠김 없이 교환 가능한 파일 형식과 태그를 사용한 유연한 그룹화가 가능해집니다.

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

개별 파일 유지

일반적으로 각 언어 대한 모든 번역을 하나의 파일에 유지하십시오. 이렇게 하면 리소스 다운로드가 더 빠르고 신뢰할 수 있습니다. 번역이 프로젝트 내에서 구성되도록 유지되므로 별도의 작은 파일이 필요하지 않습니다.

현지화 파일을 별도의 파일로 유지해야 하는 경우 업로드 시 키에 태그를 지정하고 번역된 키를 원본 파일로 다시 다운로드할 때 tags 참조 사용하여 파일 기반 워크플로 사용할 수 있습니다. 키는 여러 tags 가지고 재사용과 일관성을 보장하는 여러 파일에 포함될 수 있습니다. 태그 기반 워크플로가 유연하며 프로젝트에 업로드할 필요 없이 번역 리소스를 재 조직할 수 있습니다.

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

CLI 구성 예시

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

예를 들어, 프로젝트 소스 로캘 대한 의미적으로 이름이 지정된 여러 번역 파일이 있습니다. 예: accounts.en.yml, emails.en.yml 등 이 시멘틱 이름은 tags 통해 관리됩니다.

.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:
      # 계정
      - 파일: ./path/to/ 로캘/계정.<locale_name>.yml
        params:
          tags: 계정
      # 이메일
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: 이메일

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

이 구성은 push 실행하거나 리포지토리 동기화를 트리거할 때 원본 파일에 따라 tags 포함된 키를 생성합니다. pull 실행하거나 리포지토리 내보내기 트리거할 때 tags 따라 키를 파일로 그룹화합니다.

제품, 웹 사이트 또는 앱은 여러 언어로 번역되지만, 어떤 경우에는 선택한 언어가 아니라 한 언어 내의 다양한 버전으로 현지화가 이루어집니다.

다음 경우 추가 구분이 필요합니다.

정적 제품의 현지화

제품이 완벽하게 개발되고 업데이트되는 경우 프로젝트 내에 별도의 버전이 존재할 수 있습니다.

연속 업데이트로 프로젝트 현지화

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

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

설정 시 기본 로캘 새로 가져온 모든 키 다른 언어로 번역되지 번역되지 않음 것으로 표시되며 그에 따라 현지화됩니다. 클라이언트와 번역가를 작업할 경우, 특별히 할당하여 사용자 프로필 또는 프로젝트 사용자 관리에서 언어 액세스를 업데이트하여 언어 버전을 편집할 수 있습니다.

동일한 프로젝트 내에서 작업과 병렬 현지화 프로세스를 설정하고 크크플로를 검토하십시오. 이 유연성은 또한 API를 통해 언어 파일 또는 자동화된 프로세스를 업로드하고 다운로드하는 데에도 적용됩니다.