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