키는 소프트웨어 코드 내의 번역 가능 문자열을 식별하는 데 사용됩니다. 이를 통해 키(번역 가능 문자열의 코드 이름)를 Phrase에서 한 번만 참조하면 되므로, 문자열의 각 필수 번역마다 참조할 필요가 없습니다.
키에는 여러 번역이 연결될 수 있으며, 각 번역은 프로젝트의 서로 다른 언어 로캘에 해당합니다. 이 기능은 관계형 데이터베이스의 기본 키와 유사하며, 번역은 키의 속성입니다. 키는 리소스 파일에 저장되며 소스 및 대상 언어를 식별하는 데 사용됩니다.
키를 사용하면 현지화 관리 플랫폼이 코드를 제시하지 않고도 번역가에게 번역 가능 텍스트를 제시할 수 있습니다.
키는 일반적으로 프로젝트에 추가할 필요가 없습니다. 이상적으로는 프로젝트 페이지의
키가 업로드되거나 생성되는 것을 방지하려면 blocking key 기능을 사용하십시오. 차단된 키가 이미 존재하는 경우, 편집자에서 번역할 수 없습니다.
키를 내보내기에서 제외하려면 exclude keys 기능을 사용하십시오. 제외된 키 또한 편집자에서 번역할 수 없습니다.
프로젝트 페이지의 섹션 또는 Strings Editor 창<3> 상단에서 More/Duplicate key를 선택하여 프로젝트 내의 키를 복제할 수 있습니다.
하나 이상의 프로젝트에서 동일한 값을 가진 서로 다른 번역 키를 연결하여 콘텐츠 업데이트를 자동화할 수 있습니다. Linked keys는 프로젝트 전반의 일관성을 보장하고 동일한 콘텐츠에 대한 반복적인 작업을 제거하는 데 사용됩니다.
키에 대한 변경 사항은 Strings Editor의 sidebar 활동 창에서 되돌릴 수 있습니다.
참고
리포지토리(GitHub, GitLab 등)로 작업하면서 키를 삭제할 때는 Phrase와 리포지토리 양쪽에서 모두 키를 삭제해야 영구적으로 삭제됩니다. 이는 Phrase나 리포지토리에서 오류나 사고로 인해 키가 실수로 삭제되는 것을 방지하기 위함입니다.
Strings에서 키는 업로드된 파일의 형식에 따라 다양한 유형일 수 있습니다.
-
문자열 (기본값)
참고
번역가는 옵션이 고급 프로젝트<2> 설정에서 활성화되지 않은 경우 문자열 키만 편집할 수 있습니다.
-
배열
-
부울
-
Markdown
-
수
키 유형은 편집자<2> 사이드바의
키 이름은 하나의 프로젝트 내에서 고유해야 합니다.
키를 명명하는 여러 가지 전략이 있습니다:
키가 업로드되지 않은 경우 수동으로 생성할 수 있습니다.
키를 생성하려면 다음 단계를 따르십시오.
-
탭에서 Add key를 클릭하십시오.
Add key 창이 열립니다.
-
탭에서 , , 사용 가능한 및 을(를) 제공하십시오.
-
필요한 경우 탭에서 plural forms을(를) 활성화하고 복수형 유형을 선택하십시오.
-
필요한 경우 탭에서 제외할 언어를 선택하십시오.
-
필요한 경우 탭에 기술 세부 정보를 제공하십시오.
예를 들어, 필드에서 번역에 대한 글자 제한을 설정할 수 있습니다. 설정된 경우, 해당 키의 번역을 편집할 때 Strings Editor의 표시기를 통해 글자 제한이 표시됩니다.
-
저장을 클릭합니다.
키가 프로젝트에 추가되며 탭에서 확인할 수 있습니다.
편집자 또는 탭에서 키를 삭제하면 해당 키와 관련된 모든 번역이 삭제되며 되돌릴 수 없습니다.
10,000개 이상의 키가 있는 프로젝트에서는 언급되지 않은 키는 이후 업로드 시 계산되지 않습니다. 언급되지 않은 키는 현재 업로드에 포함되지 않았지만 프로젝트에 여전히 존재하는 키입니다.
차단은 전체 키가 프로젝트에 추가되는 것을 방지합니다. 차단된 키의 이름이 업로드된 파일에 나타나면 해당 키는 생략되고 프로젝트에 추가되지 않습니다.
차단은 키가 프로젝트에서 관리되지 않도록 프로젝트에서 키를 생략하는 데 사용됩니다.
일반적으로 차단되는 키:
-
날짜 및 시간 형식 Strings.
-
구성을 포함하는 키.
-
Phrase gem으로 관리할 때 문제를 일으키는 키.
처리되거나 유지 관리되지 않는 별도의 언어 파일에서 차단된 키를 관리하십시오.
이러한 키는 문제를 일으킬 수 있으므로 사용되는 경우 프로젝트 생성 시 차단해야 합니다.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
키를 차단하려면 다음 단계를 따르십시오:
-
프로젝트 페이지에서 탭을 선택하십시오.
-
차단된 키 목록에 키 추가를 클릭하십시오.
창이 열립니다.
-
키 이름이나 정규식(regex)을 입력하고 저장을 클릭하십시오.
키가 목록에 추가됩니다.
키는 나중에 을(를) 클릭하여 수정하거나
하여 삭제할 수 있습니다.
일부 키는 특정 언어에서 제외되어야 할 수 있으며 제외된 것으로 표시될 수 있습니다. 이 키들은 프로젝트 내에 업로드되어 존재하지만 무시됩니다.
제외된 번역은 다음과 같습니다:
-
관련 언어의 내보내기에서 제외됩니다.
-
관련 언어 보고서에서 제외됩니다.
콘텐츠가 비어 있음이면 번역되지 않음으로 간주되지 않습니다.
-
번역 편집기에서 볼 수는 있지만 편집할 수는 없습니다.
제외 옵션:
-
번역 편집기 내의 언어에서 단일 번역을 제외합니다.
-
번역 편집기 내의 언어에서 여러 번역을 제외합니다.
-
키를 생성하거나 편집할 때 언어를 선택하여 여러 번역을 제외합니다.
키를 제외하려면 다음 단계를 따르십시오:
키는 편집자 키 목록에서 키를 선택하고 메뉴를 사용하여 개별적으로 또는 일괄적으로 제외할 수도 있습니다.